Halaman ini diterjemahkan oleh Cloud Translation API.

Menetapkan variabel lingkungan build (deploy sumber)

Variabel lingkungan build adalah key-value pair yang memungkinkan Anda meneruskan informasi konfigurasi ke buildpack saat men-deploy 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 layanan atau fungsi Cloud Run dari sumber. Flag gcloud CLI variabel lingkungan build didukung untuk deployment sumber (--source), dan tidak didukung untuk deployment image penampung (--image).

Sebelum memulai

Aktifkan Cloud Run Admin API dan Cloud Build API:
```
gcloud services enable run.googleapis.com \
    cloudbuild.googleapis.com
```
Setelah Cloud Run Admin API diaktifkan, akun layanan default Compute Engine akan otomatis dibuat.

Peran yang diperlukan

Anda atau administrator harus memberikan peran IAM berikut ke akun deployer dan akun layanan Cloud Build.

Klik untuk melihat peran yang diperlukan untuk akun deployer

Untuk mendapatkan izin yang diperlukan untuk mem-build dan men-deploy dari sumber, minta administrator untuk memberi Anda peran IAM berikut:

Cloud Run Source Developer (roles/run.sourceDeveloper) di project Anda
Service Account User (roles/iam.serviceAccountUser) di identitas layanan Cloud Run

Klik untuk melihat peran yang diperlukan untuk akun layanan Cloud Build

Cloud Build secara otomatis menggunakan akun layanan default Compute Engine sebagai akun layanan Cloud Build default untuk mem-build kode sumber dan resource Cloud Run, kecuali jika Anda mengganti perilaku ini. Agar Cloud Build dapat mem-build sumber, minta administrator untuk memberikan Cloud Run Builder (roles/run.builder) ke akun layanan default Compute Engine di project Anda:

  gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
      --role=roles/run.builder

Ganti PROJECT_NUMBER dengan nomor project Google Cloud, dan PROJECT_ID dengan project ID Google Cloud. Untuk mengetahui petunjuk mendetail tentang cara menemukan project ID dan nomor project, lihat Membuat dan mengelola project.

Pemberian peran builder Cloud Run ke akun layanan default Compute Engine memerlukan waktu beberapa menit untuk disebarkan.

Catatan:

Batasan kebijakan organisasi iam.automaticIamGrantsForDefaultServiceAccounts mencegah peran Editor diberikan secara otomatis ke akun layanan default. Jika Anda membuat organisasi setelah 3 Mei 2024, batasan ini akan diterapkan secara default.

Sebaiknya terapkan batasan ini untuk menonaktifkan pemberian peran otomatis. Jika Anda menonaktifkan pemberian peran otomatis, Anda harus menentukan peran mana yang akan diberikan ke akun layanan default, lalu memberikan peran ini secara manual.

Jika akun layanan default sudah memiliki peran Editor, sebaiknya ganti peran Editor dengan peran yang kurang permisif.Untuk mengubah peran akun layanan dengan aman, gunakan Policy Simulator untuk melihat dampak perubahan, lalu berikan dan cabut peran yang sesuai.

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.

gcloud

Untuk menetapkan variabel lingkungan build saat men-deploy layanan dari kode sumber, gunakan flag --set-build-env-vars:

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

Ganti:

SERVICE dengan nama layanan Cloud Run Anda.
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.

Jika Anda men-deploy fungsi, tambahkan flag --function dengan titik masuk fungsi dari kode sumber Anda.

Memperbarui variabel lingkungan build

Anda dapat memperbarui variabel lingkungan build untuk layanan 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 layanan yang ada, gunakan flag --update-build-env-vars:

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

Jika Anda men-deploy fungsi, tambahkan flag --function dengan titik masuk fungsi dari kode sumber Anda.

Menghapus variabel lingkungan build

Anda dapat menghapus variabel lingkungan build untuk layanan yang ada.

gcloud

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

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

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

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

Jika Anda men-deploy fungsi, tambahkan flag --function dengan titik masuk fungsi dari kode sumber Anda.

Menggunakan file variabel lingkungan build

Anda dapat menggunakan file variabel lingkungan build untuk fungsi yang ada.

gcloud

Untuk menetapkan variabel lingkungan build dari file, gunakan flag --build-env-vars-file:

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

Ganti FILE_NAME.yaml dengan konten file, yang akan terlihat seperti berikut:

 KEY1: VALUE1
 KEY2: VALUE2

Jika Anda men-deploy fungsi, tambahkan flag --function dengan titik masuk fungsi dari kode sumber Anda.