adk-infra-expert

Adk Infra Expert

概要

Terraform を使用して、本番環境向けの Vertex AI ADK インフラストラクチャをプロビジョニングします。セキュアなネットワーク、最小権限の IAM、Agent Engine ランタイム、Code Execution サンドボックスのデフォルト設定、Memory Bank の設定が含まれます。このスキルを使用すると、VPC Service Controls が必要な場合を含む、エンタープライズのセキュリティ要件に適合した Terraform モジュールとデプロイチェックリストを生成・検証できます。

前提条件

このスキルを使用する前に、以下を確認してください。

• 課金が有効になっている Google Cloud プロジェクト
• Terraform 1.0 以降がインストールされていること
• 適切な権限を持つ gcloud CLI の認証が完了していること
• 対象プロジェクトで Vertex AI API が有効になっていること
• VPC Service Controls アクセスポリシーが作成されていること（エンタープライズ向け）
• Agent Engine のアーキテクチャと要件を理解していること

手順

1. Terraform を初期化する：リモート状態の保存用バックエンドを設定します
2. 変数を設定する：project_id、region、エージェント設定を定義します
3. VPC をプロビジョニングする：Private Service Connect を使用してネットワークインフラストラクチャを作成します
4. IAM を設定する：最小権限のロールを持つサービスアカウントを作成します
5. Agent Engine をデプロイする：コード実行とメモリバンクを含むランタイムを設定します
6. VPC-SC を有効にする：データ流出を防ぐためにサービス境界を適用します
7. モニタリングを設定する：Cloud Monitoring のダッシュボードとアラートを設定します
8. デプロイを検証する：エージェントのエンドポイントをテストし、すべてのコンポーネントを確認します

出力

• プロジェクトに適用された設定ファイルまたはコードの変更
• 正しく実装されていることを確認する検証レポート
• 実施した変更とその理由の概要

出力形式の仕様については、Terraform の実装詳細を参照してください。

エラー処理

包括的なエラー処理については、${CLAUDE_SKILL_DIR}/references/errors.mdを参照してください。

例

詳細な例については、${CLAUDE_SKILL_DIR}/references/examples.mdを参照してください。

リソース

• Agent Engine：https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview
• VPC-SC：https://cloud.google.com/vpc-service-controls/docs
• Terraform Google Provider：https://registry.terraform.io/providers/hashicorp/google/latest
• ${CLAUDE_SKILL_DIR}/examples/内の ADK Terraform の例