部署應用程式

在 App Design Center 部署應用程式草稿，即可佈建 Google Cloud 資源，並在 App Hub 自動註冊應用程式。部署前，您可以預覽預計的 Terraform 變更、根據組織政策評估設計，以及啟用必要的Google Cloud API。部署完成後，您可以調查部署問題、使用遙測資料分析資源效能，以及將新的範本修訂版本套用至應用程式。

事前準備

如要執行本文件中的工作，請要求管理員授予您啟用應用程式管理功能的資料夾或管理專案的必要角色，如下表所示：

工作 必要的角色
部署應用程式並套用範本修訂版本 應用程式管理員 (roles/designcenter.applicationAdmin) 或
應用程式操作員 (roles/designcenter.applicationOperator)
在部署期間自動建立服務帳戶 專案 IAM 管理員 (roles/resourcemanager.projectIamAdmin)

如要使用現有服務帳戶部署應用程式，請參閱「將角色授予服務帳戶」。

如要進一步瞭解角色，請參閱「使用 IAM 控管存取權」。

部署應用程式

選取服務帳戶選項並部署應用程式。部署應用程式時，系統會建立 Google Cloud 資源，並開始收取這些資源的相關費用。

設計畫布

  1. 點選導覽選單中的「Applications」(應用程式)。

    前往「Applications」(應用程式)

  2. 在表格中，按一下「應用程式名稱」。

  3. 在「Application details」(應用程式詳細資料) 頁面中，查看詳細資料，然後按一下「Edit」(編輯) 進行變更。

  4. 點選「Deploy」(部署)。

  5. 選取下列其中一個服務帳戶來部署應用程式：

    • 「Select a service account」(選取服務帳戶)：在「Service account」(服務帳戶) 欄位中，輸入現有服務帳戶的名稱。如要設定服務帳戶，請參閱「將角色授予服務帳戶」。

    • 建立新的服務帳戶：您必須具備專案 IAM 管理員 (roles/resourcemanager.projectIamAdmin) 角色，才能將必要的部署角色指派給服務帳戶。

  6. 按一下 [繼續]。

  7. 如要預覽 Terraform 預計對基礎架構做出的變更，請按照下列步驟操作：

    1. 按一下「預覽」。

    2. 查看變更，然後按一下「複製並關閉」。預覽畫面會複製到剪貼簿。

    3. 如要儲存預覽畫面，請貼到所需文件並儲存。

  8. 在「Review APIs」(查看 API) 區域中，查看應用程式所需的 API 清單。部署時，系統會自動啟用 API。

  9. 點按「Deploy」。部署作業完成後，系統會顯示應用程式詳細資料和部署狀態。

  10. 如果部署作業發生問題，請按照下列步驟操作：

    1. 在「Application details」(應用程式詳細資料) 面板中，按一下「Deployments」(部署作業)。

    2. 查看錯誤訊息。

    3. 按一下「查看記錄」，即可查看詳細建構資訊。

    4. 如要查看修正部署錯誤的建議，請按一下「Troubleshoot Deployment」(排解部署作業問題) (預先發布版)。

      詳情請參閱「排解及修正部署問題」。

  11. 如要管理已部署的應用程式，請參閱「查看應用程式詳細資料」。

gcloud CLI

  1. 部署前，請先預覽應用程式，查看 Terraform 程式碼。這項作業可能需要幾分鐘才能完成。執行下列其中一個步驟：

    • 如要自動建立服務帳戶，請使用下列指令：

      gcloud design-center spaces applications preview APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--create-sa \
--service-account=SERVICE_ACCOUNT

    • 如要使用自己的服務帳戶，請執行下列指令：

      gcloud design-center spaces applications preview APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--service-account=SERVICE_ACCOUNT

    更改下列內容：

    • APPLICATION：應用程式 ID。
    • PROJECT：您的管理專案 ID。
    • LOCATION：應用程式區域。
    • SPACE：您的聊天室 ID。
    • SERVICE_ACCOUNT：執行下列其中一項操作：
      • 如要建立新的服務帳戶，請提供服務帳戶名稱。
      • 如要使用自己的服務帳戶，請提供完整資源名稱，格式為 projects/PROJECT/serviceAccounts/EMAIL_ADDRESS。

    詳情請參閱「gcloud design-center spaces applications preview」。

  2. 以非同步方式部署應用程式，並複製完整作業名稱。執行下列任一操作：

    • 如要自動建立服務帳戶，請使用下列指令：

       gcloud design-center spaces applications deploy APPLICATION \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --create-sa \
 --service-account=SERVICE_ACCOUNT \
 --async

    • 如要使用自己的服務帳戶，請執行下列指令：

       gcloud design-center spaces applications deploy APPLICATION \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --service-account=SERVICE_ACCOUNT \
 --async

    更改下列內容：

    • APPLICATION：應用程式 ID。
    • PROJECT：您的管理專案 ID。
    • LOCATION：應用程式區域。
    • SPACE：您的聊天室 ID。
    • SERVICE_ACCOUNT：執行下列其中一項操作：
      • 如要建立新的服務帳戶，請提供服務帳戶名稱。
      • 如要使用自己的服務帳戶，請提供完整資源名稱，格式為 projects/PROJECT/serviceAccounts/EMAIL_ADDRESS。

    詳情請參閱「gcloud design-center spaces applications deploy」。

  3. 部署作業需要幾分鐘才能完成。追蹤部署狀態。

    gcloud design-center operations describe OPERATION\
--project=PROJECT \
--location=LOCATION

    更改下列內容：

    • OPERATION：從 deploy 指令輸出複製的完整作業名稱，格式為 projects/PROJECT/locations/LOCATION/operations/operation-<var>OPERATION_ID</var>。
    • PROJECT：您的管理專案 ID。
    • LOCATION：應用程式區域。

    詳情請參閱「gcloud design-center operations describe」。

排解及修正部署問題

如果應用程式部署失敗，您可以查看錯誤摘要、取得詳細分析、找出解決步驟，以及自動修正部分問題。

如要排解及修正錯誤，請執行下列操作：

  1. 在「Application details」(應用程式詳細資料) 面板中，按一下「Deployments」(部署作業)。

  2. 如要分析錯誤並取得修正建議，請按一下「排解部署作業問題」。

    「Troubleshooting details」(疑難排解詳細資料) 面板會顯示說明文件建議、設定變更和其他資訊，協助您解決部署錯誤。

  3. 查看部署錯誤和建議：

    1. 如果分析結果建議變更元件設定，請查看建議的變更，然後按一下「Update Application」(更新應用程式) 套用變更。

    2. 如果分析結果包含其他建議，系統會顯示 gcloud CLI 指令，您可以執行這些指令來解決錯誤。如要在 Cloud Shell 中執行 gcloud CLI 指令，請按一下「Run command」(執行指令)。

查看申請詳情

應用程式部署完成後，您可以查看相關資訊。例如，您可能會看到以下內容：

  • 上次更新時間、修訂日期和區域等詳細資料。
  • 輸出內容，例如服務 URI。
  • 部署狀態、錯誤資訊和記錄連結。

如要查看應用程式詳細資料，請按照下列步驟操作：

設計畫布

  1. 點選導覽選單中的「Applications」(應用程式)。

    前往「Applications」(應用程式)

  2. 在表格中，按一下「應用程式名稱」。「Application details」(應用程式詳細資料) 面板會顯示下列資訊：

    • 在 App Hub 查看應用程式：在 App Hub 中調查應用程式。您可以查看已部署的資源，並檢查遙測資料，診斷問題及分析效能。詳情請參閱「監控 App Hub 應用程式」。

    • 應用程式詳細資料：查看上次更新日期、來源範本、區域和服務帳戶等資訊。

    • 輸出：找出服務 URI，以便與應用程式前端或後端互動。

    • 部署作業：查看部署狀態、部署錯誤，以及記錄連結，以便排解錯誤。

gcloud CLI 

gcloud design-center spaces applications describe APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

更改下列內容：

  • APPLICATION：應用程式 ID。
  • PROJECT：您的管理專案 ID。
  • LOCATION：應用程式區域。
  • SPACE：您的聊天室 ID。

詳情請參閱「gcloud design-center spaces applications describe」。

修改已部署的應用程式

如要修改已部署的應用程式，請執行下列任一操作，確保重新部署應用程式時會保留變更：

套用範本修訂版本

如果您先前使用應用程式設計中心部署應用程式，且管理員與您共用範本修訂版本，則可將範本變更套用至應用程式。更新應用程式時，系統會建立應用程式修訂版本。您可以設定修改過的元件，或新增至修訂範本的元件。

您可以使用 Cloud Hub 查看應用程式可用的範本修訂版本。詳情請參閱「查看部署作業」。

如要將範本修訂版本套用至應用程式，請按照下列步驟操作：

設計畫布

  1. 點選導覽選單中的「Templates」(範本)。

    前往「範本」頁面

  2. 按一下包含要套用修訂版本的範本 ID。

  3. 從「Configure an app」(設定應用程式) 清單中，選取要更新的應用程式。

  4. 編輯應用程式詳細資料，然後按一下「儲存」。

  5. 在設計畫布中點選各個元件，並修改元件設定。

  6. 點按「Deploy」。如需部署步驟，請參閱「部署應用程式」。

gcloud CLI

  1. 找出最新修訂版本的應用程式範本修訂版本 URI。

     gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --format='yaml(name,latestRevision)'

    更改下列內容：

    • APPLICATION_TEMPLATE：應用程式範本 ID，這是應用程式的基礎。
    • PROJECT：您的管理專案 ID。
    • LOCATION：應用程式範本區域。
    • SPACE：您的聊天室 ID。

    詳情請參閱「gcloud design-center spaces application-templates describe」。

  2. 複製 latestRevision 輸出內容。

  3. 更新應用程式，改用應用程式範本修訂版本。

     gcloud design-center spaces applications update APPLICATION \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION

    更改下列內容：

    • APPLICATION：應用程式 ID。
    • PROJECT：您的管理專案 ID。
    • LOCATION：應用程式區域。
    • SPACE：您的聊天室 ID。
    • SOURCE_APPLICATION_TEMPLATE_REVISION：應用程式範本 URI。例如：projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION

    詳情請參閱「gcloud design-center spaces applications update」。

  4. 如要在應用程式中設定新元件或更新後的元件，請參閱「設定元件和連線」。

  5. 部署應用程式時，請使用 --replace 旗標。如需部署步驟，請參閱「部署應用程式」。

後續步驟