Provision: 마크다운 설정을 서버 실행 계획으로 변환하는 LLM 기반 서버 구축 도구

섹션별 상세

자연어 기반의 마크다운 설정을 LLM이 해석하여 정교한 서버 실행 계획을 수립합니다. 사용자가 시스템 업데이트, 패키지 설치, 사용자 생성 등을 마크다운 섹션과 불렛 포인트로 작성하면 LLM이 이를 순서가 지정된 JSON 체크리스트로 변환합니다. 이를 통해 복잡한 쉘 스크립트 작성 없이도 의도에 맞는 서버 환경을 구성할 수 있습니다.

다양한 Unix 계열 배포판을 지원하며 환경에 맞는 최적의 명령어를 생성합니다. Debian, Ubuntu, RHEL, CentOS, macOS 등에서 작동하며 각 배포판의 패키지 관리자와 시스템 구조에 맞는 비대화형 명령어를 자동으로 도출합니다. 실행 시 타임아웃 제어 기능을 포함하여 예기치 않은 프로세스 중단을 방지합니다.

작업 실패 시 스스로 문제를 진단하고 해결을 시도하는 자가 복구 메커니즘을 갖추고 있습니다. 각 작업 실행 후 검증 명령어를 실행하여 실패가 확인되면 LLM이 오류 원인을 분석하고 최대 3회까지 수정을 시도합니다. 반복적인 실패로 인한 무한 루프를 방지하기 위해 재시도 횟수를 제한하며 최종 성공 여부를 상세 보고서로 출력합니다.

보안과 투명성을 위해 단일 파이썬 스크립트 구조와 실행 전 계획 확인 기능을 제공합니다. 모든 로직이 하나의 파일(provision.py)에 담겨 있어 사용자가 실행 전 전체 코드를 쉽게 감사할 수 있으며, '--plan' 플래그를 통해 실제 시스템 변경 없이 실행될 명령어들을 미리 검토할 수 있습니다. 또한 비밀번호와 같은 민감 정보는 LLM 프롬프트에서 토큰화된 상태로 유지되다가 실행 시점에만 실제 값으로 대체됩니다.

기술

Python
Anthropic API
OpenAI API
Google Gemini API
Markdown

활용 사례

신규 VM/LXC 컨테이너 초기 환경 설정
자연어 기반의 서버 구성 문서화 및 실행
다양한 OS 배포판에 대한 공통 패키지 배포

언급된 리소스

GitHubProvision.sh