발표에서 확인된 핵심 사실

서버 설정을 위해 Docker Compose(컨테이너 오케스트레이션 도구) 파일을 일일이 수정하거나 Git 기반의 설정 관리를 수동으로 수행하는 방식과 AI가 변경 사항을 제안하고 승인만으로 배포를 완료하는 방식은 운영 효율에서 큰 차이를 보인다. OpenCode(AI 기반 코드 편집기)와 GitOps(Git 저장소를 단일 진실 공급원으로 사용하는 배포 방식)를 결합해 홈랩 관리를 위한 AI 개발 플랫폼을 구축했다. AI가 인프라 변경 사항을 제안하고 인간이 이를 검토하여 최종 승인하는 자동화 체계다.

OpenCode가 Git 저장소에 변경 사항을 푸시하면 사용자가 PR(Pull Request, 코드 변경 요청)을 통해 내용을 검토하고 승인하며, 이후 GitOps가 이를 실제 환경에 배포하는 워크플로우를 구현했다. OpenCode는 서버 형태로 실행되어 여러 기기 간에 코딩 세션이 동기화되는 환경을 제공한다. 사용자는 서로 다른 기기에서 접속하더라도 지속되는 세션을 통해 AI가 제안한 코드를 확인하고 홈랩 인프라를 관리한다.

GitHub Actions(CI/CD 자동화 도구)는 공개 API를 통해 작업 로그를 제공하여 AI 에이전트의 접근이 용이하지만, Forgejo Actions(오픈소스 CI/CD 도구)는 이를 지원하지 않는다. 이로 인해 AI 에이전트가 테스트 실패, 린터 오류, 스택 트레이스 등의 로그를 직접 수집하고 진단하여 빠르게 피드백을 주는 루프를 구축하는 데 어려움이 있다. Forgejo Actions의 API 제한이 AI 에이전트의 자율적인 오류 진단과 수정 능력을 제한하는 기술적 제약으로 작용한다.

벤더 중립성과 웹 UI 기능을 고려하여 Claude Code

특정 AI 제공업체의 토큰 정책에 계속 의존하는 것이 과연 지속 가능할까. AI 제공업체들이 토큰 제한을 통해 실질적인 고객 가치를 낮추는 추세가 이어지며 벤더 중립적인 대안의 필요성이 커졌다. 이에 따라 Claude Code 대신 OpenCode(AI 기반 코딩 보조 도구)를 도입했다. 해당 솔루션은 특정 벤더에 구애받지 않고 주요 플러그인을 지원하며, 특히 내장된 웹 서버와 웹 UI 기능이 관리 편의성을 높이는 핵심 요소로 작용했다. 벤더 종속성을 제거해 운영 유연성을 확보하고 인터페이스 접근성을 개선한 사례다.

인프라 관리 체계는 Truenas(NAS용 오픈소스 스토리지 OS)에서 Arcane GitOps 프로젝트로 전환했다. 이는 모든 Docker Compose(다중 컨테이너 정의 및 실행 도구) 스택에 Git 기반 스토리지를 확보하여 설정의 변경 이력을 명확히 관리하기 위한 조치다. 이 구조를 통해 모바일 기기에서도 OpenCode를 이용해 전체 컨테이너의 네트워크 설정을 즉시 업데이트하는 원격 관리 환경을 구축했다. 해당 체계를 도입해 서비스 규모가 확장되며 늘어난 컨테이너 관리의 복잡도를 제어했다.

를 활용해 컨테이너 업데이트 및 헬스체크 관리 시간을 대폭

수 시간 동안 릴리스 노트를 하나하나 대조하며 업데이트 항목을 가려내던 작업은 인프라 관리자의 일상적인 소모전이다. AI 요약을 도입하자 이 과정이 몇 분 단위로 압축됐다. 서비스별 릴리스 노트의 핵심 내용을 빠르게 파악함으로써 버전 업그레이드에 소요되는 물리적 시간을 줄이고 작업의 안전성을 높였다. 여기에 AI를 이용해 대부분의 컨테이너에 헬스체크(서비스 상태 자동 점검 기능)를 추가했다. 서비스 이상 징후를 포착하는 속도가 빨라지며 관리 효율이 개선됐다. 단순 반복적인 확인 작업을 AI가 대체하며 인프라 유지보수의 리드 타임을 대폭 단축했다.

Docker Compose를 이용한 서버 관리나 Git 기반의 설정 관리(IaC, 코드형 인프라) 경험은 OpenCode를 통한 자동화 체계로 이어진다. AI가 인프라 변경 사항을 제안하면 관리자가 PR(Pull Request, 코드 변경 요청)을 승인해 배포하는 GitOps(Git 저장소를 통해 인프라를 관리하는 방식) 체계를 구축했다. 이를 위해 OpenCode Web UI를 시스템 유닛(systemd, 리눅스 서비스 관리자)으로 설정해 VM(가상 머신)에 올리고 Git 서버와 SSH 키(원격 접속 인증 키)로 연동한 격리 구조를 택했다.

보안 확보를 위해 OpenCode(AI 기반 인프라 관리 도구)는 전용 Git 사용자 계정을 사용한다. AI는 프로젝트를 클론하거나 브랜치를 푸시할 수 있으나, 배포 브랜치에 직접 푸시하는 권한은 엄격히 제한된다. VM 자체의 네트워크 역시 인터넷과 Git 서버 접근만 허용하고 실제 서비스망으로는 접근할 수 없도록 설정했다. AI에게 루트 권한을 부여하되 실제 서비스망과의 접점을 차단해 잠재적 피해 범위를 최소화한 실무적 아키텍처 기준을 적용했다.

Docker Compose 파일 수정과 Git 기반 설정 관리를 수동으로 수행하던 방식은 AI의 제안과 PR 승인 기반의 GitOps 체계로 대체된다. OpenCode Web UI를 systemd 유닛으로 VM에 구성하고 SSH 키로 연동한 격리 구조가 이를 뒷받침한다.

AI에게 루트 권한을 부여하되 서비스망과는 분리해 보안 리스크를 통제하는 것이 실무적 아키텍처의 기준이다. 격리된 환경에서의 권한 부여라는 기준을 적용해 인프라 자동화의 실효성을 결정해야 한다.