My Homelab AI Dev Platform

개요

이 기술 콘텐츠는 개인 홈랩 환경에서 AI 기반 개발 플랫폼을 구축하는 방법을 설명하며, OpenCode Web UI와 GitOps 워크플로우를 활용하여 서비스 관리를 자동화하고 효율성을 높이는 데 중점을 둡니다.

주요 내용

* AI 기반 서비스 유지보수 자동화: 각 서비스의 릴리스 노트를 요약하고, 변경 사항을 확인하며, 컨테이너 업데이트를 수행하는 데 AI를 활용하여 몇 시간이 걸리던 작업을 몇 분으로 단축하고 안전성을 높였습니다.
* OpenCode Web UI 도입: 클라우드 기반 AI 제공업체의 제한적인 토큰 정책에 대한 대안으로, 벤더에 독립적이며 주요 플러그인을 지원하는 OpenCode를 선택했습니다. OpenCode는 내장된 웹 서버와 UI를 통해 지속적인 코딩 세션을 지원하며, 모바일 웹 UI의 질문/답변 기능이 뛰어납니다.
* GitOps 기반 배포 워크플로우: OpenCode는 코드 변경 사항을 생성하고 Git 서버의 특정 브랜치로 푸시하며, 사용자는 Pull Request (PR)를 통해 이를 검토하고 승인합니다. 승인된 PR은 Arcane (Docker 서비스), GitOps 플러그인 (Home Assistant), Cloudflare Pages worker (블로그) 등을 통해 자동으로 배포됩니다.
* 보안 강화: OpenCode는 인터넷 접속과 Git 서버 접근 권한만 가지며, 실제 서비스에는 직접 접근할 수 없습니다. 또한, OpenCode가 생성한 코드는 PR 검토 단계를 거치므로 프로덕션 환경으로 배포되기 전에 안전하게 관리됩니다.
* 홈랩 환경 관리 효율성 증대: Truenas에서 Arcane GitOps 프로젝트로 서비스를 마이그레이션하여 모든 Docker Compose 스택을 Git 기반으로 관리합니다. 이를 통해 여러 기기에서 홈랩 인프라 변경 사항을 쉽게 관리하고, 네트워크 연결성 등을 Phone에서 직접 업데이트할 수 있게 되었습니다.
* CI 피드백의 중요성 및 현재 제약: GitHub Actions와 같은 CI 피드백 연동이 현재 Forgejo 환경에서는 제약적입니다. Forgejo Actions의 잡 로그가 공개 API를 통해 노출되지 않아, 코드 변경 후 실패한 테스트나 린터 오류 등을 진단하는 데 어려움이 있습니다.

시사점

개인 홈랩 환경에서 AI와 GitOps를 통합하는 것은 서비스 유지보수의 효율성을 크게 향상시키고, 여러 기기에서 인프라 변경 사항을 안전하고 신속하게 관리할 수 있는 유연성을 제공합니다.