Cloud Run 服務或修訂版本具有服務身分,可做為已驗證帳戶,用於從 Cloud Run 執行個體容器存取 Google Cloud API。如要進一步瞭解服務身分,請參閱「服務身分簡介」指南。
服務身分的使用方式
在 Cloud Run 中,服務身分是同時為資源和主體的服務帳戶。
- 服務身分做為資源:如要將服務帳戶附加為服務身分,部署者帳戶必須具備服務身分資源的存取權。某些作業 (例如建立或更新服務或修訂版本) 需要部署者帳戶具備服務身分資源的權限。
- 服務身分做為主體:如要從 Cloud Run 服務或修訂版本存取 Google Cloud API,您必須為服務身分授予所需角色或權限,才能執行服務或修訂版本要執行的作業。
下一節將說明授予部署者帳戶服務身分資源存取權,以及授予服務帳戶主體所需角色或權限時,必須具備的角色。
必要的角色
您或管理員必須為部署者帳戶和服務身分授予 IAM 角色和權限。
按一下即可查看部署者帳戶的必要角色
如要取得所需權限,將服務帳戶附加為服務或修訂版本的服務身分,您或管理員必須將做為服務身分的服務帳戶服務帳戶使用者角色 (roles/iam.serviceAccountUser) 授予部署者帳戶。
這個預先定義的角色具備 iam.serviceAccounts.actAs 權限,可將服務帳戶附加至服務或修訂版本。您或許也能透過設定自訂角色或使用其他預先定義的角色,取得這項權限。
如要瞭解如何將服務身分的這項角色授予部署者帳戶,請參閱部署權限。如果服務帳戶與 Cloud Run 服務或修訂版本位於不同專案,您或管理員也必須為 Cloud Run 服務代理設定 IAM 角色,並設定組織政策。詳情請參閱「使用其他專案中的服務帳戶」。
按一下即可查看服務身分所需的角色
如要允許服務身分從 Cloud Run 存取 Google Cloud API,您或管理員必須將您要執行的作業所需的權限或角色授予服務身分。如要存取特定 Cloud 用戶端程式庫,請參閱 Google Cloud 服務的 Google Cloud 說明文件。
如果 Cloud Run 服務或修訂版本不會存取其他 Google Cloud 服務,您就不需要授予服務身分任何角色或權限,並可使用指派給專案的預設服務帳戶。
取得建立專屬服務帳戶的建議
從 Google Cloud 控制台建立新的服務帳戶時,可選擇執行「將專案存取權授予這個服務帳戶」步驟,授予任何必要的額外存取權。舉例來說,某個 Cloud Run 服務可能會叫用另一個私人 Cloud Run 服務,或存取 Cloud SQL 資料庫,這兩者都需要特定 IAM 角色。詳情請參閱管理存取權的說明文件。
建議工具服務也會自動提供建議,指出如何建立具備最低必要權限組合的專屬服務帳戶。
設定服務身分
如果您尚未建立服務帳戶,可以在 IAM 或 Cloud Run 中建立使用者自行管理的服務帳戶。
如要設定服務身分,請在建立新服務或部署新修訂版本時,使用 Google Cloud 控制台、gcloud CLI、API (YAML) 或 Terraform:
控制台
前往 Google Cloud 控制台的「Cloud Run」頁面:
從 Cloud Run 導覽選單中選取「Services」(服務):
如要設定新服務,請按一下「Deploy container」(部署容器),然後填寫初始服務設定頁面。然後按一下「Containers, Networking, Security」(容器、網路、安全性),展開服務設定頁面。
如要設定現有服務,請按一下該服務。
按一下「安全性」分頁標籤。
按一下「Service account」(服務帳戶) 下拉式選單,然後選取現有服務帳戶,或視情況點選「Create a new service account」(建立新的服務帳戶)。
按一下「建立」,建立新服務。依序點選「查看差異並重新部署」和「部署變更」,即可更新現有服務。
gcloud
您可以使用下列指令更新現有服務,以取得新的服務帳戶:
gcloud run services update SERVICE --service-account SERVICE_ACCOUNT
更改下列內容:
- SERVICE:服務名稱。
- SERVICE_ACCOUNT:與新身分相關聯的服務帳戶:這個值是服務帳戶的電子郵件地址,例如
example@myproject.iam.gserviceaccount.com。
您也可以在部署期間使用下列指令設定服務帳戶:
gcloud run deploy --image IMAGE_URL --service-account SERVICE_ACCOUNT
更改下列內容:
IMAGE_URL:容器映像檔的參照,例如us-docker.pkg.dev/cloudrun/container/hello:latest。如果使用 Artifact Registry,則必須先建立存放區 REPO_NAME。網址格式為LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG。- SERVICE_ACCOUNT:與新身分相關聯的服務帳戶:這個值是服務帳戶的電子郵件地址,例如
example@myservice.iam.gserviceaccount.com。
YAML
如要建立新服務,請略過這個步驟。如要更新現有服務,請下載其 YAML 設定:
gcloud run services describe SERVICE --format export > service.yaml
更新
serviceAccountName:屬性:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: spec: serviceAccountName: SERVICE_ACCOUNT
更改下列內容:
- SERVICE:Cloud Run 服務的名稱。
- SERVICE_ACCOUNT:與新身分相關聯的服務帳戶。這個值是服務帳戶的電子郵件地址,例如
SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com。
使用下列指令建立或更新服務:
gcloud run services replace service.yaml
gcloud run services replace指令預設會使用service.yaml檔案 (如有)。
Terraform
如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。
在 Terraform 設定中,將下列內容新增至google_cloud_run_v2_service 資源:如要建立服務帳戶,請將下列資源新增至現有的 main.tf 檔案:
建立或更新 Cloud Run 服務,並加入服務帳戶:
使用其他專案中的服務帳戶
如果設定的服務帳戶與 Cloud Run 資源位於不同 Google Cloud 專案,請執行下列操作:
您或管理員必須為您用作服務身分的服務帳戶,授予服務帳戶使用者角色 (
roles/iam.serviceAccountUser)。控制台
前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面:
選取要用作服務身分的服務帳戶電子郵件地址。
點選「具備存取權的主體」分頁標籤。
按一下 「Grant access」(授予存取權) 按鈕。
輸入部署者帳戶電子郵件地址,該地址須與您要授予管理員或開發人員角色的主體相符。
在「Select a role」(選取角色) 下拉式選單中,依序選取「Service Accounts」(服務帳戶) >「Service Account User」(服務帳戶使用者) 角色。
按一下「儲存」。
gcloud
使用
gcloud iam service-accounts add-iam-policy-binding指令,並將醒目顯示的變數替換為適當的值:gcloud iam service-accounts add-iam-policy-binding \ SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com \ --member="PRINCIPAL" \ --role="roles/iam.serviceAccountUser"
更改下列內容:
SERVICE_ACCOUNT_NAME:要附加 Cloud Run 資源的服務帳戶名稱。SERVICE_ACCOUNT_PROJECT_ID:服務帳戶所在的專案 ID。PRINCIPAL:要新增繫結的部署者帳戶,格式為
user|group|serviceAccount:email或domain:domain,例如:user:test-user@gmail.comgroup:admins@example.comserviceAccount:test123@example.domain.comdomain:example.domain.com
您或管理員必須將服務帳戶權杖建立者角色 (
roles/iam.serviceAccountTokenCreator) 授予 Cloud Run 資源的服務代理,並將該角色套用至您做為服務身分的服務帳戶。服務代理程式的格式為service-PROJECT_NUMBER@serverless-robot-prod.iam.gserviceaccount.com。控制台
前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面:
選取要用作服務身分的服務帳戶電子郵件地址。
按一下「Permissions」(權限) 分頁標籤。
按一下 「Grant access」(授予存取權) 按鈕。
輸入服務代理電子郵件地址。例如
service-PROJECT_NUMBER@serverless-robot-prod.iam.gserviceaccount.com。在「Select a role」(選取角色) 下拉式選單中,依序選取「Service Accounts」(服務帳戶) >「Service Account Token Creator」(服務帳戶權杖建立者) 角色。
按一下「儲存」。
gcloud
使用
gcloud iam service-accounts add-iam-policy-binding指令:gcloud iam service-accounts add-iam-policy-binding \ SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com \ --member="serviceAccount:service-CLOUD_RUN_RESOURCE_PROJECT_NUMBER@serverless-robot-prod.iam.gserviceaccount.com" \ --role="roles/iam.serviceAccountTokenCreator"
更改下列內容:
SERVICE_ACCOUNT_NAME:要附加 Cloud Run 資源的服務帳戶名稱。SERVICE_ACCOUNT_PROJECT_ID:服務帳戶所在的專案 ID。CLOUD_RUN_RESOURCE_PROJECT_NUMBER:Cloud Run 所在的專案編號。
指令會輸出使用者自行管理服務帳戶的更新版允許政策。
包含這個服務帳戶的專案,必須將機構政策
iam.disableCrossProjectServiceAccountUsage設為 false,或在資料夾層級不強制執行,或沿用專案層級設定。預設值為true。控制台
前往 Google Cloud 控制台的「Organization policies」(組織政策) 頁面:
在專案挑選器中,選取要停用跨專案服務帳戶的組織和專案。
選取「停用跨專案服務帳戶」政策。
按一下「Manage Policy」(管理政策)。
在「政策來源」下方,選取「覆寫上層政策」。
點選「新增規則」。
在「Enforcement」(強制執行) 下方,選取「Off」 (關閉)。
如要強制執行政策,請按一下「Set policy」(設定政策)。
gcloud
在具有服務帳戶的專案中,確認未強制執行
iam.disableCrossProjectServiceAccountUsage組織政策限制。這項限制預設會強制執行。如要停用這項組織政策限制,請執行:
gcloud resource-manager org-policies disable-enforce iam.disableCrossProjectServiceAccountUsage --project=SERVICE_ACCOUNT_PROJECT_ID
將 SERVICE_ACCOUNT_PROJECT_ID 替換為包含服務帳戶的專案 ID。
您可以直接將角色成員資格套用至服務帳戶資源,或從資源階層中較高層級繼承。
後續步驟
- 如要進一步瞭解服務帳戶,請參閱 IAM 服務帳戶和使用者自行管理的服務帳戶指南。
- 如果 Cloud Run 服務、工作、worker 集區或執行個體會存取 Google API 或 Google Cloud 服務,您必須將服務帳戶設為服務身分。瞭解詳情