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

Gemini Cloud Assist と Application Design Center の Model Context Protocol（MCP）サーバーを使用すると、Antigravity CLI でGoogle Cloud インフラストラクチャを直接設計、デプロイ、トラブルシューティングできます。MCP サーバーを接続してエージェント スキルファイルをインストールすると、アプリケーション コードのインフラストラクチャを生成できます。また、自然言語プロンプトを使用して、セキュリティ標準へのコンプライアンスを評価し、デプロイの問題を解決することもできます。

目標

このチュートリアルでは、次の方法について説明します。

  • 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 CLI をインストールします。

  2. フェデレーション ID（連携 ID）を使用するように gcloud CLI を構成します。

    詳細については、 フェデレーション ID を使用して gcloud CLI にログインするをご覧ください。

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

    gcloud init

  4. 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 プロジェクト名に置き換えます。

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

  6. MCP を介して Gemini Cloud Assist にアクセスするには、Trusted Tester プログラムに参加している必要があります。アクセスをリクエストするには、アカウント担当者にお問い合わせください。
  7. Antigravity CLI をインストールする
  8. Antigravity CLI コマンドをデプロイして実行するには、次の表に示すように、プロジェクト境界内で必要なロールを付与するよう管理者に依頼してください。
    タスク 必要なロール
    プロジェクトで App Design Center を設定する Application 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 サービスと Application 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 Cloudインフラストラクチャの設計、評価、デプロイ、トラブルシューティングを行うことができます。MCP サーバーに接続するには、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.

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

  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

次のステップ