Tentang CRD Config Connector

Config Connector mencakup kumpulan Definisi Resource Kustom (CRD). Setiap CRD memungkinkan Anda mengonfigurasi resource Google Cloud dari Kubernetes. Config Connector juga memungkinkan Anda menggunakan sejumlah fitur Kubernetes untuk mengelola Google Cloud resource.

Halaman ini memperkenalkan cara Config Connector menggunakan objek Kubernetes dan metadatanya.

Objek Kubernetes dan resource Config Connector

Misalnya, saat Anda membuat Objek Kubernetes dari kind: SQLInstance, Config Connector 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. Sub-bidang spec merujuk ke resource Google Cloud terkait. Saat Anda mengubah sub-field, nilai resource Google Cloud akan konsisten pada akhirnya dengan nilai yang Anda inginkan.
Contoh kolom yang dapat ditulis adalah databaseVersion dalam resource SQLInstance.
Untuk resource Config Connector dengan spec.labels, label yang dikonfigurasi di kolom spec.labels resource Config Connector akan diterapkan ke resource Google Cloud terkait. Untuk mengetahui detailnya, lihat Mengelola label.
Status
Kolom status bersifat hanya baca dan berisi status objek Anda saat ini. Config Connector secara berkala membaca informasi di resource Google Cloud Anda dan memperbarui status. Anda dapat memeriksa pesan error atau kesiapan resource dengan melihat Status.Condition.
Contoh kolom hanya baca status adalah connectionName dari resource SQLInstance.

Metadata objek

Setiap resource Config Connector menyertakan kolom metadata. Bagian ini menjelaskan cara Config Connector menggunakan sub-bidang dalam metadata.

Nama
Nama resource Config Connector. Nama tersebut harus mengikuti konvensi penamaan nama objek Kubernetes. Secara default, nama ini digunakan 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 kolom spec.resourceID. Untuk mengetahui informasi selengkapnya, lihat Mengelola resource dengan kolom resourceID.
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
Bergantung pada resource, label di kolom metadata.labels dari resource Config Connector dapat diterapkan ke resource Google Cloud terkait. Untuk mengetahui detailnya, lihat Mengelola label.
Config Connector menambahkan label sistem bernama managed-by-cnrm dengan nilai true ke Google Cloud resource yang mendukung label.
Anotasi
Config Connector dapat melakukan tindakan tambahan pada resource Anda yang tidak ditentukan dalam spec. Tindakan ini ditentukan dalam sub-kolom metadata.annotations. Nilai anotasi harus berupa string. Jenis anotasi yang didukung Config Connector dijelaskan dalam annotations.

Mengelola label

Untuk Google Cloud resource yang mendukung label, tempat Anda menentukan label bergantung pada apakah resource Config Connector memiliki kolom spec.labels atau tidak:

  • Resource dengan kolom spec.labels: Anda harus mengelola label di spec.labels. Label yang ditentukan pengguna di kolom ini diterapkan ke Google Cloud resource.
  • Resource tanpa kolom spec.labels: Semua label di metadata.labels, termasuk label yang ditentukan pengguna dan label sistem, diterapkan ke resource Google Cloud .

Folder dan resource hierarkis

Selain mengelola resource di Google Cloud produk, Config Connector mendukung pembuatan dan pengelolaan resource dalam Google Cloud Folder dan Organisasi. Untuk mengetahui 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 mengetahui informasi selengkapnya, lihat Mengamankan akses ke resource.

Kondisi Status

Config Connector menggunakan kondisi siap di status.condition untuk dua tujuan:

  • menunjukkan kapan resource siap. Saat resource dicocokkan dan siap, status.condition.status-nya akan ditetapkan ke True. Untuk memeriksa kapan resource siap, lihat Menunggu resource siap
  • menampilkan error atau informasi tambahan. Kondisi siap memiliki kolom Message dan Reason yang memberikan informasi tambahan tentang status resource.

Acara

Perubahan status penting untuk resource Config Connector dapat dilihat sebagai peristiwa Kubernetes. Untuk mengetahui informasi selengkapnya, lihat Melihat peristiwa.

Konfigurasi deklaratif dan konsistensi tertunda

Lihat Rekonsiliasi.

Langkah berikutnya