部署應用程式

從範本建立應用程式草稿後，即可部署應用程式。使用 App Design Center 部署應用程式時，系統會自動在 App Hub 註冊應用程式。部署程序可讓您執行下列操作：

  • 預覽 Terraform 預計對基礎架構進行的變更。
  • 啟用應用程式所需的 Google Cloud 資源 API。
  • 調查部署問題。
  • 使用遙測資料分析資源效能。
  • 找出並將範本修訂版本套用至應用程式。

本文說明如何部署、管理範本修訂版本，以及將範本修訂版本套用至應用程式。

事前準備

您必須在啟用應用程式的資料夾或管理專案中，具備下列其中一個角色：

  • 應用程式管理員 (roles/designcenter.applicationAdmin)
  • 應用程式營運者 (roles/designcenter.applicationOperator)

如要使用服務帳戶部署應用程式，您必須具備下列其中一項條件：

  • 您設定的服務帳戶，用於部署應用程式和基礎資源。詳情請參閱「將角色授予服務帳戶」。
  • 應用程式啟用資料夾的專案 IAM 管理員 (roles/resourcemanager.projectIamAdmin) 角色。這個角色可讓您在部署期間建立新的服務帳戶。

部署應用程式

選取服務帳戶選項，然後部署應用程式。部署應用程式時，系統會建立 Google Cloud 資源，您也開始支付與這些資源相關的費用。

設計畫布

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

    前往「Applications」(應用程式)

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

  3. 在「應用程式詳細資料」頁面中，查看詳細資料並點選「編輯」進行變更。

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

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

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

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

  6. 按一下 [繼續]。

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

    1. 按一下「預覽」。

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

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

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

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

  10. 如果部署作業發生問題，請採取下列行動：

    1. 在「應用程式詳細資料」面板中，按一下「部署」。

    2. 查看錯誤訊息。

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

  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。

查看應用程式詳細資料

應用程式部署作業完成後，即可檢查相關資訊。舉例來說，您可能會看到以下內容：

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

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

設計畫布

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

    前往「Applications」(應用程式)

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

    • 在 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. 按一下導覽選單中的「範本」。

    前往「範本」頁面

  2. 找出要套用修訂版本的範本 ID，然後按一下。

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

  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 旗標。如需部署步驟，請參閱「部署應用程式」。