サービスの環境変数を構成する

コンソール

1. Google Cloud コンソールで Cloud Run に移動します。

   Cloud Run に移動

2. メニューから [サービス] を選択し、[コンテナをデプロイ] をクリックして新しいサービスを構成します。既存のサービスを構成する場合は、サービスをクリックし、[新しいリビジョンの編集とデプロイ] をクリックします。

3. 新しいサービスを構成する場合は、最初のサービス設定のページに入力してから、[コンテナ、ボリューム、ネットワーキング、セキュリティ] をクリックしてサービス構成ページを開きます。

4. [コンテナ] タブをクリックします。

   

   • [変数を追加] をクリックして新しい変数を追加し、[名前] フィールドと [値] フィールドに変数名と値を指定します。

5. [作成] または [デプロイ] をクリックします。

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 がすでに作成されている必要があります。URL の形式は 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 がすでに作成されている必要があります。URL の形式は 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. リストからサービスを選択し、[新しいリビジョンの編集とデプロイ] をクリックします。

3. [コンテナ] タブをクリックします。

4. [変数とシークレット] タブで、[名前] フィールドまたは [値] フィールドを編集し、[完了] をクリックします。

5. [デプロイ] をクリックします。

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. [変更内容] タブをクリックします。

4. 右側の詳細パネルの [コンテナ] タブに、環境変数の設定が表示されます。

gcloud

1. 次のコマンドを使用します。

   gcloud run services describe SERVICE

2. 返された構成で、環境変数の設定を見つけます。

コンソール

Google Cloud コンソールを使用して環境変数を削除するには:

1. Google Cloud コンソールで Cloud Run に移動します。

   Cloud Run に移動

2. リストからサービスを選択し、[新しいリビジョンの編集とデプロイ] をクリックします。

3. [コンテナ] タブをクリックします。

4. [変数とシークレット] タブで、削除する環境変数の [値] フィールドの左側にカーソルを移動して delete [削除] アイコンを表示させ、クリックします。

5. [完了] をクリックします。

6. [デプロイ] をクリックします。

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: 実際のサービスの名前。