Cloud Deploy 服務帳戶

本文說明用於執行 Cloud Deploy 的服務帳戶,以及呼叫 Cloud Deploy 執行各項作業的服務帳戶。

Cloud Deploy 會使用下列服務帳戶:

  • Cloud Deploy 服務代理

    Cloud Deploy 會使用這個服務帳戶與您的專案互動。您無法將這個服務代理更換為其他服務帳戶,但可以編輯其權限,例如使用專案外的資源 (例如服務帳戶或私人 Cloud Build worker 集區) 時。

  • Cloud Deploy 執行服務帳戶

    Cloud Deploy 會使用這個服務帳戶,在 Cloud Build 中執行轉譯和部署作業。這個帳戶必須具備足夠權限,才能讀取及寫入 Cloud Storage bucket,以及存取部署目標。

    預設的執行服務帳戶是預設 Compute Engine 服務帳戶。您可以在目標設定中指定替代服務帳戶。

  • Cloud Deploy 自動化服務帳戶

    Cloud Deploy 會使用這個服務帳戶執行自動化作業。可以是預設執行服務帳戶或其他服務帳戶。如要進一步瞭解這個服務帳戶,請參閱「自動化服務帳戶」。

如要瞭解如何編輯服務帳戶權限,以及如何建立替代服務帳戶,請參閱「建立及管理服務帳戶」。

Cloud Deploy 服務代理

Cloud Deploy 服務代理是服務帳戶,Cloud Deploy 會使用該帳戶與 Cloud Deploy 依賴的其他 Google Cloud服務互動。這些服務包括 Cloud Build、Pub/Sub 和 Cloud 稽核記錄。

這個服務帳戶的名稱格式如下:

service-<project-number>@gcp-sa-clouddeploy.

如果這個帳戶已從專案中移除,您可以重新加入:

  1. 在 Google Cloud 控制台中,開啟「IAM」頁面:

    開啟 IAM 頁面

  2. 選取「包含 Google 提供的角色授予項目」,即可顯示服務代理。

    如果畫面上顯示服務代理,您可以略過其餘步驟。

  3. 如果畫面上未顯示服務代理,請按一下「授予存取權」。

  4. 在「New principals」(新增主體) 欄位中,輸入服務代理程式位址,格式如下:

    1. service-<project-number>@gcp-sa-clouddeploy.
  5. 按一下「選取角色」下拉式選單,然後選取「Cloud Deploy 服務代理」。

  6. 按一下「儲存」。

Cloud Deploy 執行作業服務帳戶

根據預設,Cloud Deploy 會使用預設 Compute Engine 服務帳戶運作。

這個服務帳戶的名稱格式如下:

[project-number]-compute@

由於這項服務帳戶由多項產品使用,因此可能具備廣泛的權限。最佳做法是變更執行環境,讓 Cloud Deploy 以其他服務帳戶的身分執行。您可以使用目標定義中的 executionConfigs.privatePool.serviceAccount 屬性或 executionConfigs.defaultPool.serviceAccount 屬性,變更每個目標的執行服務帳戶。

您為這些屬性設定的任何服務帳戶,都必須具備 Cloud Deploy 專案中的 Cloud Deploy 執行者角色。如果預設執行服務帳戶沒有這個角色,請執行下列指令:

 gcloud projects add-iam-policy-binding PROJECT_ID \
     --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
     --format="value(projectNumber)")-compute@ \
     --role="roles/clouddeploy.jobRunner"

服務帳戶也需要執行階段專屬權限,才能部署至所選執行階段。如果是 Google Kubernetes Engine,您可以選擇「Container Developer」(容器開發人員) 和「Service Account User」(服務帳戶使用者) 角色。如果是 Cloud Run,您可以選擇「Cloud Run Developer」(Cloud Run 開發人員) 和「Service Account User」(服務帳戶使用者) 角色。自訂目標使用的其他執行階段可能需要專屬權限。

要建立哪些服務帳戶

如果選擇不使用預設執行服務帳戶進行轉譯和部署,則須建立一或多個替代服務帳戶。這些是 Cloud Deploy 執行時使用的服務帳戶,在目標設定中設定。

建立多個服務帳戶的原因之一,是需要一或多個特定服務帳戶,才能部署至受限制的目標,例如正式環境目標。

其中一種做法是為每個推送管道使用不同的服務帳戶。每個服務帳戶都應具備足夠的權限,可轉譯及部署。

如要部署至 Google Kubernetes Engine,您可以將服務帳戶限制在一個命名空間。

使用其他專案的服務帳戶

在執行環境中,您可以指定與目標建立位置不同的專案服務帳戶:

  1. 在服務帳戶所屬的專案中,啟用跨專案 SA 組織政策。

  2. 將服務帳戶的 iam.serviceAccounts.actAs 權限授予 Cloud Deploy 服務代理 (service-<project-number>@gcp-sa-clouddeploy.)。

    在本例中,project-number 是您建立目標的專案。

    您也可以在每個服務帳戶的專案中,授予 roles/iam.serviceAccountUser 角色,其中包含該權限。這些服務帳戶所在的專案,與執行 Cloud Deploy 的專案不同。

  3. 將 roles/iam.serviceAccountTokenCreator 角色授予 Cloud Build 服務代理 (service-<project-number>@gcp-sa-cloudbuild.)。

    在本例中,project-number 是您建立目標的專案,而這項角色是在服務帳戶的專案中授予。

    如果服務帳戶與 Cloud Deploy 執行的專案不同,您必須為目標執行環境中設定的每個服務帳戶授予這個角色。

  4. 將服務帳戶的 gcloud deploy releases create 和 gcloud deploy rollouts create iam.serviceAccounts.actAs 權限或 roles/iam.serviceAccountUser 角色授予呼叫端。

所需權限

  • 用於轉譯設定的服務帳戶必須具備足夠權限,才能存取儲存 Cloud Deploy 資源 (推送管道、版本、推出作業) 的 Cloud Storage bucket。

    roles/clouddeploy.jobRunner 角色包含轉譯服務帳戶 (privatePool 或 defaultPool) 所需的所有權限。

  • 用於部署的服務帳戶必須具備足夠權限,才能部署至目標叢集,以及存取 Cloud Storage bucket 的權限。

  • 呼叫 Cloud Deploy 建立版本的服務帳戶必須具備 clouddeploy.releaser 角色。此外,也必須具備 iam.serviceAccount.actAs 權限,才能使用轉譯資訊清單的服務帳戶 (例如透過 roles/iam.serviceAccountUser 角色)。

  • 呼叫 Cloud Deploy 來推送版本或建立 rollout 的服務帳戶,必須具備 iam.serviceAccount.actAs 權限,才能使用部署至目標的服務帳戶 (例如透過 roles/iam.serviceAccountUser 角色)。

  • 為自動化動作設定的服務帳戶,必須具備執行自動化作業的權限。瞭解詳情。

自動化服務帳戶

您可以自動執行版本中的某些動作。Cloud Deploy 會使用自動化服務帳戶執行這些自動化作業,該帳戶可以是預設執行服務帳戶、非預設服務帳戶 (做為執行服務帳戶),或其他服務帳戶。

進一步瞭解自動化服務帳戶。

後續步驟