本頁面說明如何使用 Infrastructure Manager 更新部署作業。您可能需要更新部署作業的情況包括:
將基礎架構還原至所選狀態。
建立部署作業後,資源可能會在一段時間後變更。舉例來說,某些資源可能已由在控制台中工作的人員修改。您可以使用原始 Terraform 設定更新部署作業,將其恢復為所選狀態。
對基礎架構進行變更。
建立部署作業後,您可能需要修改基礎架構。例如新增資源或變更部分設定。您可以使用描述新基礎架構的 Terraform 設定來更新部署作業。
本頁面假設您熟悉 Terraform。詳情請參閱「Terraform 和 Infra Manager」。
事前準備
- 確認已啟用 Infra Manager。
- 確認您具備建立部署作業所需的 IAM 權限:
roles/config.admin - 確認您有具備必要權限的服務帳戶。詳情請參閱「設定服務帳戶」。
- 找出要更新的 Infrastructure Manager 部署作業。
找出要部署更新的 Terraform 設定。任何設定都可用於修訂版本。這項設定通常與已部署的設定相同,或是已部署設定的更新版本。
請確認這項 Terraform 設定符合限制,包括設定不含機密資料。
確認貴組織的產品配額與預定基礎架構相關。如果預定基礎架構超過組織的部署作業產品配額,可能會發生部署錯誤。詳情請參閱「配額與限制」。
針對要修改的資源,採取必要步驟來遷移資料或維持服務不中斷。
如要在設定資源前預覽更新,請參閱「預覽部署作業更新」。
授予設定專屬權限
如要部署 Terraform 設定中指定的 Google Cloud 資源,您用來呼叫 Infra Manager 的服務帳戶必須具備下列權限:
Google Cloud 資源,這些資源定義於您用於修訂版本的設定中。
如果修訂版本使用的設定與部署作業使用的設定定義了不同的資源,您必須具備這兩項設定所定義資源的權限。
除了服務帳戶使用 Infra Manager 服務所需的權限外,還需要設定中定義的資源專屬權限。
如要進一步瞭解如何授予 Google Cloud 資源權限,以及確保您能存取所需專案,請參閱「設定服務帳戶」。
Connect your private Git repository and host to Cloud Build
If you are deploying a Terraform configuration from a private Git repository, you need to connect your Git host and repository to Cloud Build.
GitHub
GitHub Enterprise
GitLab
GitLab Enterprise
Developer Connect
可更新部署項目
如要更新部署作業,請使用相同的部署作業名稱部署設定,這樣就會建立修訂版本。詳情請參閱「部署作業和修訂版本總覽」。
如果沒有現有部署作業,請參閱「使用 Infra Manager 部署基礎架構」。
如要預覽更新而不佈建資源,請參閱「預覽部署作業」。
選取所選工作流程的分頁標籤,進一步瞭解如何更新部署作業。
控制台
本節說明如何在 Google Cloud 控制台,使用 Infra Manager 更新 Terraform 設定。
部署設定並建立修訂版本:
- 前往 Google Cloud 控制台的「Infra Manager」頁面。
- 在「Deployments」(部署作業) 頁面的「ID」欄中,按一下要更新的部署作業。
- 在標題為部署作業 ID 的頁面上,按一下「編輯」。
- 在「Deployment details」(部署作業詳細資料) 頁面中,您可以修改「Terraform version」(Terraform 版本) 、「Service account」(服務帳戶) 和「Source of Terraform configuration」(Terraform 設定來源) 欄位。如果您提供私人 Git 存放區,請務必將主機和存放區連結至 Cloud Build。
按一下「繼續」。
- 在「Terraform details」(Terraform 詳細資料) 頁面,您可以修改 Terraform 設定的「Input values」(輸入值)。然後點按「繼續」。
- 在「Advanced details」(進階詳細資料) 頁面中,您可以修改「Labels and annotations」(標籤和註解)、「Worker pools」(工作站集區) 和「Artifact Cloud Storage bucket」(構件 Cloud Storage bucket) 欄位。
- 確認部署作業變更無誤後,按一下「更新」即可啟動更新程序。
如要進一步瞭解部署作業參數和格式,請參閱「部署資源」說明文件。
gcloud CLI
本節說明如何部署儲存在 Cloud Storage bucket 中的 Terraform 設定。儲存空間 bucket 可讓您控管設定的存取權。
- 確認 Terraform 設定位於 Cloud Storage bucket。詳情請參閱「將設定上傳至 Storage bucket」。
如果儲存空間 bucket 所在的專案與執行 Infra Manager 的專案不同,請務必確認 Infra Manager 的服務帳戶具備 bucket 的讀取權限。詳情請參閱「設定服務帳戶」。
如果 Storage bucket 與 Infra Manager 位於同一個專案,則 bucket 的讀取權限已啟用。
部署設定並建立修訂版本:
gcloud infra-manager deployments apply projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \ --service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \ --gcs-source gs://BUCKET_NAME/OBJECT_NAME \ --quota-validation=QUOTA_VALIDATION \ --input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \ --tf-version-constraint=TERRAFORM_VERSION \ --annotations="ANNOTATION_KEY=ANNOTATION_VALUE" \ --provider-source=SERVICE_MAINTAINED
- PROJECT_ID:Infra Manager 執行的專案 ID。
- LOCATION:Infra Manager 的執行位置。如需有效位置清單,請參閱「Infra Manager 位置」。
- DEPLOYMENT_ID:您指定的部署作業 ID。如要進一步瞭解部署作業 ID 的限制,請參閱「部署作業名稱」。
- SERVICE_ACCOUNT_PROJECT_ID 是服務帳戶的專案 ID。通常與執行 Infra Manager 的專案相同。
- SERVICE_ACCOUNT:用於呼叫 Infra Manager 的服務帳戶名稱。
- BUCKET_NAME:儲存設定的 bucket 名稱。
- OBJECT_NAME:設定檔的物件名稱。這個物件可以是目錄或 ZIP 檔案,但不能是 Terraform 檔案。如果使用物件版本管理功能,也可以指定物件的版本編號。詳情請參閱「使用版本化物件」。
如果儲存空間值區是 Terraform 設定的根路徑,則 OBJECT_NAME 為選填。
- 選用:QUOTA_VALIDATION:這個值決定建立部署作業時,是否要啟用或強制執行 Terraform 設定檔中資源的配額驗證。可能的值包括:
ENABLED:為 Terraform 設定檔中的資源啟用運算配額驗證。提供配額不足資源的瀏覽權限。ENFORCED:強制執行配額驗證,如果 Terraform 設定檔中定義的基礎架構沒有足夠的配額,部署作業就會失敗。
如未定義 QUOTA_VALIDATION,系統會停用 Terraform 設定檔的配額驗證功能。這是預設值。配額驗證適用於有限的 Google Cloud 資源。詳情請參閱「配額與限制」。
INPUT_1_NAME 和 INPUT_2_NAME:Terraform 設定的所有輸入值,包括預設中未定義的值。舉例來說,您可以指定部署資源的專案,例如
project_id=my-project。如果設定中預設定義了所有輸入值,則這個旗標為選用。
- 選用:TERRAFORM_VERSION:Infra Manager 用來更新部署作業的 Terraform 版本。如需支援的版本清單,請參閱「支援的 Terraform 版本」。如果移除這個選用旗標,Infra Manager 會使用現有部署作業的 Terraform 版本,或預設為最新支援的免費方案版本 (
1.5.7)。如要升級至付費版本 (例如1.16.5),則必須明確指定版本。 - 選用:ANNOTATION_KEY 和 ANNOTATION_VALUE 代表可附加至 Infra Manager 部署作業的任意形式文字鍵/值組合。如要進一步瞭解註解和標籤的使用方式和限制,請參閱「註解和標籤」。
- 選用:PROVIDER_SOURCE:決定部署作業使用的 Google Cloud Terraform 供應商。設為
SERVICE_MAINTAINED,即可使用 Infra Manager 維護的 Terraform 供應商。如要使用 HashiCorp 維護的 Terraform 供應商,請省略這個欄位。詳情請參閱「使用 Google Cloud的 Terraform 供應商」。
gcloud CLI
本節說明如何使用儲存在 Git 存放區中的 Terraform 設定。
- 確認您已安裝 Git。
- 如果 Terraform 設定儲存在
私人 Git 存放區 ,請確認 Git 主機和存放區已連結至 Cloud Build。 部署設定並建立修訂版本:
gcloud infra-manager deployments apply projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \ --service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \ --git-source-repo="GIT_REPO" \ --git-source-directory="DIRECTORY" \ --git-source-ref="REF" \ --quota-validation=QUOTA_VALIDATION \ --input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \ --tf-version-constraint=TERRAFORM_VERSION \ --annotations="ANNOTATION_KEY=ANNOTATION_VALUE" \ --provider-source=SERVICE_MAINTAINED
- PROJECT_ID:Infra Manager 執行的專案 ID。
- LOCATION:Infra Manager 的執行位置。如需有效位置清單,請參閱「Infra Manager 位置」。
- DEPLOYMENT_ID:您指定的部署作業 ID。如要進一步瞭解部署作業 ID 的限制,請參閱「部署作業名稱」。
- SERVICE_ACCOUNT_PROJECT_ID 是服務帳戶的專案 ID。通常與執行 Infra Manager 的專案相同。
- SERVICE_ACCOUNT:用於呼叫 Infra Manager 的服務帳戶名稱。
- GIT_REPO:Git 存放區。
- DIRECTORY:含有 Terraform 設定的目錄。
- 選用:REF:設定的 Git 參照。參考資料為選填項目。如未指定參照,系統會使用 Git 存放區預設的分支版本。
- 選用:QUOTA_VALIDATION:這個值決定建立部署作業時,是否要啟用或強制執行 Terraform 設定檔中資源的配額驗證。可能的值包括:
ENABLED:為 Terraform 設定檔中的資源啟用運算配額驗證。提供配額不足資源的瀏覽權限。ENFORCED:強制執行配額驗證,如果 Terraform 設定檔中定義的基礎架構沒有足夠的配額,部署作業就會失敗。
如未定義 QUOTA_VALIDATION,系統會停用 Terraform 設定檔的配額驗證功能。這是預設值。配額驗證適用於有限的 Google Cloud 資源。詳情請參閱「配額與限制」。
INPUT_1_NAME 和 INPUT_2_NAME:Terraform 設定的所有輸入值,包括預設中未定義的值。舉例來說,您可以指定部署資源的專案,例如
project_id=my-project。如果設定中預設定義了所有輸入值,則這個旗標為選用。
- 選用:TERRAFORM_VERSION:Infra Manager 用來更新部署作業的 Terraform 版本。如需支援的版本清單,請參閱「支援的 Terraform 版本」。如果移除這個選用旗標,Infra Manager 會使用現有部署作業的 Terraform 版本,或預設為最新支援的免費方案版本 (
1.5.7)。如要升級至付費版本 (例如1.16.5),則必須明確指定版本。 - 選用:ANNOTATION_KEY 和 ANNOTATION_VALUE 代表可附加至 Infra Manager 部署作業的任意形式文字鍵/值組合。如要進一步瞭解註解和標籤的使用方式和限制,請參閱「註解和標籤」。
- 選用:PROVIDER_SOURCE:決定部署作業使用的 Google Cloud Terraform 供應商。設為
SERVICE_MAINTAINED,即可使用 Infra Manager 維護的 Terraform 供應商。如要使用 HashiCorp 維護的 Terraform 供應商,請省略這個欄位。詳情請參閱「使用 Google Cloud的 Terraform 供應商」。
gcloud CLI
本節說明如何使用儲存在本機電腦上的 Terraform 設定。
- 如果您使用 Cloud Shell,則必須將設定上傳至 Cloud Shell。詳情請參閱「使用 Cloud Shell 管理檔案」。
部署設定並建立修訂版本:
gcloud infra-manager deployments apply projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \ --service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \ --local-source="LOCAL_DIRECTORY" \ --quota-validation=QUOTA_VALIDATION \ --input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \ --tf-version-constraint=TERRAFORM_VERSION \ --annotations="ANNOTATION_KEY=ANNOTATION_VALUE" \ --provider-source=SERVICE_MAINTAINED
- PROJECT_ID:Infra Manager 執行的專案 ID。
- LOCATION:Infra Manager 的執行位置。如需有效位置清單,請參閱「Infra Manager 位置」。
- DEPLOYMENT_ID:您指定的部署作業 ID。如要進一步瞭解部署作業 ID 的限制,請參閱「部署作業名稱」。
- SERVICE_ACCOUNT_PROJECT_ID 是服務帳戶的專案 ID。通常與執行 Infra Manager 的專案相同。
- SERVICE_ACCOUNT:用於呼叫 Infra Manager 的服務帳戶名稱。
- LOCAL_DIRECTORY:儲存 Terraform 設定的本機目錄。如果您使用 Cloud Shell,這就是 Cloud Shell 中儲存設定的目錄。
- 選用:QUOTA_VALIDATION:這個值決定建立部署作業時,是否要啟用或強制執行 Terraform 設定檔中資源的配額驗證。可能的值包括:
ENABLED:為 Terraform 設定檔中的資源啟用運算配額驗證。提供配額不足資源的瀏覽權限。ENFORCED:強制執行配額驗證,如果 Terraform 設定檔中定義的基礎架構沒有足夠的配額,部署作業就會失敗。
如未定義 QUOTA_VALIDATION,系統會停用 Terraform 設定檔的配額驗證功能。這是預設值。配額驗證適用於有限的 Google Cloud 資源。詳情請參閱「配額與限制」。
INPUT_1_NAME 和 INPUT_2_NAME:Terraform 設定的所有輸入值,包括預設中未定義的值。舉例來說,您可以指定部署資源的專案,例如
project_id=my-project。如果設定中預設定義了所有輸入值,則這個旗標為選用。
- 選用:TERRAFORM_VERSION:Infra Manager 用來更新部署作業的 Terraform 版本。如需支援的版本清單,請參閱「支援的 Terraform 版本」。如果移除這個選用旗標,Infra Manager 會使用現有部署作業的 Terraform 版本,或預設為最新支援的免費方案版本 (
1.5.7)。如要升級至付費版本 (例如1.16.5),則必須明確指定版本。 - 選用:ANNOTATION_KEY 和 ANNOTATION_VALUE 代表可附加至 Infra Manager 部署作業的任意形式文字鍵/值組合。如要進一步瞭解註解和標籤的使用方式和限制,請參閱「註解和標籤」。
- 選用:PROVIDER_SOURCE:決定部署作業使用的 Google Cloud Terraform 供應商。設為
SERVICE_MAINTAINED,即可使用 Infra Manager 維護的 Terraform 供應商。如要使用 HashiCorp 維護的 Terraform 供應商,請省略這個欄位。詳情請參閱「使用 Google Cloud的 Terraform 供應商」。
後續步驟
- 進一步瞭解 Terraform 搭配 Google Cloud。
- 自動部署。
- 查看部署作業狀態。
- 查看已部署的資源。
- 刪除部署項目。