Mengamati Perubahan untuk Variabel

Halaman ini menjelaskan cara membuat watcher untuk variabel. Untuk mempelajari watcher lebih lanjut, baca artikel Dasar-Dasar Konfigurasi Runtime.

Sebelum memulai

Mengamati perubahan variabel

Anda dapat mengamati perubahan pada variabel dengan memanggil metode variables().watch. Metode ini mengamati variabel selama 60 detik dan menampilkannya jika nilai variabel berubah. Jika nilai tidak berubah dalam 60 detik, metode akan dihentikan dan ditampilkan dengan variabel state=VARIABLE_STATE_UNSPECIFIED. Jika variabel dihapus, metode ini akan menampilkan variabel state=DELETED dan nilai variabel terakhir yang diketahui.

Untuk menyiapkan watcher, gunakan Deployment Manager, Google Cloud CLI, atau API.

Deployment Manager

Ini tidak didukung di Deployment Manager. Sebagai gantinya, buat pelayan.

gcloud

Dengan Google Cloud CLI:

gcloud beta runtime-config configs variables watch [VARIABLE_KEY] --max-wait [TIMEOUT_SEC] --config-name [CONFIG_NAME]

dengan:

  • [VARIABLE_KEY] adalah kunci untuk ditonton.
  • [TIMEOUT_SEC] adalah waktu dalam detik untuk menunggu. Jumlah default dan maksimum adalah 60 detik.

Gcloud CLI mengamati variabel dan menampilkannya setelah mencapai periode waktu tunggu yang ditentukan atau variabel berubah. Jika variabel berubah, respons akan berisi salah satu status variabel yang berlaku.

API

Di API, buat permintaan POST ke URI berikut:

https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_KEY]:watch

dengan:

  • [PROJECT_ID] adalah project ID untuk permintaan ini.
  • [CONFIG_NAME] adalah nama resource RuntimeConfig untuk permintaan ini.
  • [VARIABLE_KEY] adalah kunci untuk ditonton.

    Secara opsional, Anda dapat memberikan payload permintaan dengan properti newerThan:

    { "newerThan": "[TIMESTAMP]" }

    dengan [TIMESTAMP] adalah stempel waktu dalam RFC 3339 sejak epoch dalam format "Zulu" UTC. Contoh:

    2014-10-02T15:01:23.045123456Z

    Jika Anda memberikan properti newerThan, metode ini akan segera ditampilkan jika stempel waktu saat ini untuk variabel lebih baru dari stempel waktu yang ditentukan. Gunakan properti newerThan untuk memastikan Anda tidak melewatkan perubahan apa pun di antara panggilan watch().

    Metode akan ditampilkan dengan salah satu status variabel yang berlaku.

    Untuk mempelajari metode ini lebih lanjut, baca dokumentasi variables().watch.

Langkah selanjutnya