Halaman ini menjelaskan cara membuat resource Konfigurasi. Resource Konfigurasi adalah objek API yang menyimpan variabel sebagai pasangan nilai kunci. Anda memerlukan resource Konfigurasi sebelum dapat menetapkan dan mendapatkan variabel. Setelah membuat resource Konfigurasi, Anda dapat membuat variabel arbitrer yang dapat digunakan untuk menyimpan data.
Untuk mempelajari konfigurasi, variabel, dan layanan Runtime Configurator lebih lanjut, lihat Dasar-Dasar Runtime Configurator.
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 Runtime Configurator.
- Aktifkan Runtime Configurator API.
Membuat konfigurasi
Anda dapat membuat resource Konfigurasi dengan Deployment Manager, alat command line gcloud, atau langsung menggunakan Runtime Configurator API.
Deployment Manager
Untuk membuat konfigurasi di Deployment Manager, tentukan jenis RuntimeConfig:
runtimeconfig.v1beta1.config
Di properties resource, berikan name dan properti opsional lainnya jika diinginkan:
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
dengan:
[CONFIG_NAME]adalah nama untuk konfigurasi ini.[DESCRIPTION]adalah deskripsi konfigurasi ini (opsional).
gcloud
Dengan Google Cloud CLI, gunakan perintah gcloud beta runtime-config configs create:
gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]
dengan:
[CONFIG_NAME]adalah nama untuk konfigurasi ini.[DESCRIPTION]adalah deskripsi konfigurasi ini (opsional).
gcloud menampilkan respons seperti:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Untuk referensi lengkap perintah gcloud ini, baca
runtime-config configs create
dokumentasi referensi.
API
Di REST API, buat permintaan POST ke URI berikut:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/
dengan [PROJECT_ID] adalah project ID untuk permintaan ini. Payload untuk
permintaan akan terlihat seperti ini:
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
dengan:
[PROJECT_ID]adalah project ID untuk permintaan ini.[CONFIG_NAME]adalah nama RuntimeConfig ini.[DESCRIPTION]adalah deskripsi konfigurasi ini (opsional).Untuk mempelajari metode ini lebih lanjut, baca
configs().createdokumentasi.
Menghapus resource RuntimeConfig
Menghapus resource RuntimeConfig akan menghapus semua resource yang terdapat dalam resource tersebut, termasuk semua variabel dan waiter.
Deployment Manager
Hapus resource RuntimeConfig yang merupakan bagian dari deployment menggunakan salah satu metode berikut:
- Perbarui deployment untuk menghapus konfigurasi dan men-deploy ulang deployment.
- Hapus deployment dan resource yang ada di dalamnya.
gcloud
Dengan Google Cloud CLI, gunakan perintah gcloud beta runtime-config configs delete:
gcloud beta runtime-config configs delete [CONFIG_NAME]
dengan [CONFIG_NAME] adalah nama objek konfigurasi.
gcloud CLI menampilkan respons seperti:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Untuk referensi gcloud lengkap, baca runtime-config configs delete
dokumentasi referensi.
API
Di REST API, buat permintaan DELETE ke URI berikut:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]
dengan:
[PROJECT_ID]adalah project ID untuk permintaan ini.[CONFIG_NAME]adalah nama konfigurasi ini.Untuk mempelajari metode ini lebih lanjut, baca
configs().deletedokumentasi.
Langkah berikutnya
- Selanjutnya, buat beberapa variabel dan pelajari cara menetapkan dan mendapatkan data.
- Pelajari cara menetapkan Watcher pada variabel tertentu.
- Buat Waiter yang ditampilkan saat variabel mencapai kondisi Kardinalitas.
- Lihat referensi v1beta1.
- Lihat Kuota untuk Runtime Configurator.
- Pelajari Runtime Configurator.