管理應用程式

如要從範本自訂及部署應用程式,請建立應用程式。 舉例來說,您可能會建立應用程式,並打算部署以進行測試。您可能會建立另一個應用程式供正式版使用。

建立應用程式時,請指定有助於根據應用程式預期用途分類的資訊。這項資訊可協助您篩選及尋找特定應用程式。您也可以設定元件和連線詳細資料。

事前準備

請管理員在已啟用應用程式的資料夾或管理專案中,授予您下列其中一個角色

  • Application Design Center 管理員 (roles/designcenter.admin)。
  • 應用程式管理員 (roles/designcenter.applicationAdmin)。
  • 應用程式編輯者 (roles/designcenter.applicationEditor)。

建立應用程式草稿

從範本建立應用程式草稿,方法是指定詳細資料,並視需要覆寫元件設定。接著即可部署草稿,建立應用程式。

設計畫布

  1. 在導覽選單中,執行下列任一操作:

  2. 按一下要使用的範本 ID

  3. 點選設計畫布中的「設定應用程式」,然後點選「建立新應用程式」

  4. 在「應用程式名稱」區域中,執行下列操作來命名及說明應用程式:

    1. 在「名稱」欄位中,輸入這個空間的專屬 ID。舉例來說,請使用不重複的名稱和環境組合,例如 web-app-staging。這是必填欄位。

      最多可使用 63 個字元,包括小寫英文字母、數字和連字號。名稱開頭必須為小寫英文字母,結尾不得為連字號。名稱無法變更。

    2. 在「顯示名稱」欄位中,輸入要在Google Cloud 控制台中顯示的名稱。

    3. 在「Description」(說明) 欄位中,輸入這個應用程式的用途。

  5. 如要為「專案 ID」欄位空白的元件設定預設專案,請從「部署專案」清單中選取專案。專案必須符合下列資格條件:

    如果元件的「專案 ID」欄位已指定專案,系統會使用該專案,而非這項設定。

  6. 從「Region」(區域) 清單中,選取部署元件的區域。 系統會根據下列條件套用元件區域:

    • 如果應用程式範圍是「全球」 (預設),則區域會套用至尚未設定區域的元件。

    • 如果應用程式範圍為「區域」,則區域會套用至所有元件。

  7. 從「Environment」(環境) 清單中,選取要部署這個應用程式的環境。舉例來說,您可能想在 TEST 中驗證部署作業是否正常運作。

  8. 從「Criticality」(重要性) 清單中,選取對您業務的影響程度。例如:LOWHIGH

  9. 如要指定擁有者,請在「擁有者」區域中按一下「新增擁有者」,然後輸入下列項目的「顯示名稱」和「電子郵件」

    • 在「業主」區域中,輸入負責品質和使用者期望的擁有者。

    • 在「開發人員擁有者」區域中,輸入負責開發及寫程式的擁有者。

    • 在「營運商擁有者」區域中,輸入負責營運應用程式的擁有者。

  10. 在「範圍」清單中,選取下列其中一個選項:

    • 全域 (預設):應用程式包含全域資源,或資源位於多個區域。

    • 區域性:所有資源都位於單一區域。

    這是必填欄位。詳情請參閱「比較全球和區域應用程式」。

  11. 點選「Create Application」(建立應用程式)。系統會顯示應用程式詳細資料。

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 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/REVISION
    • SCOPE_TYPE:應用程式的範圍。請選擇 regionalglobal。如果應用程式範圍為「global, the region is applied to components that don't already have a configured region. If the application scope isregional」,則區域會套用至所有元件。

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

設定元件和連線

您可以為應用程式中的每個元件指定設定詳細資料,例如建立資源的專案,以及部署資源的位置。

如果預設設定不符合需求,您也可以修改連線詳細資料。舉例來說,您可以修改環境變數鍵名、變更連線埠,或為服務帳戶新增其他角色。

您必須為每個支援的資源設定必要詳細資料。

如要設定元件和連線,請按照下列步驟操作:

設計畫布

  1. 在設計畫布中點選元件。

  2. 在「Configuration」(設定) 區域,從「Project ID」(專案 ID) 清單中,選取要部署資源的專案。選取符合下列資格的專案:

  3. 設定資源的其他設定。舉例來說,您可以為 Cloud SQL 設定下列項目:

    • 區域
    • 備份設定
    • 資料庫標記
    • IP 設定

    如要查看各元件的設定說明文件連結,請參閱「支援的資源」。

  4. 在設計畫布上連結元件時,系統會使用預設設定值建立連結。如要新增或修改連線詳細資料,請按照下列步驟操作。

    1. 在設計畫布中,按一下兩個元件之間的連線。「連線」面板隨即開啟,並顯示連線參數。

    2. 執行下列其中一個步驟:

      • 如要修改現有的連線參數,請按一下「編輯」

      • 如要新增連線參數,請按一下「新增參數」

    3. 更新「鍵」和「值」欄位。舉例來說,您可能想修改下列詳細資料:

      • 環境變數鍵名,以符合應用程式需求。
      • 連線埠值。
      • 新增至服務帳戶的角色。
  5. 按一下 [儲存]

gcloud CLI

  1. 說明應用程式,查看元件參數,並找出應用程式所需的參數。

     gcloud design-center spaces applications describe APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --format='yaml(name,componentParameters)'
    

    更改下列內容:

    • APPLICATION:應用程式 ID。
    • PROJECT:管理專案 ID。
    • LOCATION:應用程式區域。
    • SPACE:您的空間 ID。

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

  2. 針對要修改的每個元件,在主目錄中建立包含參數值的 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"
           }
        ]
      }
    
  3. 更新應用程式,設定必要參數。

     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 引數和值。

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

如需部署步驟,請參閱「從控制台部署應用程式」。

編輯 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 程式碼,請按照下列步驟操作:

  1. 點選設計畫布中的「程式碼」。系統會顯示產生的 Terraform 檔案。

  2. 按一下「main.tf」main.tf。系統會顯示每個元件的 Terraform 模組。

  3. 編輯設定詳細資料。詳情請參閱各支援資源的設定文件。

    系統會自動驗證編輯內容,如果編輯內容無效,系統會顯示錯誤。

  4. 如要醒目顯示並比較編輯內容,請按照下列步驟操作:

    1. 按一下「查看差異」

    2. 如要還原變更,請在邊界按一下「按一下即可還原變更」

    3. 按一下「查看差異」即可關閉比較檢視畫面。

  5. 如要儲存編輯內容,請按一下「儲存程式碼變更」

  6. 如要驗證變更,請按照下列步驟操作。

    1. 按一下「設計」
    2. 按一下元件,查看設定詳細資料。

建立應用程式修訂版本

建立應用程式修訂版本,修改詳細資料或元件。如果您在 App Design Center 以外修改應用程式元件,重新部署時不會保留這些變更。

如要建立應用程式修訂版本,請按照下列步驟操作:

設計畫布

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

    前往「Applications」(應用程式)

  2. 在表格中,按一下要修訂的「應用程式名稱」

  3. 如要修改應用程式詳細資料,請按照下列步驟操作:

  4. 按一下「編輯」並修改詳細資料。

  5. 按一下 [儲存] 以儲存變更。

  6. 如要修改這個應用程式中的元件,請按照下列步驟操作:

    1. 點選設計畫布中的元件,然後在「Configuration」(設定) 區域編輯詳細資料。

    2. 按一下 [儲存] 以儲存變更。

gcloud CLI

請參閱「設定元件和連線」。

如需部署步驟,請參閱「從控制台部署應用程式」。

刪除應用程式

如果不再需要某個應用程式,可以刪除。舉例來說,您可能會在 TEST 環境中部署應用程式來驗證範本,然後刪除該應用程式。

你可以刪除下列應用程式:

  • 尚未部署的應用程式。在「應用程式」頁面中,「狀態」會列為「草稿」
  • 已部署至 TESTDEVELOPMENTSTAGING 環境的應用程式。

刪除應用程式後,會發生下列情況:

  • 將應用程式詳細資料從 Application Design Center 中移除。
  • 刪除底層 App Hub 應用程式。
  • 如果已部署,系統會刪除資源。

如要刪除應用程式:

設計畫布

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

    前往「Applications」(應用程式)

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

  3. 點選 「Actions」(動作) ,然後選取「Delete Application」(刪除應用程式)

  4. 在「Delete」(刪除) 欄位中輸入應用程式名稱。

  5. 按一下「Delete」(刪除)

gcloud CLI

刪除應用程式。

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

更改下列內容:

後續步驟

使用下列任一方法部署應用程式: