Antigravity CLI を使用してアプリケーションを設計、デプロイする

Gemini Cloud Assist と App Design Center の Model Context Protocol（MCP）サーバーを使用して、Antigravity CLI でGoogle Cloud インフラストラクチャを直接設計、デプロイ、トラブルシューティングします。

目標

このチュートリアルでは、次のことを行います。

  • Gemini Cloud Assist と App Design Center の MCP サーバーを使用するように Antigravity CLI を設定します。
  • 既存のアプリケーション コードを実行するように最適化された Google Cloud インフラストラクチャを設計してデプロイします。
  • 技術的な問題を分析してトラブルシューティングします。

費用

このドキュメントでは、課金対象である次の Google Cloudコンポーネントを使用します。

  • App Design Center.
  • Google Cloud resources that you create as part of your application infrastructure.

料金計算ツールを使うと、予想使用量に基づいて費用の見積もりを生成できます。

新規の Google Cloud ユーザーは無料トライアルをご利用いただける場合があります。

このドキュメントに記載されているタスクの完了後、作成したリソースを削除すると、それ以上の請求は発生しません。詳細については、クリーンアップをご覧ください。

始める前に

  1. Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分も差し上げます。

  2. Google Cloud CLI をインストールします。

  3. 外部 ID プロバイダ（IdP）を使用している場合は、まず フェデレーション ID を使用して gcloud CLI にログインする必要があります。

  4. gcloud CLI を初期化するには、次のコマンドを実行します。

    gcloud init

  5. Google Cloud プロジェクトを作成または選択します。

    プロジェクトの選択または作成に必要なロール

    • プロジェクトを選択する: プロジェクトの選択に特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトであれば、どのプロジェクトでも選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、resourcemanager.projects.create 権限を含むプロジェクト作成者ロール（roles/resourcemanager.projectCreator）が必要です。詳しくは、ロールを付与する方法をご覧ください。

    • Google Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、 Google Cloud プロジェクトの名前に置き換えます。

  6. Google Cloud プロジェクトで課金が有効になっていることを確認します。

  7. Google Cloud CLI をインストールします。

  8. 外部 ID プロバイダ（IdP）を使用している場合は、まず フェデレーション ID を使用して gcloud CLI にログインする必要があります。

  9. gcloud CLI を初期化するには、次のコマンドを実行します。

    gcloud init

  10. Google Cloud プロジェクトを作成または選択します。

    プロジェクトの選択または作成に必要なロール

    • プロジェクトを選択する: プロジェクトの選択に特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトであれば、どのプロジェクトでも選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、resourcemanager.projects.create 権限を含むプロジェクト作成者ロール（roles/resourcemanager.projectCreator）が必要です。詳しくは、ロールを付与する方法をご覧ください。

    • Google Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、 Google Cloud プロジェクトの名前に置き換えます。

  11. Google Cloud プロジェクトで課金が有効になっていることを確認します。

    12.
  12. MCP を介して Gemini Cloud Assist にアクセスするには、Trusted Tester プログラムに参加している必要があります。アクセス権をリクエストするには、アカウント チームにお問い合わせください。
  13. Antigravity CLI をインストールします。
  14. Antigravity CLI コマンドをデプロイして実行するには、次の表に示すように、プロジェクト境界内で必要なロールを付与するよう管理者に依頼してください。
    タスク 必要なロール
    プロジェクトで App Design Center を設定する App Design Center 管理者（roles/designcenter.admin）
    MCP を介して Gemini Cloud Assist にアクセスして呼び出す Gemini Cloud Assist 管理者（roles/geminicloudassist.admin）、
    Gemini Cloud Assist 編集者（roles/geminicloudassist.editor）、
    Gemini Cloud Assist ユーザー（roles/geminicloudassist.user）

環境を準備する

環境を準備するには、 Google Cloud に対して認証を行い、必要なサービスを有効にします。

Google Cloudに対して認証する

ターミナルで次のコマンドを実行して、 Google Cloud に対する認証を行います。

  1. MCP サーバーが API 呼び出しを行えるように、アプリケーションのデフォルト認証情報を設定します。

     gcloud auth application-default login

API を有効にする

プロジェクトで Gemini Cloud Assist サービスと App Design Center サービスを有効にします。

  1. プロジェクトで Gemini Cloud Assist サービスを有効にします。

     gcloud services enable geminicloudassist.googleapis.com

  2. プロジェクトで App Design Center サービスを有効にします。

     gcloud services enable designcenter.googleapis.com

MCP サーバーを構成する

Gemini Cloud Assist と App Design Center の MCP サーバーを使用すると、自然言語プロンプトを使用してインフラストラクチャの設計、評価、デプロイ、トラブルシューティングを行うことができます。 Google CloudMCP サーバーに接続するには、Antigravity の設定を構成します。

MCP サーバーを使用するように Antigravity CLI を構成する手順は次のとおりです。

  1. 次のいずれかの場所にある MCP 構成ファイルを開きます。

    • ユーザー スコープ: Antigravity CLI プロジェクト全体に設定を適用するには、~/.gemini/config/mcp_config.json を開きます。
    • ワークスペース スコープ: 特定の Antigravity CLI プロジェクトの設定を適用するには、.agents/mcp_config.json を開きます。

    構成ファイルが存在しない場合は、新しいファイルを作成します。

  2. mcp_config.json で、mcpServers キーの下に次の構成ブロックを追加または統合します。

      {
    "mcpServers": {
      "gemini-cloud-assist": {
        "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      },
      "application-design-center": {
        "serverUrl": "https://designcenter.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      }
    }
  }

    この構成では、アプリケーションのデフォルト認証情報が自動的に使用されます。

  3. 構成ファイルを保存して閉じます。

  4. Antigravity CLI を起動します。

    agy

  5. MCP サーバーが接続されていることを確認します。

    /mcp list

SKILL.md 個のファイルをインストール

SKILL.md ファイルは、インフラストラクチャの設計、デプロイ、トラブルシューティングに関する手順とワークフローを App Design Center と Gemini Cloud Assist の MCP サーバーに提供します。

Antigravity CLI に SKILL.md ファイルを追加する手順は次のとおりです。

  1. 次のいずれかの場所に skills/design-and-deploy ディレクトリを作成します。

    • ユーザー スコープ: Antigravity CLI プロジェクト全体に設定を適用するには、~/.gemini/config/skills/design-and-deploy/ を作成します。
    • ワークスペース スコープ: 特定の Antigravity CLI プロジェクトの設定を適用するには、.agents/skills/design-and-deploy/ を作成します。

  2. skills/design-and-deploy/ ディレクトリに、designing-and-deploying-infrastructureのコンテンツを使用して SKILL.md ファイルを作成します。

  3. 次のいずれかの場所に skills/google-gemini-cloud-assist ディレクトリを作成します。

    • ユーザー スコープ: Antigravity CLI プロジェクト全体に設定を適用するには、~/.gemini/config/skills/google-gemini-cloud-assist/ を作成します。
    • ワークスペース スコープ: 特定の Antigravity CLI プロジェクトの設定を適用するには、.agents/skills/google-gemini-cloud-assist/ を作成します。

  4. skills/google-gemini-cloud-assist/ ディレクトリに、operating-google-cloud の内容を使用して SKILL.md ファイルを作成します。

  5. Antigravity CLI セッションを終了して再起動します。

    /quit

    agy で Antigravity CLI を再度起動すると、スキルファイルが自動的に検出されます。

  6. スキルファイルが自動的に検出されたことを確認します。

    /skills list

App Design Center と Gemini Cloud Assist の MCP サーバーに接続するように Antigravity CLI を構成し、スキルファイルを作成しました。

インフラストラクチャを設計する Google Cloud

アプリケーション コードの保存と実行に合わせてインフラストラクチャを設計します。

  1. 使用するプロジェクトを設定します。

    gcloud config set project PROJECT_ID

  2. Google Cloud インフラストラクチャ設計を依頼します。

     My application code is in REPOSITORY_URL. Design the Google Cloud infrastructure required for my application.

    エージェントが、構成したスキルを有効にするよう求めます。エージェントがインフラストラクチャ設計プランを作成し、承認を求めます。

  3. プランを承認します。

    Continue with the plan.

    エージェントは、インフラストラクチャの作成に使用するツールを特定します。エージェントは setup_adc ツールを使用するように求めます。このツールは、プロジェクトに App Design Center を設定します。

  4. Gemini Cloud Assist に提案されたツールの使用を許可します。

    エージェントが設計を提案し、デプロイの準備ができているかどうかを尋ねます。

  5. 提案された設計を繰り返し検討します。

    The infrastructure looks good, but I want to add a cache for frequently accessed data.

    エージェントは、要件を統合するように設計を更新します。エージェントから、変更内容の説明を希望するか、変更内容をテストするかを尋ねられます。

最初のインフラストラクチャ設計を作成し、設計を改善するために反復処理を行いました。

セキュリティ標準のコンプライアンスを評価する

組織の管理者は、インフラストラクチャの設計とデプロイに影響する特定のセキュリティ フレームワークを構成している可能性があります。このセクションでは、設計が構成されたセキュリティ標準に準拠していることを確認します。

  1. インフラストラクチャ設計が組織のセキュリティ標準に準拠していることを確認します。

    I want to make sure that infrastructure design is compliant with my organization's security standards.

    エージェントは、組織の管理者が Security Command Center で指定したセキュリティ フレームワークに基づいて、インフラストラクチャ設計を分析します。監査でコンプライアンスの問題が見つかった場合、エージェントはセキュリティ強化を提案し、承認を求めます。

  2. 推奨されるセキュリティ強化を適用する

    Apply the recommended security enhancements.

    エージェントが変更を適用し、デザインの承認準備が整ったかどうかを確認します。

インフラストラクチャ設計が組織のセキュリティ フレームワークに準拠している。

インフラストラクチャ設計をデプロイする

インフラストラクチャ設計を Google Cloudにデプロイします。

  1. 設計を承認してデプロイします。

    Deploy the infrastructure design to my Google Cloud project.

    エージェントが最終的なデザインを Google Cloud プロジェクトにデプロイします。エージェントから、プロジェクトの変更を承認するよう求められます。たとえば、API を有効にする必要がある場合があります。

    アプリケーションが正常にデプロイされると、エージェントにデプロイの詳細、アーキテクチャ コンポーネント、アプリケーションの使用手順が表示されます。

  2. デプロイが失敗した場合は、トラブルシューティングのサポートをご利用ください。たとえば、コンポーネント構成の詳細や Identity and Access Management（IAM）権限の修正が必要になることがあります。

    Fix the component configuration errors.

    エージェントはコンポーネント構成の推奨事項を提供し、差分ビューを作成して、ユーザーが確認して承認できるようにします。

  3. 変更後にデプロイを再試行するには、このセクションの手順を繰り返します。

アプリケーション コードとインフラストラクチャ設計をGoogle Cloudにデプロイしました。

クリーンアップ

このチュートリアルで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、リソースを含むプロジェクトを削除するか、プロジェクトを維持して個々のリソースを削除します。

    Google Cloud プロジェクトを削除する:

    gcloud projects delete PROJECT_ID

次のステップ