設定服務帳戶

如要使用 Infrastructure Manager 建立、更新或刪除部署作業,您必須使用服務帳戶。Infra Manager 會以這個服務帳戶的身分執行 Terraform。

您不需要服務帳戶,即可查看 Infra Manager 部署作業的相關資訊。

本頁面說明如何設定服務帳戶,以便使用 Infrastructure Manager 部署資源。

事前準備

  1. 啟用 Infra Manager 服務。
  2. 建立服務帳戶,或找出要與 Infra Manager 搭配使用的現有服務帳戶。

將存取權授予服務帳戶

如要使用 Infrastructure Manager 建立、更新或刪除部署作業,個別使用者必須具備服務帳戶的存取權。

將服務帳戶的服務帳戶使用者 (roles/iam.serviceAccountUser) IAM 角色授予使用者。

授予 Infra Manager 權限

如要使用 Infra Manager,服務帳戶必須具備 Infra Manager 代理程式 (roles/config.agent) 角色。這會授予 Infra Manager 建立、更新及刪除資源的權限:

   gcloud projects add-iam-policy-binding INFRA_MANAGER_PROJECT_ID \
      --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
      --role="roles/config.agent"

更改項目:

  • INFRA_MANAGER_PROJECT_ID:要建立部署作業的專案 ID。

  • SERVICE_ACCOUNT_EMAIL:服務帳戶的電子郵件地址。

如要進一步瞭解如何將權限授予服務帳戶,請參閱「管理服務帳戶的存取權」。

授予 Storage bucket 的讀取的權限

您可以使用 Storage bucket 儲存 Infra Manager 部署的 Terraform 設定。

如果您使用 Storage bucket 存放設定,且這個 Storage bucket 所在的專案與執行 Infra Manager 的專案不同,則必須確保用於呼叫 Infra Manager 的服務帳戶具備 bucket 的讀取權限。如要進一步瞭解 Cloud Storage 權限,請參閱「Cloud Storage 的 IAM 權限」。

如果 Storage bucket 與 Infra Manager 位於同一個專案,且您已將 roles/config.agent 授予服務帳戶,則 bucket 的讀取權限已啟用。

如要進一步瞭解如何將設定上傳至儲存空間 bucket,請參閱「上傳 Terraform 設定」。

授予設定中定義的資源權限

如要建立及管理 Terraform 設定中定義的 Google Cloud 資源,服務帳戶必須具備這些資源的特定權限。

  • 您部署的 Terraform 設定中,定義了 Google Cloud 資源專屬的權限。舉例來說,建立 Compute Engine VM 執行個體的權限是 compute.instances.create。

  • Google Cloud 資源專屬權限,定義於您要更新的部署作業 Terraform 設定中。

    舉例來說,假設您的部署作業佈建了 Compute Engine VM,然後您使用不含 Compute Engine VM 的設定更新部署作業。在這種情況下,更新修訂版本時,服務帳戶需要:

    • 新設定中定義的資源權限。

    • 刪除資源所需的權限,例如本例中的 Compute Engine VM。

如要瞭解如何找出 Terraform 設定中資源所需的權限,請參閱「選擇預先定義的角色」。

如要進一步瞭解如何將權限授予服務帳戶,請參閱「管理服務帳戶的存取權」。

授予多項專案的存取權

如果指定服務帳戶與執行 Infra Manager 服務的專案不同,則需要額外權限。

如要授予這些額外權限,請按照下列步驟操作:

  1. 確認服務帳戶在執行 Infra Manager 的專案中,具備基礎架構管理員代理程式 (roles/config.agent) 角色。如要瞭解如何授予權限,請參閱「授予 Infra Manager 權限」。

  2. 選用:如果您使用 Developer Connect 部署 Terraform 設定,請將 roles/iam.serviceAccountTokenCreator 角色授予服務帳戶。

  3. 在具有服務帳戶的專案中,確認未強制執行 iam.disableCrossProjectServiceAccountUsage 組織政策限制。這項限制預設會強制執行。

    如要停用這項組織政策限制,請執行:

       gcloud resource-manager org-policies disable-enforce iam.disableCrossProjectServiceAccountUsage
           --project=SERVICE_ACCOUNT_PROJECT_ID
    

    將 SERVICE_ACCOUNT_PROJECT_ID 替換為包含服務帳戶的專案 ID。

  4. 在具有服務帳戶的專案中,為要建立部署作業的專案,授予 Infra Manager 服務代理的 roles/iam.serviceAccountUser 角色:

    gcloud projects add-iam-policy-binding SERVICE_ACCOUNT_PROJECT_ID \
       --member="serviceAccount:service-INFRA_MANAGER_PROJECT_NUMBER@gcp-sa-config.iam.gserviceaccount.com" \
       --role="roles/iam.serviceAccountUser"
    

    更改項目:

    • SERVICE_ACCOUNT_PROJECT_ID:服務帳戶所在專案的專案 ID。
    • INFRA_MANAGER_PROJECT_NUMBER:建立部署作業的專案編號。這會形成服務代理的電子郵件 ID:service-INFRA_MANAGER_PROJECT_NUMBER@gcp-sa-config.iam.gserviceaccount.com
  5. 在建立部署作業的專案中,將服務帳戶權杖建立者 (roles/iam.serviceAccountTokenCreator) 角色授予 Cloud Build 服務代理。如要允許 Infra Manager 使用 Cloud Build 執行 Terraform,您必須在包含服務帳戶的專案中,為 Cloud Build 服務代理授予額外權限,做為跨專案設定的一部分:

    gcloud projects add-iam-policy-binding SERVICE_ACCOUNT_PROJECT_ID \
        --member="serviceAccount:service-INFRA_MANAGER_PROJECT_NUMBER@gcp-sa-cloudbuild.iam.gserviceaccount.com" \
         --role="roles/iam.serviceAccountTokenCreator"
    

後續步驟