Mengonfigurasi variabel lingkungan

Saat Anda menetapkan variabel lingkungan (environment variable), variabel tersebut dimasukkan ke dalam container dan dapat diakses oleh kode Anda. Variabel lingkungan ditetapkan dalam format pasangan kunci/nilai (key/value).

Perhatian: Anda sebaiknya tidak menggunakan variabel lingkungan untuk menyimpan dan mengakses informasi rahasia, karena variabel lingkungan dapat terlihat oleh siapa saja yang memiliki izin Project Viewer atau yang lebih tinggi. Sebagai gantinya, gunakan Secret Manager dengan Cloud Run seperti yang dijelaskan di halaman tentang Mengelola informasi rahasia.

Nama yang dilindungi

Variabel lingkungan yang didefinisikan di dalam container runtime contract terkategorikan sebagai "dilindungi" dan tidak boleh diubah. Secara khusus, Cloud Run akan memasukkan variabel lingkungan PORT ke dalam container Anda. Anda sebaiknya tidak mengaturnya sendiri.

Menetapkan variabel lingkungan

Untuk menetapkan variabel lingkungan untuk tugas Cloud Run:

Konsol

1. Pada konsol Google Cloud, buka halaman tugas Cloud Run:

   Buka Cloud Run

2. Jika Anda sedang mengonfigurasi tugas baru, klik tabTugas dan isi halaman setelan tugas awal seperti yang diinginkan. Jika Anda sedang mengonfigurasi tugas yang sudah ada, klik tugas tersebut, lalu klikEdit.

3. Klik Container, variabel dan rahasia, koneksi keamanan untuk memperluas halaman properti tugas.

4. Klik tab Variabel.

   

   • Lakukan hal berikut:
     • Jika Anda ingin menambahkan variabel, klik Add Variable, dan tentukan nama dan nilai yang Anda inginkan untuk variabel tersebut pada kotak teks Nama dan Nilai.
     • Jika Anda ingin mengubah nilai dari sebuah variabel, maka ganti nilai yang ada di kotak teks Nilai dengan nilai yang Anda inginkan.
     • Jika Anda menghapus satu atau beberapa variabel lingkungan, arahkan kursor Anda ke sebelah kiri kotak teks Nilai dari variabel yang sedang Anda hapus untuk menampilkan ikon Sampah, lalu klik ikon tersebut.

5. Klik Buat atau Perbarui.

Command line

Tetapkan, perbarui, atau hapus variabel lingkungan dari layanan yang sudah ada, menggunakan perintah pembaruan tugas gcloud run . Anda dapat menggunakan salah satu tanda berikut, sesuai yang dibutuhkan:

• --set-env-vars
• --update-env-vars
• --remove-env-vars

• --clear-env-vars

  Anda dapat menentukan variabel lingkungan selagi membuat tugas atau saat memperbarui tugas:

  gcloud run jobs create JOB_NAME --image IMAGE_URL --update-env-vars KEY1=VALUE1,KEY2=VALUE2
  
  gcloud run jobs update JOB_NAME --update-env-vars KEY1=VALUE1,KEY2=VALUE2

• Ganti JOB_NAME dengan nama dari tugas Anda.

• Ganti KEY1=VALUE1,KEY2=VALUE2, dengan daftar nama variabel yang diinginkan beserta nilainya, yang dipisahkan koma.

• Ganti IMAGE_URL dengan referensi ke image container, misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.

YAML

Download dan lihat konfigurasi job yang ada menggunakan perintah gcloud run jobs describe --format export, yang akan memberikan hasil yang dibersihkan dalam format YAML. Kemudian ubah kolom yang dijelaskan di bawah ini dan upload YAML yang telah dimodifikasi menggunakan perintah gcloud run jobs replace. Pastikan Anda hanya mengubah kolom seperti yang didokumentasikan.

1. Untuk melihat dan mendownload konfigurasi:

   gcloud run jobs describe JOB_NAME --format export > job.yaml

2. 1. Update atribut name dan value di bawah env seperti yang ditunjukkan di bawah containers::

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     name: JOB
   spec:
     template:
       spec:
         template:
           spec:
             containers:
             - image: IMAGE
               env:
               - name: KEY-1
                 value: VALUE-1
               - name: KEY-N
                 value: VALUE-N

   Ganti KEY-1, VALUE-1 dengan variabel lingkungan dan nilai. Secara opsional tambahkan variabel dan nilai lainnya sesuai yang diinginkan.

   Anda juga dapat menentukan konfigurasi lainnya seperti variabel lingkungan atau batas memori.

3. Perbarui konfigurasi tugas yang ada:

   gcloud run jobs replace job.yaml

Tetapkan beberapa variabel lingkungan

Jika Anda memiliki terlalu banyak variabel lingkungan yang tidak dapat dicantumkan dengan mudah dalam format KEY1=VALUE1,KEY2=VALUE2, secara alternatif Anda dapat menambahkan flag yang tercantum di atas 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 antar variabel lingkungan, jika variabel lingkungan Anda mengandung karakter koma sebagai nilai, Anda perlu meng-escape karakter pemisah tersebut dengan menentukan "karakter pemisah khusus", contohnya, @:

--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."

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: container vs layanan ataupun variabel tugas

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

Lihat setelan variabel lingkungan

Untuk melihat setelan variabel lingkungan saat ini untuk tugas Cloud Run Anda:

Konsol

1. Pada konsol Google Cloud, buka halaman tugas Cloud Run.

   Buka tugas Cloud Run

2. Klik tugas yang Anda minati untuk membuka halaman Detail pekerjaan.

3. Klik tab Configuration.

4. Temukan setelan variabel lingkungan di detail konfigurasi.

Command line

1. Gunakan perintah berikut:

   gcloud run jobs describe JOB_NAME

2. Temukan setelan variabel lingkungan di konfigurasi yang ditampilkan.