ホームラボAI開発プラットフォーム：OpenCode + GitOpsによる安全なコンテナ更新

あるホームラボ運用者が、OpenCodeのウェブサーバーモードを基盤に、AIが生成したコードをPRレビューでゲートし、GitOpsでデプロイするAI開発プラットフォームを構築した。目標は、十数個のDocker Composeスタックの維持にかかる手作業を減らし、未レビューのコードが本番環境に流れるのを防ぐことだ。

セットアップ

プラットフォームはTrueNAS上のシンプルなVMで動作し、基本的な開発ツールが揃っている。OpenCodeはsystemdユニットとしてインストールされ、組み込みターミナル、ファイルブラウザ、Git差分、そして並行コーディングセッションのためのGit worktreeサポートを備えたWeb UIを公開する。サーバーはGitサーバー上に専用のSSH鍵を持つ独立したユーザーを持ち、プロジェクトのクローンやブランチのプッシュはできるが、デプロイブランチに直接プッシュはできない。

VMはインターネットアクセスとGitサーバー接続を持つが、実際のサービスへのネットワークアクセスはない。これにより被害範囲を最小限に抑え、OpenCodeがビルドツールやテスト依存関係をインストールする必要がある場合に、作者がルートアクセスを付与できる。

ワークフロー

1. OpenCodeで機能や改善を計画：仕様、実装計画、自己レビュー。
2. 可能な場合は変更をテストまたは検証。
3. 調整が必要な点についてOpenCodeと反復。
4. OpenCodeが変更をフィーチャーブランチにプッシュ。
5. オーナーがPRを開き、レビュー後にマージ。
6. GitOpsが引き継ぐ：Dockerサービスの変更にはArcane、Home Assistant設定にはGitOpsプラグイン、ブログ更新にはCloudflare Pages Workers。

具体的な成果

これまでで最も影響力のあるユースケースはコンテナ更新だ。以前は、作者は更新サイクルごとに各サービスのリリースノートを読み、破壊的変更を確認し、更新を実行し、手動でサービスを検証するのに何時間も費やしていた。今ではOpenCodeが数分でリリースノートの要約を生成し、バージョンアップグレードをより速く、より安全にしている。また、AIはほとんどのコンテナにヘルスチェックを追加し、問題発見を迅速化した。

不足しているもの：CIフィードバック

このセットアップにはCI統合がない。GitHubでは、作者はコーディングエージェントをActionsログに向けて、失敗したテスト、リンターエラー、スタックトレース、IaC計画の変更を診断するだろう。セルフホストのGitサーバーであるForgejoは、パブリックAPIを通じてジョブログを公開していない（文書化されていないAPIは存在するが）。作者はこれが主要なギャップだと考えている。

結論

これは現実的でセキュリティ意識の高いホームラボAIプラットフォームだ。オーナーはどのデバイス（電話を含む）からでもインフラ変更を行え、AIに本番サービスへの直接アクセスを与える必要がない。PRレビューの手間とサンドボックス化されたVMにより、個人利用には十分安全でありながら、セルフホストGitサーバー向けのCIフィードバックのギャップが浮き彫りになっている。