概要
- OpenCode Web UI と GitOps を活用した homelab管理 の効率化
- AIツール によるコンテナ管理やヘルスチェックの自動化
- Arcane へのサービス移行で Git管理 を強化
- CIフィードバック不足 が現状の課題
- マルチデバイス対応 で柔軟な運用を実現
Homelab管理の自動化とOpenCode導入
-
OpenCode Web UI を導入し、 Gitアクセス を通じてhomelab運用を効率化
-
OpenCode が変更をGitにプッシュ、 PRレビュー 後に GitOps で自動デプロイ
-
サーバー常駐型 でコーディングセッションが デバイス間で同期 される利便性
-
約12個のdocker composeスタック をArcaneに移行し、 GitOps管理 へ統一
-
AIツール の活用で、コンテナのバージョンアップやヘルスチェック追加を自動化
- 以前は各サービスのリリースノート確認やアップデート検証に数時間要したが、AIによる要約で数分に短縮
- AIでほとんどのコンテナに ヘルスチェック を追加し、障害検知を迅速化
OpenCode選定理由とセットアップ
- Claude Code を主に利用していたが、 トークン制限 の強化で他の選択肢を検討
- ベンダーロックイン回避 と主要プラグイン対応を重視し、 OpenCode を選択
- 内蔵Webサーバー/ Web UI 付きで、モバイルからも使いやすい
- Truenasホスト上のVM にOpenCodeをsystemdユニットとしてセットアップ
- ターミナル・ファイルブラウザ・git diff・worktree対応 など開発に必要な機能を完備
- Gitサーバー専用ユーザー/SSH鍵 でセキュリティ確保
- プロジェクトのcloneやブランチpushは許可、deployブランチへの直接pushは禁止
- PRレビュー必須 のワークフローで、AIによる未レビューコードのデプロイを防止
- VMのroot権限付与 も、インターネット・Gitサーバーのみアクセス可能なためリスク限定
AI Dev Platformとしての発展性
- エフェメラルコンテナ による開発環境自動提供や、 アクセス制御・監査ログ の実装余地
- シンプルな構成 で必要十分な機能を実現
日常ワークフローの流れ
- OpenCode で仕様・実装計画・セルフレビューを作成
- 可能なら テストや検証 を実施
- 気になる点は OpenCodeと反復的に改善
- 変更をfeatureブランチにpush し、 PR作成
- PRレビュー・マージ 後、 GitOps で自動デプロイ
- Arcane:dockerサービス変更
- GitOpsプラグイン:Home Assistant構成変更
- Cloudflare Pages worker:ブログ更新
Arcane移行による運用改善
- TruenasからArcane GitOpsプロジェクト へサービスを移行
- すべてのdocker composeスタックを git管理 に統一
- OpenCode と組み合わせることで、ネットワーク設定などの一括更新がスマホからでも容易
- 以前は各compose stackを手作業で追っていたが、 OpenCode で目標を指示し、PRを確認・マージするだけで完了
CIフィードバックの課題と今後
- GitHub Actions のログをAIで解析し、テスト失敗やIaC変更の診断が可能だった
- Forgejo Actions は API経由でジョブログ取得不可 のため、同様のフィードバックループが困難
- 非公開APIの利用は避けたい方針
マルチデバイスでの柔軟な運用
- AIが直接サービスへアクセスしない設計 で安全性確保
- PCで変更開始→スマホでPRレビュー→GitOpsで自動デプロイ のシームレスな運用
- どこからでもhome infraを管理可能 なワークフローを実現