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 pasangan nilai kunci yang memungkinkan Anda meneruskan konfigurasi informasi 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 menyetel variabel lingkungan build yang tersedia di waktu build, dan relevan untuk developer platform yang men-deploy fungsi-fungsi lainnya di Cloud Run.

Sebelum memulai

Aktifkan Cloud Build API:

gcloud services enable cloudbuild.googleapis.com

Peran yang diperlukan

Untuk mendapatkan izin yang Anda butuhkan untuk men-deploy dari sumber, minta administrator untuk memberi Anda peran IAM berikut pada 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 antarmuka layanan Cloud Run Anda 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 menyetel variabel lingkungan build untuk menetapkan variabel baru atau sepenuhnya mengganti variabel build yang ada.

Catatan: Kunci harus diawali dengan huruf ASCII kapital, dan terdiri dari huruf besar Huruf ASCII, angka, dan garis bawah. Sebaiknya hindari 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 Cloud Run Anda fungsi tersebut.
• FUNCTION_ENTRY_POINT dengan titik entri ke fungsi Anda di kode sumber Anda.
• KEY1=VALUE1,KEY2=VALUE2 dengan daftar yang dipisahkan koma, nama variabel dan nilainya yang di-deploy bersama fungsi yang memungkinkan Anda meneruskan informasi konfigurasi ke buildpack.

Mengupdate variabel lingkungan build

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

gcloud

Untuk mengupdate 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 bisa menghapus variabel lingkungan build menggunakan --clear-build-env-vars untuk fungsi yang sudah 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 tempat isi file terlihat sebagai berikut:

 KEY1: VALUE1
 KEY2: VALUE2