Mengonfigurasi variabel lingkungan untuk tugas

Halaman ini menjelaskan cara mengonfigurasi variabel lingkungan untuk tugas Cloud Run Anda.

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

Nama yang dilindungi

Variabel lingkungan yang didefinisikan di dalam container runtime contract terkategorikan sebagai "dilindungi" dan tidak boleh diubah.

Jumlah maksimum variabel lingkungan

Perhatikan bahwa Anda dapat menetapkan maksimum 1.000 variabel lingkungan per container untuk setiap tugas Cloud Run.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengonfigurasi tugas Cloud Run, minta administrator Anda untuk memberikan peran IAM berikut pada tugas:

  • Developer Cloud Run (roles/run.developer) - tugas Cloud Run
  • Pengguna Akun Layanan (roles/iam.serviceAccountUser) - identitas layanan

Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat Peran IAM Cloud Run dan Izin IAM Cloud Run. Jika tugas 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 tugas baru dan yang sudah ada. Perhatikan bahwa flag --set-env-vars adalah tindakan destruktif yang menghapus variabel lingkungan yang ditetapkan sebelumnya dan tidak disertakan dalam daftar variabel lingkungan baru.

Anda dapat menetapkan variabel lingkungan menggunakan Google Cloud konsol, gcloud CLI, atau file YAML:

Konsol

  1. Di Google Cloud konsol, buka halaman Tugas Cloud Run:

    Buka Cloud Run

  2. Klik Deploy container untuk mengisi halaman setelan tugas awal. Jika Anda mengonfigurasi tugas yang ada, pilih tugas, lalu klik Lihat dan edit konfigurasi tugas.

  3. Klik Container, Koneksi, Keamanan untuk memperluas halaman properti tugas.

  4. Klik tab Variabel.

    gambar

    • Di tab Variabel &Secret, klik Tambahkan Variabel , lalu tentukan nama dan nilai yang Anda inginkan untuk variabel tersebut di kolom Nama dan Nilai. Untuk mengetahui informasi selengkapnya tentang cara menetapkan beberapa variabel lingkungan atau meng-escape karakter khusus, lihat Menetapkan beberapa variabel lingkungan.

  5. Klik Buat atau Perbarui.

gcloud

Untuk menentukan variabel lingkungan saat Anda membuat tugas, gunakan flag --set-env-vars:

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

Ganti kode berikut:

  • JOB_NAME: nama tugas Anda.
  • KEY1=VALUE1,KEY2=VALUE2: daftar nama variabel dan nilainya yang dipisahkan koma.
  • IMAGE_URL: referensi ke image container—misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.

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

YAML

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

    gcloud run jobs describe JOB_NAME --format export > job.yaml
    1. Update atribut name dan value di bagian env seperti yang ditunjukkan di bagian 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 kebutuhan.

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

  3. Perbarui konfigurasi job yang ada:

    gcloud run jobs replace job.yaml

Terraform

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

Tambahkan kode berikut ke resource google_cloud_run_v2_job di konfigurasi Terraform Anda:
resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
        env {
          name = "KEY-1"
          value = "VALUE-1"
        }
        env {
          name = "KEY-N"
          value = "VALUE-N"
        }
      }
    }
  }
}

Ganti kode berikut:

  • JOB_NAME: nama tugas Cloud Run Anda.
  • REGION: Google Cloud region. Contohnya, europe-west1.
  • KEY-1: variabel lingkungan.
  • VALUE-1: nilai yang terkait dengan kunci.

Secara opsional, tambahkan blok env lainnya untuk menetapkan variabel lingkungan tambahan.

Menetapkan variabel lingkungan default dalam container

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

ENV KEY1=VALUE1,KEY2=VALUE2

Urutan prioritas: container versus variabel tugas

Jika Anda menetapkan variabel lingkungan default di dalam container dan juga menetapkan variabel lingkungan dengan nama yang sama pada tugas Cloud Run, maka nilai yang ditetapkan pada tugas 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 Google Cloud konsol, buka halaman Tugas Cloud Run:

    Buka Cloud Run

  2. Klik Deploy container untuk mengisi halaman setelan tugas awal. Jika Anda mengonfigurasi tugas yang ada, pilih tugas, lalu klik Lihat dan edit konfigurasi tugas.

  3. Klik Container, Koneksi, Keamanan untuk memperluas halaman properti tugas.

  4. Klik tab Container.

    gambar

    • Di tab Variabel &Secret, klik Tambahkan Variabel , lalu tempelkan konten file .env Anda ke kolom Nama. Cloud Run akan otomatis mengisi kolom Nilai dan membuat variabel baru untuk setiap pasangan kunci-nilai yang Anda tentukan dalam file .env.

  5. Klik Buat atau Perbarui.

gcloud

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

gcloud run jobs create JOB_NAME --image=IMAGE_URL --env-vars-file=ENV_FILE_PATH

Ganti kode berikut:

  • JOB_NAME: nama tugas Cloud Run Anda.
  • IMAGE_URL: referensi ke image container—misalnya, us-docker.pkg.dev/cloudrun/container/job: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 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=..."

Memperbarui variabel lingkungan

Anda dapat memperbarui variabel lingkungan untuk tugas yang ada. Ini adalah pendekatan non-destruktif yang mengubah atau menambahkan variabel lingkungan, tetapi tidak menghapus variabel lingkungan yang ditetapkan sebelumnya.

Konsol

Untuk memperbarui variabel lingkungan menggunakan Google Cloud konsol:

  1. Di Google Cloud konsol, buka halaman Tugas Cloud Run:

    Buka Cloud Run

  2. Pilih tugas Anda dari daftar, lalu klik Edit dan deploy revisi baru.

  3. Klik tab Container.

  4. Di tab Variabel dan secret, edit kolom Nama atau Nilai, lalu klik Selesai.

  5. Klik Deploy.

gcloud

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

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

Ganti kode berikut:

  • JOB_NAME: nama tugas Anda.
  • KEY1=VALUE1,KEY2=VALUE2: daftar nama variabel dan nilai yang dipisahkan koma.

Melihat setelan variabel lingkungan

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

Konsol

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

    Buka tugas Cloud Run

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

  3. Klik Lihat dan Edit konfigurasi tugas.

  4. Temukan setelan variabel lingkungan di detail konfigurasi.

gcloud

  1. Gunakan perintah berikut:

    gcloud run jobs describe JOB_NAME

  2. Temukan setelan variabel lingkungan di konfigurasi yang ditampilkan.

Menghapus variabel lingkungan

Anda dapat menghapus variabel lingkungan untuk tugas yang ada.

Konsol

Untuk menghapus variabel lingkungan menggunakan Google Cloud konsol:

  1. Di Google Cloud konsol, buka Cloud Run:

    Buka Cloud Run

  2. Pilih tugas Anda dari daftar, lalu klik Edit dan deploy revisi baru.

  3. Klik tab Container.

  4. Di tab Variabel dan secret, arahkan kursor ke kiri kolom Nilai variabel lingkungan yang Anda hapus, untuk menampilkan ikon Hapus , lalu klik ikon tersebut.

  5. Klik Selesai.

  6. Klik Deploy.

gcloud

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

gcloud run jobs update JOB_NAME --remove-env-vars KEY1,KEY2

Ganti kode berikut:

  • JOB_NAME: nama tugas Anda.
  • KEY1,KEY2: daftar nama variabel yang dipisahkan koma.

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

gcloud run jobs update JOB_NAME --clear-env-vars