Mengonfigurasi variabel lingkungan untuk instance

Halaman ini menjelaskan cara mengonfigurasi variabel lingkungan untuk instance Cloud Run.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengonfigurasi dan men-deploy instance 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 instance 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 instance Cloud Run menggunakan Google Cloud CLI atau YAML:

gcloud

Untuk menentukan variabel lingkungan saat membuat instance, gunakan tanda --set-env-vars:

gcloud beta run instances create INSTANCE --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2

Ganti kode berikut:

  • INSTANCE: nama instance Anda
  • IMAGE_URL: referensi ke image container, seperti us-docker.pkg.dev/cloudrun/container/hello:latest.
  • KEY1=VALUE1,KEY2=VALUE2: daftar nama dan nilai variabel yang dipisahkan koma

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

YAML

  1. Jika Anda membuat instance baru, lewati langkah ini. Jika Anda mengupdate instance yang ada, download konfigurasi YAML-nya:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. Contoh berikut berisi konfigurasi YAML:

    apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
spec:
  containers:
  - env:
    - name: KEY
      value: VALUE
    - name: KEY2
      value: VALUE2
    image: IMAGE

    Ganti kode berikut:

    • INSTANCE: nama instance Cloud Run Anda.
    • KEY dan VALUE: nama dan nilai variabel lingkungan.
    • IMAGE_URL: referensi ke image container, seperti us-docker.pkg.dev/cloudrun/container/hello:latest.

  3. Buat atau perbarui instance menggunakan perintah berikut:

    gcloud beta run instances replace instance.yaml

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 instance

Jika Anda menetapkan variabel lingkungan default di dalam container dan juga menetapkan variabel lingkungan dengan nama yang sama pada instance Cloud Run, maka nilai yang ditetapkan pada instance 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

gcloud

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

gcloud beta run instances create INSTANCE --image IMAGE_URL --env-vars-file=ENV_FILE_PATH

Ganti kode berikut:

  • INSTANCE: nama instance.
  • IMAGE_URL: referensi ke image container, seperti us-docker.pkg.dev/cloudrun/container/hello: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 instance yang ada. Ini adalah pendekatan non-destruktif yang mengubah atau menambahkan variabel lingkungan runtime, tetapi tidak menghapusnya.

Anda dapat memperbarui variabel lingkungan menggunakan Google Cloud CLI atau YAML:

gcloud

Untuk mengupdate variabel lingkungan instance yang ada, gunakan tanda --update-env-vars:

gcloud beta run instances update INSTANCE --update-env-vars KEY1=VALUE1,KEY2=VALUE2

Ganti kode berikut:

  • INSTANCE: nama instance Anda
  • KEY1=VALUE1,KEY2=VALUE2: daftar nama dan nilai variabel yang dipisahkan koma

YAML

  1. Download konfigurasi YAML instance:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. Edit variabel kunci (nama) dan nilai.

  3. Perbarui instance menggunakan perintah berikut:

    gcloud beta run instances replace instance.yaml

Menghapus variabel lingkungan

gcloud

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

gcloud beta run instances update INSTANCE --remove-env-vars KEY1,KEY2

Ganti kode berikut:

  • INSTANCE: nama instance 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 instances update INSTANCE --clear-env-vars

Ganti INSTANCE dengan nama instance Anda.

Kode contoh

Untuk mengetahui contoh kode yang menunjukkan cara mengakses variabel lingkungan dalam kode Anda, lihat Menangani konfigurasi sensitif dengan Secret Manager dalam 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: