Mengonfigurasi variabel lingkungan untuk gabungan worker

Halaman ini menjelaskan cara mengonfigurasi variabel lingkungan untuk kumpulan pekerja Cloud Run.

Setiap perubahan konfigurasi akan menghasilkan revisi baru. Revisi selanjutnya juga akan otomatis mendapatkan setelan konfigurasi ini, kecuali jika Anda melakukan pembaruan eksplisit untuk mengubahnya.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengonfigurasi dan men-deploy kumpulan pekerja Cloud Run, minta administrator Anda untuk memberi Anda peran IAM berikut:

Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat Peran IAM Cloud Run dan Izin IAM Cloud Run. Jika kumpulan pekerja 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

Anda dapat menetapkan variabel lingkungan untuk kumpulan pekerja Cloud Run menggunakan Google Cloud konsol, Google Cloud CLI, atau Terraform:

Konsol

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pools dari menu, lalu klik Deploy container untuk mengonfigurasi worker pool baru. Jika Anda mengonfigurasi pool worker yang sudah ada, klik pool worker, lalu klik Edit dan deploy revisi baru.

  3. Jika Anda mengonfigurasi kumpulan pekerja baru, isi halaman kumpulan pekerja awal, lalu klik Container, Volume, Jaringan, Keamanan untuk meluaskan halaman konfigurasi kumpulan pekerja.

  4. Klik tab Container.

    gambar

    • Di tab Variables & Secrets, klik Add Variable untuk menambahkan variabel lingkungan baru, lalu tentukan nama yang Anda inginkan untuk variabel tersebut di kolom Name dan Value. Untuk mengetahui informasi selengkapnya tentang cara menetapkan beberapa variabel lingkungan atau menghindari karakter khusus, lihat Menetapkan beberapa variabel lingkungan.

  5. Klik Buat atau Deploy.

gcloud

Untuk menentukan variabel lingkungan saat men-deploy kumpulan pekerja, gunakan flag --set-env-vars:

gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2

Ganti kode berikut:

  • WORKER_POOL: nama worker pool Anda
  • KEY1=VALUE1,KEY2=VALUE2: daftar nama dan nilai variabel yang dipisahkan koma
  • IMAGE_URL: referensi ke image container yang berisi kumpulan pekerja, seperti us-docker.pkg.dev/cloudrun/container/worker-pool:latest

Untuk mengetahui informasi selengkapnya tentang cara menetapkan beberapa variabel lingkungan atau menghindari karakter khusus, lihat Menetapkan beberapa variabel lingkungan.

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      image = "IMAGE_URL"
      env {
        name  = "KEY1"
        value = "VALUE1"
      }
      env {
        name  = "KEY2"
        value = "VALUE2"
      }
    }
  }
}

Ganti kode berikut:

  • WORKER_POOL: nama pool pekerja.
  • REGION: region Google Cloud —misalnya, europe-west1
  • IMAGE_URL: referensi ke image container yang berisi kumpulan pekerja, seperti us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • KEY1 dan VALUE1: variabel lingkungan dan nilai. Secara opsional, tambahkan variabel dan nilai lainnya sesuai kebutuhan.

Menetapkan variabel lingkungan default dalam container

Anda dapat menggunakan statement ENV dalam Dockerfile untuk menetapkan nilai default dari variabel lingkungan:

ENV KEY1=VALUE1,KEY2=VALUE2

Urutan prioritas: variabel container versus kumpulan pekerja

Jika Anda menetapkan variabel lingkungan default di dalam container dan juga menetapkan variabel lingkungan dengan nama yang sama pada worker pool Cloud Run, maka nilai yang ditetapkan pada worker pool akan diutamakan.

Menetapkan beberapa variabel lingkungan

Anda dapat menetapkan beberapa variabel lingkungan menggunakan file .env atau flag --set-env-vars.

Menetapkan beberapa variabel lingkungan menggunakan file .env

Konsol

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pools dari menu, lalu klik Deploy container untuk mengonfigurasi worker pool baru. Jika Anda mengonfigurasi pool worker yang sudah ada, klik pool worker, lalu klik Edit dan deploy revisi baru.

  3. Jika Anda mengonfigurasi kumpulan pekerja baru, isi halaman kumpulan pekerja awal, lalu klik Container, Volume, Jaringan, Keamanan untuk meluaskan halaman konfigurasi kumpulan pekerja.

  4. Klik tab Container.

    gambar

    • Di tab Variables & Secrets, klik Add Variable, lalu tempelkan konten file .env Anda ke kolom Name. Cloud Run akan otomatis mengisi kolom Nilai dan membuat variabel baru untuk setiap pasangan nilai kunci yang Anda tentukan dalam file .env.

  5. Klik Buat atau Deploy.

gcloud

Untuk menentukan beberapa variabel lingkungan dari file .env, jalankan perintah berikut:

gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE_URL --env-vars-file=ENV_FILE_PATH

Ganti kode berikut:

  • WORKER_POOL: nama pool pekerja.
  • IMAGE_URL: referensi ke image container yang berisi kumpulan pekerja, seperti us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • ENV_FILE_PATH: jalur ke file .env.

Menetapkan beberapa variabel lingkungan menggunakan flag --set-env-vars

Jika Anda memiliki beberapa variabel lingkungan yang tidak dapat dicantumkan dalam format KEY1=VALUE1,KEY2=VALUE2, Anda dapat mengulangi flag --set-env-vars beberapa kali: 
   [...]
   --set-env-vars "KEY1=VALUE1" \
   --set-env-vars "KEY2=VALUE2" \
   --set-env-vars "KEY3=VALUE3"

Escape karakter koma

Karena karakter koma , digunakan untuk memisahkan variabel lingkungan, jika variabel lingkungan Anda mengandung karakter koma sebagai nilai, Anda perlu meng-escape karakter pemisah tersebut dengan menentukan karakter pemisah yang berbeda, misalnya, @: 
--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."

Memperbarui variabel lingkungan

Anda dapat memperbarui variabel lingkungan runtime untuk kumpulan worker yang ada. Ini adalah pendekatan non-destruktif yang mengubah atau menambahkan variabel lingkungan runtime, tetapi tidak menghapusnya.

Anda dapat memperbarui variabel lingkungan di Google Cloud konsol, Google Cloud CLI, atau Terraform:

Konsol

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pools dari menu, lalu klik worker pool yang Anda perbarui, kemudian klik Edit and deploy new revision.

  3. Klik Container(s), Volume, Jaringan, Keamanan untuk meluaskan halaman konfigurasi kumpulan pekerja.

  4. Klik tab Variabel & Secret.

    gambar

  5. Temukan variabel lingkungan yang ingin Anda perbarui, lalu tentukan nama yang berbeda untuk variabel, atau nilai yang berbeda di kolom Nama dan Nilai.

  6. Klik Deploy.

gcloud

Untuk memperbarui variabel lingkungan worker pool yang ada, gunakan flag --update-env-vars:

gcloud beta run worker-pools update WORKER_POOL --update-env-vars KEY1=VALUE1,KEY2=VALUE2

Ganti kode berikut:

  • WORKER_POOL: nama worker pool Anda
  • KEY1=VALUE1,KEY2=VALUE2: daftar nama dan nilai variabel yang dipisahkan koma

Terraform

Untuk memperbarui variabel lingkungan dari kumpulan pekerja yang ada, buka file main.tf yang sesuai dengan kumpulan pekerja dan edit variabel nama dan nilai. Kemudian, jalankan perintah untuk menerapkan konfigurasi Terraform.

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

Menghapus variabel lingkungan

Konsol

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pools dari menu, lalu klik worker pool yang Anda perbarui, kemudian klik Edit and deploy new revision.

  3. Klik Container(s), Volume, Jaringan, Keamanan untuk meluaskan halaman konfigurasi kumpulan pekerja.

  4. Klik tab Variabel & Secret.

    gambar

  5. Cari variabel lingkungan yang ingin Anda hapus, lalu klik ikon sampah di sebelah kanan kolom Nilai untuk menghapus variabel lingkungan tersebut.

  6. Klik Deploy.

gcloud

Untuk menghapus variabel lingkungan secara selektif dari kumpulan pekerja yang ada, gunakan flag --remove-env-vars:

gcloud beta run worker-pools update WORKER_POOL --remove-env-vars KEY1,KEY2

Ganti kode berikut:

  • WORKER_POOL: nama worker pool Anda
  • KEY1,KEY2: daftar nama variabel yang dipisahkan koma

Atau, hapus semua variabel lingkungan yang ditetapkan sebelumnya dengan flag --clear-env-vars:

gcloud beta run worker-pools update WORKER_POOL --clear-env-vars

Ganti WORKER_POOL dengan nama kumpulan pekerja Anda.

Melihat konfigurasi variabel lingkungan untuk kumpulan pekerja

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Klik Worker pools untuk menampilkan daftar worker pool yang di-deploy.

  3. Klik kumpulan pekerja yang ingin Anda periksa untuk menampilkan panel detailnya.

  4. Klik tab Containers untuk menampilkan konfigurasi container kumpulan pekerja.

Kode contoh

Untuk mengetahui contoh kode yang menunjukkan cara mengakses variabel lingkungan dalam kode Anda, lihat Menangani konfigurasi sensitif dengan Secret Manager di tutorial Autentikasi pengguna akhir.

Langkah berikutnya

Anda dapat menggunakan variabel lingkungan untuk menetapkan konfigurasi buildpack. Untuk mengetahui detail dalam bahasa tertentu, lihat dokumentasi buildpack untuk: