本頁說明如何為 Cloud Run 工作站集區設定環境變數。
變更任何設定都會建立新的修訂版本。除非您明確做出更新,變更這項設定,否則後續的修訂版本也會自動取得這個設定。
必要的角色
如要取得設定及部署 Cloud Run 工作站集區所需的權限,請要求管理員授予下列 IAM 角色:
-
Cloud Run 開發人員 (
roles/run.developer
) 在 Cloud Run worker 集區上 -
服務帳戶使用者 (
roles/iam.serviceAccountUser
) 服務身分
如需與 Cloud Run 相關聯的 IAM 角色和權限清單,請參閱 Cloud Run IAM 角色和 Cloud Run IAM 權限。如果 Cloud Run 工作站集區與Google Cloud API (例如 Cloud 用戶端程式庫) 介接,請參閱服務身分設定指南。如要進一步瞭解如何授予角色,請參閱部署權限和管理存取權。
設定環境變數
您在建立新 worker 集區或部署新修訂版本時,可以使用 Google Cloud CLI 設定環境變數:
gcloud
如要在部署工作站集區時指定環境變數,請使用 --set-env-vars
旗標:
gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2
取代:
- WORKER_POOL:工作站集區名稱
- KEY1=VALUE1,KEY2=VALUE2:以逗號分隔的變數名稱和值清單
- IMAGE_URL,並參照內含工作站集區的容器映像檔,例如
us-docker.pkg.dev/cloudrun/container/worker-pool:latest
更新環境變數
您可以更新現有服務的執行階段環境變數。這是一種非破壞性方法,可變更或新增執行階段環境變數,但不會刪除這些變數。
gcloud
如要更新現有工作站集區的環境變數,請使用 --update-env-vars
旗標:
gcloud beta run worker-pools update WORKER_POOL --update-env-vars KEY1=VALUE1,KEY2=VALUE2
取代:
- WORKER_POOL:工作站集區名稱
- KEY1=VALUE1,KEY2=VALUE2:以逗號分隔的變數名稱和值清單
刪除環境變數
gcloud
如要從現有工作站集區選擇性移除環境變數,請使用 --remove-env-vars
旗標:
gcloud beta run worker-pools update WORKER_POOL --remove-env-vars KEY1,KEY2
取代:
- WORKER_POOL:工作站集區名稱
- KEY1,KEY2:以半形逗號分隔的變數名稱清單
或者,您也可以使用 --clear-env-vars
標記,清除先前設定的所有環境變數:
gcloud beta run worker-pools update WORKER_POOL --clear-env-vars
將 WORKER_POOL 替換為工作站集區的名稱。
查看工作站集區的環境變數設定
前往 Google Cloud 控制台的 Cloud Run:
按一下「工作站集區」,即可顯示已部署的工作站集區清單。
按一下要檢查的 worker 集區,顯示詳細資料窗格。
按一下「Containers」(容器) 分頁標籤,即可顯示工作站集區容器設定。
程式碼範例
如需程式碼範例,瞭解如何在程式碼中存取環境變數,請參閱使用者驗證教學課程中的「使用 Secret Manager 處理機密設定」。
後續步驟
您可以使用環境變數設定 buildpack。如需特定語言的詳細資料,請參閱下列建構套件說明文件: