設定建構環境變數 (來源部署)

建構環境變數是鍵/值組合，可讓您從原始碼部署時，將設定資訊傳遞至建構套件。舉例來說，您可能想在建構時自訂編譯器選項、指定建構時間憑證，以及設定參數等。

本頁面說明如何設定建構環境變數 (可在建構時使用)，適用於從來源部署 Cloud Run 服務或函式的平台開發人員。建構環境變數 gcloud CLI 標記支援來源部署作業 (--source)，但不支援容器映像檔部署作業 (--image)。

您可以使用環境變數設定服務或函式，但不建議使用環境變數儲存資料庫憑證或 API 金鑰等密鑰。請將機密值儲存在原始碼和環境變數以外的位置。建議使用 Secret Manager 儲存密鑰。如要設定可存取 Secret Manager 中所儲存密鑰的服務，請參閱「設定密鑰」。

事前準備

• Enable the Cloud Run Admin API and Cloud Build APIs.

  Roles required to enable APIs

  To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

  Enable the APIs

  啟用 Cloud Run Admin API 後，系統會自動建立 Compute Engine 預設服務帳戶。

必要的角色

您或管理員必須將下列 IAM 角色授予部署者帳戶和 Cloud Build 服務帳戶。

  gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
      --role=roles/run.builder
  

如需與 Cloud Run 相關聯的 IAM 角色和權限清單，請參閱 Cloud Run IAM 角色和 Cloud Run IAM 權限。如果 Cloud Run 服務與Google Cloud API (例如 Cloud 用戶端程式庫) 介接，請參閱服務身分設定指南。 如要進一步瞭解如何授予角色，請參閱部署權限和管理存取權。

建構環境變數的數量上限和限制

您最多可以定義 100 個建構環境變數，金鑰和值的總限制為 64 KiB。

設定建構環境變數

您可以設定建構環境變數，建立新變數或完全取代現有的建構變數。

gcloud run deploy SERVICE \
    --source . \
    --set-build-env-vars KEY1=VALUE1,KEY2=VALUE2

更新建構環境變數

您可以更新現有服務的建構環境變數。這是一種非破壞性方法，可變更或新增建構環境變數，但不會刪除建構環境變數。

gcloud run deploy SERVICE \
    --source . \
    --update-build-env-vars KEY1=VALUE1,KEY2=VALUE2

刪除建構環境變數

您可以刪除現有服務的建構環境變數。

gcloud run deploy SERVICE \
    --source . \
    --remove-build-env-vars KEY1=VALUE1,KEY2=VALUE2

gcloud run deploy SERVICE \
    --source . \
    --clear-build-env-vars KEY1=VALUE1,KEY2=VALUE2

使用建構環境變數檔案

您可以使用現有函式的建構環境變數檔案。

gcloud run deploy SERVICE \
    --source . \
    --build-env-vars-file FILE_NAME.yaml

 KEY1: VALUE1
 KEY2: VALUE2