Menetapkan variabel lingkungan build (deploy sumber)

Pratinjau — Build configuration flags for Cloud Run functions

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Variabel lingkungan build adalah key-value pair yang memungkinkan Anda meneruskan informasi konfigurasi ke buildpacks saat men-deploy fungsi dari kode sumber. Misalnya, pada waktu build, Anda mungkin ingin menyesuaikan opsi compiler, menentukan sertifikat waktu build, mengonfigurasi parameter, dan sebagainya.

Halaman ini menunjukkan cara menetapkan variabel lingkungan build yang tersedia pada waktu build, dan relevan bagi developer platform yang men-deploy fungsi di Cloud Run.

Sebelum memulai

Aktifkan Cloud Build API:

gcloud services enable cloudbuild.googleapis.com

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk men-deploy dari sumber, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

• Cloud Run Source Developer (roles/run.sourceDeveloper)
• Service Account User (roles/iam.serviceAccountUser)

Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat peran IAM Cloud Run dan izin IAM Cloud Run. Jika layanan Cloud Run Anda berinteraksi dengan Google Cloud API, seperti Library Klien Cloud, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat izin deployment dan mengelola akses.

Menetapkan variabel lingkungan build

Anda dapat menetapkan variabel lingkungan build untuk menetapkan variabel baru atau sepenuhnya mengganti variabel build yang ada.

Catatan: Kunci harus diawali dengan huruf ASCII besar, dan terdiri dari huruf ASCII besar, angka, dan garis bawah. Sebaiknya jangan membuat kunci variabel dengan awalan GOOGLE_*. Lihat semua variabel lingkungan buildpack yang didukung.

gcloud

Anda dapat menetapkan variabel lingkungan build saat men-deploy fungsi dari kode sumber:

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

Ganti:

• SERVICE dengan nama fungsi Cloud Run Anda.
• FUNCTION_ENTRY_POINT dengan titik entri ke fungsi Anda dalam kode sumber.
• KEY1=VALUE1,KEY2=VALUE2 dengan daftar nama variabel yang dipisahkan koma dan nilainya yang di-deploy bersama fungsi yang memungkinkan Anda meneruskan informasi konfigurasi ke buildpack.

Memperbarui variabel lingkungan build

Anda dapat memperbarui variabel lingkungan build untuk fungsi yang ada. Ini adalah pendekatan non-destruktif yang mengubah atau menambahkan variabel lingkungan build, tetapi tidak menghapus variabel lingkungan build.

gcloud

Untuk memperbarui variabel lingkungan build untuk fungsi yang ada:

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

Menghapus variabel lingkungan build

Anda dapat menghapus variabel lingkungan build untuk fungsi yang ada.

gcloud

Untuk menghapus variabel lingkungan build, gunakan --remove-build-env-vars untuk fungsi yang ada:

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

Atau, Anda dapat menghapus variabel lingkungan build menggunakan --clear-build-env-vars untuk fungsi yang ada:

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

File variabel lingkungan build

Anda menggunakan file variabel lingkungan build untuk fungsi yang ada.

gcloud

Untuk menetapkan variabel lingkungan build dari file:

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

Ganti FILE_NAME.yaml dengan konten file yang terlihat sebagai berikut:

 KEY1: VALUE1
 KEY2: VALUE2