如要從範本自訂及部署應用程式,請建立應用程式。 舉例來說,您可能會建立應用程式,並打算部署以進行測試。您可能會建立另一個應用程式供正式版使用。
建立應用程式時,請指定有助於根據應用程式預期用途分類的資訊。這項資訊可協助您篩選及尋找特定應用程式。您也可以設定元件和連線詳細資料。
事前準備
請管理員在已啟用應用程式的資料夾或管理專案中,授予您下列其中一個角色:
- Application Design Center 管理員 (
roles/designcenter.admin)。 - 應用程式管理員 (
roles/designcenter.applicationAdmin)。 - 應用程式編輯者 (
roles/designcenter.applicationEditor)。
建立應用程式草稿
從範本建立應用程式草稿,方法是指定詳細資料,並視需要覆寫元件設定。接著即可部署草稿,建立應用程式。
設計畫布
在導覽選單中,執行下列任一操作:
按一下要使用的範本 ID。
點選設計畫布中的「設定應用程式」,然後點選「建立新應用程式」。
在「應用程式名稱」區域中,執行下列操作來命名及說明應用程式:
在「名稱」欄位中,輸入這個空間的專屬 ID。舉例來說,請使用不重複的名稱和環境組合,例如
web-app-staging。這是必填欄位。最多可使用 63 個字元,包括小寫英文字母、數字和連字號。名稱開頭必須為小寫英文字母,結尾不得為連字號。名稱無法變更。
在「顯示名稱」欄位中,輸入要在Google Cloud 控制台中顯示的名稱。
在「Description」(說明) 欄位中,輸入這個應用程式的用途。
如要為「專案 ID」欄位空白的元件設定預設專案,請從「部署專案」清單中選取專案。專案必須符合下列資格條件:
- 專案必須是所選已啟用應用程式管理功能的資料夾的子系。
- 專案不得為管理專案。
如果元件的「專案 ID」欄位已指定專案,系統會使用該專案,而非這項設定。
從「Region」(區域) 清單中,選取部署元件的區域。 系統會根據下列條件套用元件區域:
如果應用程式範圍是「全球」 (預設),則區域會套用至尚未設定區域的元件。
如果應用程式範圍為「區域」,則區域會套用至所有元件。
從「Environment」(環境) 清單中,選取要部署這個應用程式的環境。舉例來說,您可能想在
TEST中驗證部署作業是否正常運作。從「Criticality」(重要性) 清單中,選取對您業務的影響程度。例如:
LOW或HIGH。如要指定擁有者,請在「擁有者」區域中按一下「新增擁有者」,然後輸入下列項目的「顯示名稱」和「電子郵件」:
在「業主」區域中,輸入負責品質和使用者期望的擁有者。
在「開發人員擁有者」區域中,輸入負責開發及寫程式的擁有者。
在「營運商擁有者」區域中,輸入負責營運應用程式的擁有者。
在「範圍」清單中,選取下列其中一個選項:
全域 (預設):應用程式包含全域資源,或資源位於多個區域。
區域性:所有資源都位於單一區域。
這是必填欄位。詳情請參閱「比較全球和區域應用程式」。
點選「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 設定
如要查看各元件的設定說明文件連結,請參閱「支援的資源」。
在設計畫布上連結元件時,系統會使用預設設定值建立連結。如要新增或修改連線詳細資料,請按照下列步驟操作。
在設計畫布中,按一下兩個元件之間的連線。「連線」面板隨即開啟,並顯示連線參數。
執行下列其中一個步驟:
如要修改現有的連線參數,請按一下「編輯」。
如要新增連線參數,請按一下「新增參數」。
更新「鍵」和「值」欄位。舉例來說,您可能想修改下列詳細資料:
- 環境變數鍵名,以符合應用程式需求。
- 連線埠值。
- 新增至服務帳戶的角色。
按一下 [儲存]。
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引數和值。
如需部署步驟,請參閱「從控制台部署應用程式」。
編輯 Terraform 程式碼
應用程式會產生 Terraform 程式碼,反映設計和設定詳細資料。您可以編輯 Terraform,指定元件設定詳細資料。
系統會產生下列 Terraform 檔案:
main.tf:基礎架構程式碼,包含範本中每個元件的模組。outputs.tf:公開已部署基礎架構元件的相關資訊。variables.tf:宣告main.tf檔案中使用的變數名稱、類型和說明。input.tfvars:定義main.tf檔案中使用的變數值。providers.tf:定義有助於 Terraform 與 Google Cloud API 和資源互動的標籤。
如需背景資訊,請參閱「Terraform onGoogle Cloud總覽」。
如要編輯 Terraform 程式碼,請按照下列步驟操作:
點選設計畫布中的「程式碼」。系統會顯示產生的 Terraform 檔案。
按一下「main.tf」main.tf。系統會顯示每個元件的 Terraform 模組。
編輯設定詳細資料。詳情請參閱各支援資源的設定文件。
系統會自動驗證編輯內容,如果編輯內容無效,系統會顯示錯誤。
如要醒目顯示並比較編輯內容,請按照下列步驟操作:
按一下「查看差異」。
如要還原變更,請在邊界按一下「按一下即可還原變更」。
按一下「查看差異」即可關閉比較檢視畫面。
如要儲存編輯內容,請按一下「儲存程式碼變更」。
如要驗證變更,請按照下列步驟操作。
- 按一下「設計」。
- 按一下元件,查看設定詳細資料。
建立應用程式修訂版本
建立應用程式修訂版本,修改詳細資料或元件。如果您在 App Design Center 以外修改應用程式元件,重新部署時不會保留這些變更。
如要建立應用程式修訂版本,請按照下列步驟操作:
設計畫布
點選導覽選單中的「Applications」(應用程式)。
在表格中,按一下要修訂的「應用程式名稱」。
如要修改應用程式詳細資料,請按照下列步驟操作:
按一下「編輯」並修改詳細資料。
按一下 [儲存] 以儲存變更。
如要修改這個應用程式中的元件,請按照下列步驟操作:
點選設計畫布中的元件,然後在「Configuration」(設定) 區域編輯詳細資料。
按一下 [儲存] 以儲存變更。
gcloud CLI
請參閱「設定元件和連線」。
如需部署步驟,請參閱「從控制台部署應用程式」。
刪除應用程式
如果不再需要某個應用程式,可以刪除。舉例來說,您可能會在 TEST 環境中部署應用程式來驗證範本,然後刪除該應用程式。
你可以刪除下列應用程式:
- 尚未部署的應用程式。在「應用程式」頁面中,「狀態」會列為「草稿」。
- 已部署至
TEST、DEVELOPMENT或STAGING環境的應用程式。
刪除應用程式後,會發生下列情況:
- 將應用程式詳細資料從 Application Design Center 中移除。
- 刪除底層 App Hub 應用程式。
- 如果已部署,系統會刪除資源。
如要刪除應用程式:
設計畫布
點選導覽選單中的「Applications」(應用程式)。
在表格中,按一下「應用程式名稱」。
點選 「Actions」(動作) ,然後選取「Delete Application」(刪除應用程式)。
在「Delete」(刪除) 欄位中輸入應用程式名稱。
按一下「Delete」(刪除)。
gcloud CLI
刪除應用程式。
gcloud design-center spaces applications delete APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
更改下列內容:
APPLICATION:要刪除的應用程式 ID。PROJECT:管理專案 ID。LOCATION:應用程式區域。SPACE:您的空間 ID。
後續步驟
使用下列任一方法部署應用程式: