Halaman ini menjelaskan cara membuat watcher untuk variabel. Untuk mempelajari watcher lebih lanjut, baca artikel Dasar-Dasar Konfigurasi Runtime.
Sebelum memulai
- Jika Anda ingin menggunakan contoh command line dalam panduan ini, instal alat command line`gcloud`.
- Jika Anda ingin menggunakan contoh API dalam panduan ini, siapkan akses API.
- Baca Dasar-Dasar Konfigurasi Runtime.
- Baca Membuat dan Menghapus Resource RuntimeConfig.
- Baca Menetapkan dan Mendapatkan Data.
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 propertinewerThan
untuk memastikan Anda tidak melewatkan perubahan apa pun di antara panggilanwatch()
.Metode akan ditampilkan dengan salah satu status variabel yang berlaku.
Untuk mempelajari metode ini lebih lanjut, baca dokumentasi
variables().watch
.
Langkah selanjutnya
- Pelajari Konfigurasi Runtime.
- Menetapkan dan Mendapatkan Data.
- Membuat Pelayan.
- Membuat dan Menghapus Resource RuntimeConfig.
- Lihat referensi v1beta1.
- Lihat Kuota untuk Konfigurasi Runtime.