設定服務的環境變數

控制台

1. 前往 Google Cloud 控制台的 Cloud Run：

   前往 Cloud Run

2. 從選單中選取「服務」，然後按一下「部署容器」，設定新服務。如要設定現有服務，請按一下該服務，然後點選「編輯並部署新修訂版本」。

3. 如要設定新服務，請填寫初始服務設定頁面，然後按一下「容器、磁碟區、網路與安全性」，展開服務設定頁面。

4. 按一下「容器」分頁標籤。

   

   • 按一下「新增變數」新增變數，然後在「名稱」和「值」欄位中指定變數名稱和值。

5. 按一下 [Create] (建立) 或 [Deploy] (部署)。

gcloud

如要在部署服務時指定環境變數，請使用 --set-env-vars 標記：

gcloud run deploy SERVICE --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2

取代：

• SERVICE 改為您的服務名稱。
• KEY1=VALUE1,KEY2=VALUE2，並以逗號分隔變數名稱和值。
• IMAGE_URL，並參照容器映像檔，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址的格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 。

如要在更新服務時指定環境變數，請使用 --set-env-vars 標記：

gcloud run services update SERVICE --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2

設定多個環境變數

   [...]
   --set-env-vars "KEY1=VALUE1" \
   --set-env-vars "KEY2=VALUE2" \
   --set-env-vars "KEY3=VALUE3"

逸出半形逗號字元

--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."

YAML

1. 如要建立新服務，請略過這個步驟。 如要更新現有服務，請下載其 YAML 設定：

   gcloud run services describe SERVICE --format export > service.yaml

2. 更新 containers: 下 env 屬性中的 name 和 value 屬性：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         name: REVISION
       spec:
         containers:
         - image: IMAGE
           env:
           - name: KEY-1
             value: VALUE-1
           - name: KEY-N
             value: VALUE-N

   取代

   • SERVICE 改為 Cloud Run 服務名稱
   • IMAGE_URL，並參照容器映像檔，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址的格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
   • KEY-1、VALUE-1，並提供環境變數和值。視需要新增更多變數和值。
   • REVISION，並提供新的修訂版本名稱，或刪除該名稱 (如有)。如果您提供新的修訂版本名稱，則必須符合下列條件：
     • 開頭為「SERVICE-」
     • 只能包含小寫字母、數字和 -
     • 結尾不是 -
     • 不超過 63 個半形字元

3. 使用下列指令建立或更新服務：

   gcloud run services replace service.yaml

Terraform

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-env-var"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      # Environment variables
      env {
        name  = "foo"
        value = "bar"
      }
      env {
        name  = "baz"
        value = "quux"
      }
    }
  }
}

上述 google_cloud_run_v2_service 資源會將 foo 環境變數設為 bar，並將 baz 環境變數設為 quux。視需要更新環境變數。

主控台

如要使用 Google Cloud 控制台更新環境變數，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的 Cloud Run：

   前往 Cloud Run

2. 從清單中選取服務，然後按一下「Edit and deploy new revision」(編輯及部署新版本)。

3. 按一下「容器」分頁標籤。

4. 在「變數和密鑰」分頁中，編輯「名稱」或「值」欄位，然後按一下「完成」。

5. 按一下 [Deploy] (部署)。

gcloud

如要更新現有服務的環境變數，請使用 --update-env-vars 旗標：

gcloud run services update SERVICE --update-env-vars KEY1=VALUE1,KEY2=VALUE2

取代：

• SERVICE 改為您的服務名稱。
• KEY1=VALUE1,KEY2=VALUE2，並以逗號分隔變數名稱和值。

如要更新現有多區域服務的環境變數，請使用 gcloud beta run multi-region-services update 指令。

控制台

1. 前往 Google Cloud 控制台的 Cloud Run：

   前往 Cloud Run

2. 按一下感興趣的服務，開啟「服務詳細資料」頁面。

3. 按一下「Revisions」(修訂版本) 分頁標籤。

4. 在右側的詳細資料面板中，環境變數設定會列在「Container」(容器) 分頁下方。

gcloud

1. 使用下列指令：

   gcloud run services describe SERVICE

2. 在傳回的設定中找出環境變數設定。

主控台

如要使用 Google Cloud 控制台刪除環境變數，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的 Cloud Run：

   前往 Cloud Run

2. 從清單中選取服務，然後按一下「Edit and deploy new revision」(編輯及部署新版本)。

3. 按一下「容器」分頁標籤。

4. 在「Variables and secrets」(變數與密鑰) 分頁標籤中，將游標移至要移除的環境變數「Value」(值) 欄位左側，顯示「Delete」(刪除) delete 圖示，然後按一下該圖示。

5. 按一下 [完成]。

6. 按一下 [Deploy] (部署)。

gcloud

如要選擇性移除現有服務的環境變數，請使用 --remove-env-vars 旗標：

gcloud run services update SERVICE --remove-env-vars KEY1,KEY2

取代：

• SERVICE 改為您的服務名稱。
• KEY1,KEY2，並以半形逗號分隔變數名稱。

或者，您也可以使用 --clear-env-vars 標記，清除先前設定的所有環境變數：

gcloud run services update SERVICE --clear-env-vars

取代：

• SERVICE 改為您的服務名稱。