Resource
Config Connector menyertakan kumpulan Custom Resource Definition (CRD). Setiap CRD memungkinkan Anda mengonfigurasi resource Google Cloud dari Kubernetes. Config Connector juga memungkinkan Anda memanfaatkan sejumlah fitur Kubernetes untuk mengelola resource Google Cloud.
Halaman ini memperkenalkan cara Config Connector menggunakan objek Kubernetes dan metadatanya.
Objek Kubernetes dan resource Config Connector
Misalnya, saat Anda membuat
Objek Kubernetes
kind: SQLInstance
, Konektor Konfigurasi akan membuat Instance Cloud SQL.
Bagian ini menjelaskan cara Config Connector memperluas jenis objek.
Spesifikasi dan Status
Setiap resource Config Connector adalah
objek Kubernetes
dengan
Spec
dan Status
.
- Spek
- Kolom
spec
berisi semua kolom yang menentukan status objek yang diinginkan, kecualiLabels
. Subkolomspec
merujuk ke resource Google Cloud terkait. Saat Anda mengubah subkolom, nilai resource Google Cloud akan pada akhirnya konsisten dengan nilai yang Anda inginkan. - Contoh kolom yang dapat ditulis adalah
databaseVersion
dalam resource SQLInstance. - Status
- Kolom
status
hanya dapat dibaca dan berisi status objek Anda saat ini. Config Connector secara berkala membaca informasi di resource Google Cloud Anda dan memperbaruistatus
. Anda dapat memeriksa pesan error atau kesiapan resource dengan melihatStatus.Condition
. - Contoh kolom
status
hanya baca adalahconnectionName
dari resource SQLInstance.
Metadata objek
Setiap resource Config Connector menyertakan kolom metadata. Bagian ini menjelaskan cara Config Connector menggunakan subkolom dalam metadata.
- Nama
- Nama resource Config Connector. Nama ini harus mengikuti
konvensi penamaan
nama objek Kubernetes. Nama ini digunakan secara default sebagai nama resource Google Cloud yang sesuai. Jika kolom
resourceID
didukung di resource Config Connector, Anda dapat menentukan nama yang berbeda, yang mengikuti konvensi penamaan resource Google Cloud, untuk resource Google Cloud yang sesuai di kolomspec.resourceID
. Untuk mengetahui informasi selengkapnya, lihat Mengelola resource dengan kolomresourceID
. - Namespace
- Namespace tempat Anda membuat resource Config Connector menentukan project yang berisi resource Google Cloud. Untuk mengetahui informasi selengkapnya tentang namespace, lihat Namespace Kubernetes dan Project Google Cloud.
- Label
- Label di kolom metadata resource Config Connector juga ditambahkan ke resource Google Cloud terkait.
- Selain itu, Config Connector menambahkan label sistem bernama
managed-by-cnrm
dengan nilaitrue
ke resource Google Cloud Anda. - Anotasi
- Config Connector dapat mengambil tindakan tambahan pada resource Anda yang
tidak ditentukan dalam
spec
. Tindakan ini ditentukan dalam subkolommetadata.annotations
. Nilai anotasi harus berupa string. Jenis anotasi yang didukung Konektor Konfigurasi dijelaskan dalam annotations.
Folder dan resource hierarkis
Selain mengelola resource di produk Google Cloud, Config Connector mendukung pembuatan dan pengelolaan resource dalam Folder dan Organisasi Google Cloud. Untuk informasi selengkapnya, lihat Namespace dan project.
Menggunakan RBAC untuk Kontrol Akses
Role Based Access Control (RBAC) Kubernetes mengamankan resource Anda. Anda dapat mengontrol pembuatan resource Google Cloud dengan menetapkan izin RBAC. Untuk informasi selengkapnya, lihat Mengamankan akses ke resource.
Kondisi Status
Config Connector menggunakan kondisi siap di
status.condition
untuk dua tujuan:
- yang menunjukkan kapan resource siap. Saat resource direkonsiliasi dan
siap,
status.condition.status
-nya akan ditetapkan keTrue
. Untuk memeriksa kapan resource siap, lihat Menunggu resource siap - menampilkan error atau informasi tambahan. Kondisi siap
memiliki kolom
Message
danReason
yang memberikan informasi tambahan tentang status resource.
Acara
Perubahan status penting untuk resource Config Connector terlihat sebagai peristiwa Kubernetes. Untuk informasi selengkapnya, lihat Melihat peristiwa.
Konfigurasi deklaratif dan konsistensi tertunda
Lihat Rekonsiliasi.
Langkah selanjutnya
- Mulai menggunakan Config Connector
- Pelajari Resource yang dikonfigurasi Config Connector.