使用 Antigravity CLI 设计和部署应用

重要提示： 使用 MCP 将 Gemini Cloud Assist 与第三方 工具集成目前为非公开预览版。如要申请使用此功能，请与您的 Google Cloud 客户支持团队联系。

使用 Gemini Cloud Assist 的预览版产品受 Google Cloud 协议的约束，包括 Google Cloud 服务专用条款中的非正式版产品使用条款， 如 Gemini for Google Cloud 可信测试员计划条款的增补内容所述。

使用 Gemini Cloud Assist 和 App Design Center Model Context Protocol (MCP) 服务器，直接在 Antigravity CLI 中设计、部署和排查 Google Cloud 基础架构问题。

目标

本教程可帮助您执行以下操作：

• 设置 Antigravity CLI 以使用 Gemini Cloud Assist 和 App Design Center MCP 服务器。
• 设计和部署 Google Cloud 经过优化的基础架构，以运行 现有应用代码。
• 分析和排查技术问题。

费用

在本文档中，您将使用的以下收费组件： Google Cloud

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

您可使用 价格计算器 根据您的预计使用情况来估算费用。

新 Google Cloud 用户可能有资格申请免费试用。

完成本文档中描述的任务后，您可以通过删除所创建的资源来避免继续计费。如需了解详情，请参阅清理。

准备工作

登录您的 Google Cloud 账号。如果您是 Google Cloud的新用户， 请创建账号，以评估我们的产品在 实际场景中的表现。新客户还可获享 $300 赠金，用于 运行、测试和部署工作负载。

安装 Google Cloud CLI。

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

创建或选择 Google Cloud 项目。

选择或创建项目所需的角色

• 选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
• 创建项目：如需创建项目，您需要 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予 角色。

注意：如果您不打算保留在此过程中创建的 资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以 删除所创建的项目，并移除与该项目关联的所有资源。

• 创建 Google Cloud 项目：

  gcloud projects create PROJECT_ID

  将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。

• 选择您创建的 Google Cloud 项目：

  gcloud config set project PROJECT_ID

  将 PROJECT_ID 替换为您的 Google Cloud 项目名称。

验证是否已为您的 Google Cloud 项目启用结算功能。

安装 Google Cloud CLI。

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

创建或选择 Google Cloud 项目。

选择或创建项目所需的角色

• 选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
• 创建项目：如需创建项目，您需要 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予 角色。

注意：如果您不打算保留在此过程中创建的 资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以 删除所创建的项目，并移除与该项目关联的所有资源。

• 创建 Google Cloud 项目：

  gcloud projects create PROJECT_ID

  将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。

• 选择您创建的 Google Cloud 项目：

  gcloud config set project PROJECT_ID

  将 PROJECT_ID 替换为您的 Google Cloud 项目名称。

验证是否已为您的 Google Cloud 项目启用结算功能。

1. 如需通过 MCP 访问 Gemini Cloud Assist，您必须加入可信测试员计划。请与您的客户支持团队联系，申请访问权限。
2. 安装 Antigravity CLI
3. 如需部署和运行 Antigravity CLI 命令，请让您的管理员在您的项目边界内授予您必要的角色，如下表所示：

   任务	所需的角色
   在项目中设置 App Design Center	Application Design Center Admin (roles/designcenter.admin)
   通过 MCP 访问和调用 Gemini Cloud Assist	Gemini Cloud Assist Admin (roles/geminicloudassist.admin)，或 Gemini Cloud Assist Editor (roles/geminicloudassist.editor)，或 Gemini Cloud Assist User (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 Cloud 基础架构问题。如需连接到 MCP 服务器，请配置 Antigravity 设置。

如需将 Antigravity CLI 配置为使用 MCP 服务器，请执行以下操作：

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 服务器提供基础架构设计、部署和问题排查方面的说明和工作流。

如需将 SKILL.md 文件添加到 Antigravity CLI，请执行以下操作：

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/ 目录中，创建 SKILL.md 文件 使用 designing-and-deploying-infrastructure 中的内容。

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
   

您已成功将 Antigravity CLI 配置为连接到 App Design Center 和 Gemini Cloud Assist MCP 服务器，并创建了技能文件。

设计基础架构 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 账号产生费用，请删除包含这些资源的项目，或者保留项目但删除各个资源。

警告：删除项目会产生以下影响

• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算探索多个架构、教程或快速入门，则重复使用项目 可以帮助您避免超出项目配额限制。

删除 Google Cloud 项目：

gcloud projects delete PROJECT_ID

后续步骤

• 了解如何监控应用运行状况和性能。
• 探索有关 Google Cloud 的参考架构、图表和最佳实践。 查看我们的 Cloud 架构中心。