Menyetel variabel lingkungan

Pelajari cara membuat dan menggunakan variabel lingkungan dalam inferensi Knative.

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). Misalnya, Anda menjalankan layanan yang mengaktifkan logging tambahan saat membaca LOGGING_VERBOSE: true di lingkungan. Dalam skenario ini, Anda menetapkan key-value pair variabel lingkungan sebagai LOGGING_VERBOSE=true. Perintah atau UI yang tepat ditampilkan di bagian berikut.

Perhatian: Anda tidak boleh menggunakan variabel lingkungan untuk menyimpan dan menggunakan informasi sensitif karena variabel lingkungan disimpan sebagai teks dan dapat diakses oleh cluster. Gunakan Secrets untuk informasi sensitif.

Nama yang digunakan sistem

Variabel lingkungan yang didefinisikan di dalam container runtime contract terkategorikan sebagai "dilindungi" dan tidak boleh diubah. Secara khusus, variabel lingkungan PORT dimasukkan ke dalam container Anda oleh inferensi Knative. Anda tidak boleh mengaturnya sendiri.

Menetapkan variabel lingkungan pada layanan

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

Anda dapat menetapkan variabel lingkungan menggunakan Konsol Google Cloud, Google Cloud CLI, atau file YAML saat men-deploy layanan baru atau memperbarui layanan yang ada dan men-deploy revisi:

Konsol

1. Buka penayangan Knative di konsol Google Cloud:

   Buka penayangan Knative

2. Klik Buat Layanan jika Anda mengonfigurasi layanan baru yang akan di-deploy. Jika Anda mengonfigurasi layanan yang ada, klik layanan, lalu klik Edit & Deploy New revision.

3. Di bagian Setelan lanjutan, klik Variabel dan Rahasia.

4. Lakukan tindakan 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 ingin 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 Berikutnya untuk melanjutkan ke bagian berikutnya.

6. Di bagian Configure bagaimana layanan ini dipicu, pilih konektivitas yang ingin Anda gunakan untuk memanggil layanan.

7. Klik Create untuk men-deploy image ke penayangan Knative dan tunggu hingga deployment selesai.

Command line

Anda dapat menggunakan Google Cloud CLI untuk menetapkan variabel lingkungan untuk layanan baru atau memperbarui layanan yang sudah ada:

• Untuk layanan yang ada, perbarui variabel lingkungan dengan menjalankan perintah gcloud run services update dengan salah satu parameter berikut:

  • --set-env-vars
  Perhatian: --set-env-vars mengonfigurasi ulang semua variabel lingkungan sehingga hanya variabel lingkungan yang ditentukan yang ditetapkan dan tetap dipertahankan. Semua variabel lingkungan lain yang sudah ada sebelumnya akan dihapus jika tidak ditentukan secara eksplisit.
  
  Gunakan --update-env-vars hanya untuk menambahkan atau mengubah variabel lingkungan yang ada dan menghindari penghapusan semua variabel lingkungan yang ada.
  • --update-env-vars
  • --remove-env-vars
  • --clear-env-vars

  Contoh:

  gcloud run services update SERVICE --update-env-vars KEY1=VALUE1,KEY2=VALUE2
  

  Ganti:

  • SERVICE dengan nama layanan Anda.
  • KEY1=VALUE1,KEY2=VALUE2 dengan daftar pasangan nama dan nilai yang dipisahkan koma untuk setiap variabel lingkungan. Tentukan nama variabel lingkungan untuk setiap KEY dan nilai variabel lingkungan tersebut untuk VALUE. Cara menentukan beberapa parameter.

  Opsi parameter perintah

  • Untuk menentukan variabel lingkungan yang berisi koma (,), Anda harus escape setiap KEY=VALUE dengan pembatas yang berbeda. Misalnya, jika Anda menggunakan @:

    --set-env-vars "^@^KEY1=value,with,commas@KEY2=anothervalue@KEY3..."
    

  • Untuk menentukan beberapa kumpulan key-value pair, Anda dapat menentukan beberapa parameter agar mudah dibaca. Contoh:

    [...]
    --set-env-vars "KEY=VALUE1" \
    --set-env-vars "KEY=VALUE2" \
    --set-env-vars "KEY=VALUE3"
    

  Oke

• Untuk layanan baru, tetapkan variabel lingkungan dengan menjalankan perintah gcloud run deploy dengan parameter --set-env-vars:

  gcloud run deploy SERVICE --image=IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2
  

  Ganti:

  • IMAGE_URL dengan mereferensikan ke image container, misalnya, gcr.io/cloudrun/hello.
  • SERVICE dengan nama layanan Anda.
  • KEY1=VALUE1,KEY2=VALUE2 dengan daftar pasangan nama dan nilai yang dipisahkan koma untuk setiap variabel lingkungan. Tentukan nama variabel lingkungan untuk setiap KEY dan nilai variabel lingkungan tersebut untuk VALUE. Cara menentukan beberapa parameter.

  Opsi parameter perintah

  • Untuk menentukan variabel lingkungan yang berisi koma (,), Anda harus escape setiap KEY=VALUE dengan pembatas yang berbeda. Misalnya, jika Anda menggunakan @:

    --set-env-vars "^@^KEY1=value,with,commas@KEY2=anothervalue@KEY3..."
    

  • Untuk menentukan beberapa kumpulan key-value pair, Anda dapat menentukan beberapa parameter agar mudah dibaca. Contoh:

    [...]
    --set-env-vars "KEY=VALUE1" \
    --set-env-vars "KEY=VALUE2" \
    --set-env-vars "KEY=VALUE3"
    

  Oke

YAML

Perhatian: Men-deploy perubahan konfigurasi menggunakan file YAML akan mengganti konfigurasi layanan yang ada. Karena file YAML sepenuhnya menimpa semua konfigurasi, Anda harus menghindari penggunaan beberapa metode untuk mengubah layanan. Misalnya, jangan gunakan file YAML bersama dengan konsol Google Cloud atau perintah gcloud.

Anda dapat mendownload konfigurasi layanan yang ada ke dalam file YAML menggunakan perintah gcloud run services describe menggunakan flag --format=export. Anda kemudian dapat memodifikasi file YAML dan men-deploy perubahan tersebut dengan perintah gcloud run services replace. Anda harus memastikan bahwa Anda hanya mengubah atribut yang ditentukan.

1. Download konfigurasi layanan Anda ke file bernama service.yaml di ruang kerja lokal:

   gcloud run services describe SERVICE --format export > service.yaml

   Ganti SERVICE dengan nama layanan penayangan Knative Anda.

2. Di file lokal Anda, perbarui atribut name dan value pada atribut env di bagian containers::

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       spec:
         containers:
         - env:
           - name: KEY-1
             value: VALUE-1
           - name: KEY-N
             value: VALUE-N

   Ganti

   • SERVICE dengan nama layanan penayangan Knative Anda
   • KEY-1, VALUE-1 dengan nama variabel lingkungan dan nilainya. Secara opsional tambahkan variabel dan nilai lainnya sesuai yang diinginkan.

3. Ganti layanan dengan konfigurasi baru menggunakan perintah berikut:

   gcloud run services replace service.yaml

Menetapkan variabel lingkungan default dalam penampung

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

ENV KEY1=VALUE1,KEY2=VALUE2

Urutan prioritas: variabel container vs layanan

Jika Anda menetapkan variabel lingkungan default dalam penampung dan juga menetapkan variabel lingkungan dengan nama yang sama pada layanan penayangan Knative, nilai yang ditetapkan pada layanan akan lebih diutamakan.

Mengaktifkan link layanan Kubernetes

Untuk menggunakan link layanan Kubernetes, Anda harus mengaktifkan dukungan secara manual. Karena masalah performa yang terlihat di namespace dengan ribuan layanan dan revisi, link layanan Kubernetes dinonaktifkan secara default mulai Januari 2021.

Penting: Informasi tentang setiap layanan Anda dimasukkan ke dalam variabel lingkungan pod saat Anda mengaktifkan link layanan Kubernetes. Dalam namespace yang berisi lebih dari 1.000 layanan atau revisi penayangan Knative, Anda mungkin mengalami masalah performa atau bahkan kegagalan layanan.

Untuk mengaktifkan link layanan Kubernetes, jalankan perintah berikut untuk menetapkan data.enable-service-links ke true di knative-serving/config-defaults ConfigMap:

kubectl patch cm -n knative-serving config-defaults -p '{"data":{"enable-service-links":"true"}}