在 App Design Center 中,您可以根據範本建立應用程式草稿,並針對測試和正式環境等環境,自訂及部署個別應用程式執行個體。建立應用程式草稿時,您需要指定屬性,以便分類及篩選應用程式、設定元件和連線,以及視需要編輯產生的 Terraform 程式碼。您也可以在需求變更時建立新修訂版本,並在不再需要部署的資源時刪除應用程式。
事前準備
如要執行本文件中的工作,請要求管理員授予您啟用應用程式管理功能的資料夾或管理專案的必要角色,如下表所示:
| 工作 | 必要的角色 |
|---|---|
| 建立、設定、編輯應用程式草稿,以及建立草稿版本 | App Design Center 管理員 (roles/designcenter.admin),或應用程式管理員 ( roles/designcenter.applicationAdmin),或應用程式編輯者 ( roles/designcenter.applicationEditor) |
| 刪除應用程式 | App Design Center 管理員 (roles/designcenter.admin),或應用程式管理員 ( roles/designcenter.applicationAdmin) |
如要進一步瞭解角色,請參閱「使用 IAM 控管存取權」。
建立應用程式草稿
指定詳細資料,並視需要覆寫元件設定,即可從範本建立應用程式草稿。接著,您可以部署草稿來建立應用程式。
設計畫布
在導覽選單中,執行下列任一操作:
按一下要使用的範本 ID。
點選設計畫布中的「Configure an app」,然後點選「Create new application」。
在「Application name」(應用程式名稱) 區域中,執行下列操作來命名及描述應用程式:
在「Name」(名稱) 欄位中,輸入專屬 ID。例如,使用不重複的名稱和環境組合,例如
web-app-staging。這是必填欄位。最多可使用 63 個字元,包括小寫英文字母、數字和連字號。名稱開頭必須是小寫英文字母,結尾不得為連字號。名稱無法變更。
在「Display name」(顯示名稱) 欄位中,輸入要顯示在Google Cloud 控制台的名稱。
在「Description」(說明) 欄位中,輸入這個應用程式的用途。
如要為「Project ID」(專案 ID) 欄位空白的元件設定預設專案,請從「Deployment project」(部署專案) 清單中選取專案。在資料夾層級邊界中,專案必須符合下列條件:
- 專案必須位於所選啟用應用程式管理功能的資料夾中。
- 專案不得為管理專案。
如果元件的「Project ID」(專案 ID) 欄位中已指定專案,系統會使用該專案,而非這項設定。
從「Region」(區域) 清單中,選取元件部署的區域。元件區域的套用依據如下:
如果應用程式範圍為「Global」(全域) (預設),系統會將區域套用至尚未設定區域的元件。
如果應用程式範圍為「Regional」(區域),則區域會套用至所有元件。
從「Environment」(環境) 清單中,選取要部署這個應用程式的環境。舉例來說,您可能想確認部署項目在
TEST中是否正常運作。從「Criticality」(重要性) 清單中,選取對業務的影響程度。例如:
LOW或HIGH。如要指定擁有者,請在「Owners」(擁有者) 區域中,按一下「Add owner」(新增擁有者),然後輸入下列項目的「Display name」(顯示名稱) 和「email」(電子郵件):
在「Business owners」(業主) 區域中,輸入負責品質和使用者期望的擁有者。
在「Developer owners」(開發人員擁有者) 區域中,輸入負責開發和編碼的擁有者。
在「Operator owners」(操作員擁有者) 區域中,輸入負責操作應用程式的擁有者。
從「Scope」(範圍) 清單中選取下列其中一個選項:
全域 (預設):應用程式包含全域資源,或資源位於多個區域。
區域:所有資源都位於單一區域。
這是必填欄位。詳情請參閱「比較全域和區域性應用程式」。
按一下「Create Application」。系統會顯示應用程式詳細資料。
gcloud CLI
找出要用來建立應用程式的範本,並取得其應用程式範本修訂版本 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」。
複製
latestRevision輸出內容。根據範本建立應用程式草稿。
gcloud design-center spaces applications create APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION \ --scope-type=SCOPE_TYPE更改下列內容:
APPLICATION:要建立的應用程式 ID 草稿。PROJECT:您的管理專案 ID。LOCATION:應用程式區域。SPACE:您的聊天室 ID。SOURCE_APPLICATION_TEMPLATE_REVISION:應用程式範本 URI。例如:projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISIONSCOPE_TYPE:應用程式的範圍。regional或global。如果應用程式範圍為「global, the region is applied to components that don't already have a configured region. If the application scope isregional」,則區域會套用至所有元件。
設定元件和連線
您可以為應用程式中的每個元件指定設定詳細資料,例如建立資源的專案,以及部署資源的位置。
如果預設設定不符合需求,您也可以修改連線詳細資料。例如,您可以修改環境變數金鑰名稱、變更連線通訊埠,或為服務帳戶新增其他角色。
您必須為每個支援的資源設定必要詳細資料。
如要設定元件和連線,請按照下列步驟操作:
設計畫布
在設計畫布中點選元件。
在「Configuration」(設定) 區域,從「Project ID」(專案 ID) 清單中選取要部署資源的專案。選取符合下列條件的專案:
專案必須位於所選啟用應用程式管理功能的資料夾中。
專案不得為管理專案。
進行資源的其他設定。舉例來說,如果是 Cloud SQL,您可以設定下列項目:
- 區域
- 備份設定
- 資料庫旗標
- IP 設定
如需各元件的設定說明文件連結,請參閱「支援的資源」。
在設計畫布上連結元件時,系統會使用預設設定值建立連結。如要新增或修改連線詳細資料,請按照下列步驟操作。
在設計畫布中,按一下兩個元件之間的連線。「Connection」(連線) 面板隨即開啟,並顯示連線參數。
執行下列其中一個步驟:
如要修改現有的連線參數,請按一下「Edit」(編輯)。
如要新增連線參數,請按一下「Add parameter」(新增參數)。
更新「Key」和「Value」欄位。舉例來說,您可能需要修改下列詳細資料:
- 環境變數鍵名稱,須符合應用程式需求。
- 連線通訊埠值。
- 新增至服務帳戶的角色。
按一下 [儲存]。
gcloud CLI
說明如何查看元件參數,並找出應用程式所需的參數。
gcloud design-center spaces applications describe APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --format='yaml(name,componentParameters)'更改下列內容:
APPLICATION:應用程式 ID。PROJECT:您的管理專案 ID。LOCATION:應用程式區域。SPACE:您的聊天室 ID。
在主目錄中,為要修改的每個元件建立包含參數值的 JSON 檔案。
舉例來說,您可以為 Cloud Run 元件建立下列檔案:
{ "component": "projects/PROJECT/locations/us-central1/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/components/COMPONENT", "parameters": [ { "key": "service_name", "value": "frontend-service" }, { "key": "project_id", "value": "DEPLOYMENT_PROJECT" } ] }更新應用程式,設定必要參數。
gcloud design-center spaces applications update APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --component-parameters=COMPONENT_FILE_PATH_1更改下列內容:
APPLICATION:應用程式 ID。PROJECT:您的管理專案 ID。LOCATION:應用程式區域。SPACE:您的聊天室 ID。COMPONENT_FILE_PATH_1:包含元件參數的 JSON 檔案。每多一個 JSON 檔案,就多新增一個--component-parameter引數和值。
如需部署步驟,請參閱「部署應用程式」。
驗證安全性法規遵循
您可以對應用程式執行安全性評估,根據 Security Command Center 架構驗證設定。這項全方位評估會評估下列項目:
- 元件設定值:自動沿用範本的設定,或您為這個應用程式修改的設定。
- 應用程式參數:為應用程式提供的執行個體專屬詳細資料,例如部署區域或環境。
- 允許的元件:目前應用程式中,貴組織允許使用的服務和工作負載。
應用程式會沿用範本的 Security Command Center 框架。首先,管理員必須將安全性框架附加至應用程式範本。接著,請按照下列步驟評估應用程式的安全法規遵循情形:
gcloud CLI
gcloud alpha design-center spaces applications preview APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--generate-assessment-report=true
更改下列內容:
APPLICATION:要評估的應用程式 ID。PROJECT:管理專案 ID。LOCATION:應用程式區域。SPACE:您的聊天室 ID。
輸出內容會根據範本附加的架構,顯示應用程式的評估報告。
編輯 Terraform 程式碼
應用程式會產生 Terraform 程式碼,反映設計和設定詳細資料。您可以編輯 Terraform,指定元件設定詳細資料。
系統會產生下列 Terraform 檔案:
main.tf:基礎架構程式碼,包含範本中每個元件的模組。outputs.tf:公開已部署基礎架構元件的相關資訊。variables.tf:宣告main.tf檔案中使用的變數名稱、類型和說明。input.tfvars:定義main.tf檔案中使用的變數值。providers.tf:定義標籤,協助 Terraform 與 Google Cloud API 和資源互動。
如需背景資訊,請參閱「Google Cloud的 Terraform 總覽」。
如要編輯 Terraform 程式碼,請按照下列步驟操作:
在設計畫布中,按一下「Code」。系統會顯示產生的 Terraform 檔案。
按一下「main.tf」main.tf。系統會顯示每個元件的 Terraform 模組。
編輯設定詳細資料。詳情請參閱各項支援資源的設定說明文件。
系統會自動驗證編輯內容,並在編輯內容無效時顯示錯誤。
如要醒目顯示並比較編輯內容,請按照下列步驟操作:
按一下「查看差異」。
如要還原變更,請按一下邊界中的「按一下即可還原變更」。
按一下「查看差異」,關閉比較檢視畫面。
如要儲存編輯內容,請按一下「儲存程式碼變更」。
如要驗證變更,請按照下列步驟操作。
- 按一下「設計」。
- 按一下元件,查看設定詳細資料。
建立應用程式修訂版本
建立應用程式修訂版本,修改詳細資料或元件。如果您在 App Design Center 外部修改應用程式元件,重新部署時不會保留這些變更。
如要建立應用程式修訂版本,請按照下列步驟操作:
設計畫布
點選導覽選單中的「Applications」(應用程式)。
在表格中,按一下要修改的應用程式名稱。
如要修改應用程式詳細資料,請按照下列步驟操作:
按一下「編輯」,然後修改詳細資料。
按一下 [儲存] 以儲存變更。
如要修改這個應用程式中的元件,請按照下列步驟操作:
按一下設計畫布中的元件,然後在「Configuration」(設定) 區域中編輯詳細資料。
按一下 [儲存] 以儲存變更。
gcloud CLI
請參閱「設定元件和連線」。
如需部署步驟,請參閱「部署應用程式」。
刪除應用程式
如果不再需要某個應用程式,可以將其刪除。舉例來說,您可以部署應用程式,在 TEST 環境中驗證範本,然後刪除應用程式。
您可以刪除下列應用程式:
- 尚未部署的應用程式。在「Applications」(應用程式) 頁面上,「Status」(狀態) 會列為「Draft」(草稿)。
- 部署至
TEST、DEVELOPMENT或STAGING環境的應用程式。
刪除應用程式後,會發生以下情況:
- 將應用程式詳細資料從 Application Design Center 中移除。
- 刪除底層 App Hub 應用程式。
- 如果已部署,系統會刪除資源。
如要刪除應用程式,請按照下列步驟操作:
設計畫布
點選導覽選單中的「Applications」(應用程式)。
在表格中,按一下「應用程式名稱」。
點選 「Actions」(動作) ,然後選取「Delete Application」(刪除應用程式)。
在「Delete」(刪除) 欄位中輸入應用程式名稱。
點選「刪除」。
gcloud CLI
刪除應用程式。
gcloud design-center spaces applications delete APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
更改下列內容:
APPLICATION:要刪除的應用程式 ID。PROJECT:您的管理專案 ID。LOCATION:應用程式區域。SPACE:您的聊天室 ID。
後續步驟
- 透過控制台或指令列部署應用程式,佈建基礎架構。
- 下載並部署 Terraform,將 Terraform 設定匯出至本機電腦或存放區。