Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

使用 Antigravity CLI 設計及部署應用程式

Gemini Cloud Assist 和 Application Design Center Model Context Protocol (MCP) 伺服器可讓您直接在 Antigravity CLI 中設計、部署Google Cloud 基礎架構，以及排解相關問題。連線至 MCP 伺服器並安裝代理技能檔案後，即可為應用程式程式碼生成基礎架構。您也可以使用自然語言提示，評估是否符合安全性標準，並解決部署問題。

目標

本教學課程可協助您執行下列操作：

設定 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.

您可以使用 Pricing Calculator，根據預測用量估算費用。

初次使用 Google Cloud 的使用者可能符合免費試用期資格。

完成本文所述工作後，您可以刪除建立的資源，避免繼續計費，詳情請參閱「清除所用資源」。

事前準備

登入 Google Cloud 帳戶。如果您未曾使用過 Google Cloud，歡迎建立帳戶，親自體驗實際使用我們產品的成效。新客戶還能獲得價值 $300 美元的免費抵免額，用於執行、測試及部署工作負載。

安裝 Google Cloud CLI。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

執行下列指令，初始化 gcloud CLI：

gcloud init

建立或選取 Google Cloud 專案。

選取或建立專案所需的角色

選取專案：選取專案時，不需具備特定 IAM 角色，只要您已獲派某個專案的角色，即可選取該專案。
建立專案：如要建立專案，您必須具備專案建立者角色 (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 角色，只要您已獲派某個專案的角色，即可選取該專案。
建立專案：如要建立專案，您必須具備專案建立者角色 (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 專案已啟用計費功能。

如要透過 MCP 使用 Gemini Cloud Assist，您必須加入「早鳥測試者計畫」。請與帳戶團隊聯絡，要求授予存取權。
安裝 Antigravity CLI

如要部署及執行 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 進行驗證：

設定應用程式預設憑證，讓 MCP 伺服器發出 API 呼叫。
```
 gcloud auth application-default login
```

啟用 API

在專案中啟用 Gemini Cloud Assist 和 Application Design Center 服務。

在專案中啟用 Gemini Cloud Assist 服務：

 gcloud services enable geminicloudassist.googleapis.com

在專案中啟用 App Design Center 服務：

 gcloud services enable designcenter.googleapis.com

設定 MCP 伺服器

Gemini Cloud Assist 和 App Design Center MCP 伺服器可協助您使用自然語言提示詞，設計、評估、部署 Google Cloud基礎架構，以及排解相關問題。如要連至 MCP 伺服器，請調整 Antigravity 設定。

如要設定 Antigravity CLI 使用 MCP 伺服器，請按照下列步驟操作：

在下列任一位置開啟 MCP 設定檔：
- 使用者範圍：如要將設定套用至所有 Antigravity CLI 專案，請開啟 ~/.gemini/config/mcp_config.json。
- 工作區範圍：如要為特定 Antigravity CLI 專案套用設定，請開啟 .agents/mcp_config.json。
如果沒有設定檔，請建立新檔案。

在 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"
      }
    }
  }

這項設定會自動使用應用程式預設憑證。

儲存並關閉設定檔。
啟動 Antigravity CLI。
```
agy
```
確認 MCP 伺服器已連線。
```
/mcp list
```

安裝 `SKILL.md` 個檔案

SKILL.md 檔案提供 App Design Center 和 Gemini Cloud Assist MCP 伺服器操作說明，以及基礎架構設計、部署和疑難排解的工作流程。

如要將 SKILL.md 檔案新增至 Antigravity CLI，請按照下列步驟操作：

在下列其中一個位置建立 skills/design-and-deploy 目錄：
- 使用者範圍：如要將設定套用至所有 Antigravity CLI 專案，請建立 ~/.gemini/config/skills/design-and-deploy/。
- 工作區範圍：如要為特定 Antigravity CLI 專案套用設定，請建立 .agents/skills/design-and-deploy/。
在 skills/design-and-deploy/ 目錄中，使用 designing-and-deploying-infrastructure 的內容建立 SKILL.md 檔案。
在下列其中一個位置建立 skills/google-gemini-cloud-assist 目錄：
- 使用者範圍：如要將設定套用至所有 Antigravity CLI 專案，請建立 ~/.gemini/config/skills/google-gemini-cloud-assist/。
- 工作區範圍：如要為特定 Antigravity CLI 專案套用設定，請建立 .agents/skills/google-gemini-cloud-assist/。
在 skills/google-gemini-cloud-assist/ 目錄中，使用 operating-google-cloud 的內容建立 SKILL.md 檔案。
結束並重新啟動 Antigravity CLI 工作階段。
```
/quit
```
使用 agy 再次啟動 Antigravity CLI 時，系統會自動偵測技能檔案。
確認系統是否自動偵測到技能檔案。
```
/skills list
```

您已成功設定 Antigravity CLI，連結至 App Design Center 和 Gemini Cloud Assist MCP 伺服器，並建立技能檔案。

設計 Google Cloud 基礎架構

設計基礎架構，專門用來儲存及執行應用程式程式碼。

設定要使用的專案：
```
gcloud config set project PROJECT_ID
```
要求提供 Google Cloud 基礎架構設計。
```
 My application code is in REPOSITORY_URL. Design the Google Cloud infrastructure required for my application.
```
代理會要求啟用您設定的技能。代理會建立基礎架構設計方案，並徵求您的核准。
核准企劃書。
```
Continue with the plan.
```
代理會找出建立基礎架構所需的工具，並要求使用 setup_adc 工具，在專案中設定 App Design Center。
允許 Gemini Cloud Assist 使用建議的工具。

代理會提出設計，並詢問您是否準備好部署。
反覆調整提議的設計。
```
The infrastructure looks good, but I want to add a cache for frequently accessed data.
```
代理會更新設計，整合您的需求。代理會詢問您是否需要變更說明，或是否要測試變更。

您已建立初始基礎架構設計，並反覆改良設計。

評估是否符合安全標準

貴組織的管理員可能已設定特定的安全性架構，用於指導基礎架構的設計和部署。在這個部分，請確認設計符合設定的安全標準。

確保基礎架構設計符合貴組織的安全標準。
```
I want to make sure that infrastructure design is compliant with my organization's security standards.
```
代理會根據貴組織管理員在 Security Command Center 指定的安全架構，分析基礎架構設計。如果稽核發現法規遵循問題，代理會建議強化安全防護，並徵求您的核准。
套用建議的安全強化措施
```
Apply the recommended security enhancements.
```
代理套用變更，並詢問您是否準備好核准設計。

基礎架構設計符合組織的安全架構。

部署基礎架構設計

將基礎架構設計部署至 Google Cloud。

核准設計並部署。
```
Deploy the infrastructure design to my Google Cloud project.
```
代理會將最終設計部署至 Google Cloud 專案。代理會要求您核准專案變更。例如，您可能需要啟用 API。

如果應用程式部署成功，代理會顯示部署作業詳細資料、架構元件，以及應用程式使用步驟。
如果部署失敗，請參閱疑難排解說明。例如，您可能需要修正元件設定詳細資料或 Identity and Access Management (IAM) 權限。
```
Fix the component configuration errors.
```
代理會提供元件設定建議，並建立差異檢視畫面供您查看及接受。
變更後，如要再次嘗試部署，請重複本節中的步驟。

您已將應用程式程式碼和基礎架構設計部署至Google Cloud。

清除所用資源

為避免因為本教學課程所用資源，導致系統向 Google Cloud 帳戶收取費用，請刪除含有相關資源的專案，或者保留專案但刪除個別資源。

刪除 Google Cloud 專案：

gcloud projects delete PROJECT_ID

後續步驟

瞭解如何監控應用程式健康狀態和效能。
查看 Google Cloud 的參考架構、圖表和最佳做法。歡迎瀏覽我們的 Cloud Architecture Center。