gcp-gemini-manage コアアーキテクチャ設計:4プロジェクトの環境ルーティングとエージェント連携ループ

ビジネスとAIラボの規模が拡大するにつれて、Google Cloud Platform (GCP) 上の複雑なサーバーインスタンス、APIキー、データベースを管理することは困難な課題となります。gcp-gemini-manage プロジェクトはこの必要性から生まれました。これは単なる自動デプロイスクリプトの集まりではなく、「クラウドの基盤インフラ」と「上位のAIエージェント (Agent)」の間の橋渡しをするために設計された運用ハブ (Ops Hub) です。

この記事では、エンタープライズ向けの4つの独立プロジェクトアーキテクチャモードや、Agent Skillsを通じたゼロタッチの閉ループ管理をどのように実現しているかなど、本プロジェクトのコア設計理念を深く掘り下げます。

エンタープライズ向け 4つの独立プロジェクトアーキテクチャ

過去には、開発、テスト、本番のリソースが単一のGCPプロジェクト内に混在することがよくありました。これは請求や権限監査を複雑にするだけでなく、環境間の誤操作リスクを高めました。gcp-gemini-manage はマルチ環境の分離理念を全面的に採用し、ビジネス全体を4つの明確な役割を持つマイクロサービス独立プロジェクトに分割しました。

  1. AI Lab (evotensor-ai-lab) 大規模言語モデル (LLM) の推論、GPU接続サーバー、およびGemini APIキーの割り当て専用です。この環境はすべての高負荷AIコンピューティングタスクを処理し、システム全体の「ブレインファクトリー」として機能します。

  2. Data Core (evotensor-data-core) データは資産です。この環境は、Cloud SQL、永続ストレージボリューム、およびさまざまなコアデータインフラストラクチャの管理に特化しています。厳密なアクセス制御と分離により、ユーザーデータとシステム設定の絶対的な安全性が確保されます。

  3. Ops Build (evotensor-ops-build) 自動化されたビルドマシンとCI/CDパイプラインの拠点です。ここでのライフサイクル管理は、ビルド速度と並行処理能力に焦点を当てており、タスクが到着したときに自動スクリプトを介してビルドクラスターを動的に起動させます。

  4. Family Hub (evotensor-family-hub) 日常の補助サーバーとエッジコンピューティングノード(Hermes Agentなど)を提供します。長時間の接続安定性と軽量ルーティングを重視し、エンドユーザーやホームアプリケーション向けのゲートウェイサポートを提供します。

統合された環境ルーティング:config.sh の技術

ベーススクリプトが4つのプロジェクトを簡単にナビゲートできるようにするために、単一の .gcp_project_id への依存を排除しました。すべてのbash運用スクリプトは、scripts/config.sh を介してトラフィックのハイジャックとリダイレクトを実行します。

export GCP_PROJECT_AI_LAB="evotensor-ai-lab"
export GCP_PROJECT_DATA_CORE="evotensor-data-core"
# ...

全体的なGeminiの使用状況を確認したり、サーバーをバッチ起動したりする必要がある場合、基盤となるモニターは GCP_ALL_PROJECTS を反復処理し、クロスプロジェクトのリソーススニッフィングを実行して、完全なアセットトポロジマップを集約します。

エージェント連携ループ:AIに物理環境の認識を与える

従来の自動化インフラストラクチャは通常、人間中心です(DevOpsエンジニアがコンソールまたはCLIを介して操作を実行します)。しかし、gcp-gemini-manage の最大の利点は、それがAgentのために構築されたということです。

.agents/skills/ ディレクトリで標準化されたスキル (Skills) を宣言することにより、基盤となる gcloud コマンドラインをセマンティックにカプセル化しました。

  • ユーザーが「プライベートデータベースのセットアップを手伝って」とリクエストしたとき。
  • エージェントは自動的に deploy_aux_server.sh スクリプトを読み取り、必要なパラメーターをディスパッチします。
  • サーバーが起動すると、生成されたパブリックIPや接続資格情報などの重要な状態が、標準入力ストリーム (stdin) およびログのエコーを介して、エージェントのコンテキスト (Context) に直接同期されます。

これにより、エージェントは「コードを書く」だけでなく、「サーバーをプロビジョニングし」「クラウドの物理状態を理解する」能力を持ち、アプリケーション開発からインフラのデプロイまでの完全自動化された自己修復ループを完了します。