ビルド環境変数を設定する（ソースデプロイ）

ビルド環境変数は、ソースコードから関数をデプロイするときに、Buildpack に構成情報を渡すことができる Key-Value ペアです。たとえば、ビルド時に、コンパイラ オプションのカスタマイズ、ビルド時の証明書の指定、パラメータの構成などを行いたい場合があります。

このページでは、ビルド時に使用可能なビルド環境変数を設定する方法について説明します。このページは、Cloud Run の関数をデプロイするプラットフォーム デベロッパーを対象としています。

始める前に

Cloud Build API を有効にします。

gcloud services enable cloudbuild.googleapis.com

必要なロール

ソースからデプロイするために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

• Cloud Run ソース デベロッパー（roles/run.sourceDeveloper）
• サービス アカウント ユーザー（roles/iam.serviceAccountUser）

Cloud Run に関連付けられている IAM ロールと権限のリストについては、Cloud Run IAM ロールと Cloud Run IAM 権限をご覧ください。Cloud Run サービスが Google Cloud APIs（Cloud クライアント ライブラリなど）と連携している場合は、サービス ID の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限とアクセスの管理をご覧ください。

ビルド環境変数を設定する

ビルド環境変数を設定すると��������い変数を設定したり、既存のビルド変数を完全に置き換えることができます。

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

ビルド環境変数を更新する

既存の関数のビルド環境変数を更新できます。これは非破壊的なアプローチです。ビルド環境変数の変更または追加は行いますが、ビルド環境変数の削除は行いません。

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

ビルド環境変数を削除する

既存の関数のビルド環境変数を削除できます。

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

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

ビルド環境変数ファイル

既存の関数でビルド環境変数ファイルを使用できます。

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

 KEY1: VALUE1
 KEY2: VALUE2