Memulai Config Connector
Panduan ini menunjukkan dasar-dasar pengelolaan resource Config Connector dengan yang mengajari Anda cara menyelesaikan tugas-tugas berikut:
- Mengaktifkan Google Cloud API.
- Buat dan kelola topik Pub/Sub.
Sebelum memulai
Sebelum Anda memulai latihan di halaman ini, selesaikan tugas-tugas berikut:
Instal Config Connector dengan menyelesaikan semua langkah dalam Menginstal Operator Config Connector secara manual.
Mengonfigurasi Config Connector menggunakan namespace default. Namespace yang Anda tetapkan sebagai default harus sama dengan namespace dengan anotasi yang Anda tambahkan saat menentukan tempat pembuatan resource.
- Config Connector menggunakan Service Usage API untuk mengaktifkan API layanan. Untuk melakukan
langkah-langkah ini, Anda harus mengaktifkan
Penggunaan Layanan
Compute Engine API. Anda dapat mengaktifkan API ini menggunakan Google Cloud CLI:
gcloud services enable serviceusage.googleapis.com
Menemukan resource Google Cloud yang tersedia
Untuk melihat jenis resource Google Cloud yang dapat Anda buat Config Connector, jalankan:
kubectl get crds --selector cnrm.cloud.google.com/managed-by-kcc=true
Output-nya adalah daftar semua resource yang dapat digunakan versi Config Connector Anda buat dan kelola.
Misalnya, Anda dapat melihat deskripsi API untuk PubSubTopic
resource dengan kubectl describe
:
kubectl describe crd pubsubtopics.pubsub.cnrm.cloud.google.com
Anda juga dapat melihat informasi tentang sumber daya yang tersedia di Resource Config Connector.
Mengaktifkan layanan Pub/Sub
Gunakan Config Connector untuk mengaktifkan Pub/Sub API dengan menerapkan konfigurasi YAML ke cluster Anda:
Buat file bernama
enable-pubsub.yaml
dan salin YAML berikut ke dalamnya:apiVersion: serviceusage.cnrm.cloud.google.com/v1beta1 kind: Service metadata: name: pubsub.googleapis.com spec: projectRef: external: projects/PROJECT_ID
PROJECT_ID
dengan ID project Google Cloud AndaGunakan
kubectl apply
untuk menerapkan konfigurasi ke cluster Anda. Untuk mengaktifkan Pub/Sub API, jalankan perintah berikut:kubectl apply -f enable-pubsub.yaml
Membuat instance Pub/Sub
Buat file bernama pubsub-topic.yaml
dengan konten berikut:
apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
kind: PubSubTopic
metadata:
annotations:
cnrm.cloud.google.com/project-id: PROJECT_ID
labels:
LABEL_KEY:LABEL_VALUE
name: TOPIC_NAME
Ganti kode berikut:
PROJECT_ID
: Project ID Google Cloud Anda.LABEL_KEY:LABEL_VALUE
: pasangan nilai kunci dari label. Misalnya,environment:production
.TOPIC_NAME
: nama topik Pub/Sub.
Saat Anda membuat resource, Config Connector akan membuat resource jika tidak ada. Jika resource Google Cloud sudah ada dengan nama, , lalu Config Connector memperoleh resource dan mengelolanya. Untuk mempelajari lebih lanjut tentang mendapatkan sumber daya yang ada, lihat Mengelola dan menghapus resource.
Gunakan
kubectl apply
untuk membuat sumber daya. Untuk membuat topik Pub/Sub, jalankan
perintah berikut:
kubectl apply -f pubsub-topic.yaml
Mendeskripsikan resource
Gunakan kubectl describe
untuk mendapatkan detail
tentang sumber daya.
Misalnya, untuk melihat semua topik Pub/Sub Anda, jalankan perintah berikut:
kubectl describe pubsubtopics
Dalam daftar ini, Anda akan melihat topik Pub/Sub yang telah dibuat di bagian sebelumnya.
Memverifikasi bahwa resource sudah siap
Setelah membuat topik Pub/Sub, Anda dapat memeriksa
status.condition
Misalnya, untuk memeriksa apakah resource topik Pub/Sub Anda sudah siap, jalankan
perintah berikut:
kubectl wait --for=condition=READY pubsubtopics TOPIC_NAME
Ganti TOPIC_NAME
dengan nama Pub/Sub Anda
topik.
Anda akan melihat output yang mirip dengan contoh berikut:
pubsubtopic.pubsub.cnrm.cloud.google.com/TOPIC_NAME condition met
Mengupdate resource
Anda dapat memperbarui
metadata
sumber daya Anda dengan memperbarui file YAML dan menerapkannya kembali dengan kubectl
.
Untuk mengubah label pada topik Pub/Sub yang Anda buat di selesaikan langkah-langkah berikut:
Ubah bagian
metadata
dari filepubsub-topic.yaml
Anda untuk mengubah label:apiVersion: pubsub.cnrm.cloud.google.com/v1beta1 kind: PubSubTopic metadata: annotations: cnrm.cloud.google.com/project-id: PROJECT_ID labels: NEW_LABEL_VALUE name: TOPIC_NAME
Ganti kode berikut:
PROJECT_ID
: Project ID Google Cloud Anda.NEW_LABEL_VALUE
: nilai yang diperbarui untuk label yang Anda yang ditambahkan sebelumnya. Contoh,environment: staging
.TOPIC_NAME
: nama topik Pub/Sub
Gunakan
kubectl apply
untuk mengupdate resource. Jalankan perintah berikut:kubectl apply -f pubsub-topic.yaml
Periksa instance Pub/Sub untuk perubahan nama:
kubectl describe pubsubtopics
Topik Anda harus memiliki label baru.
Menghapus resource
Gunakan kubectl delete
menghapus resource. Misalnya, untuk menghapus PubSubTopic
yang Anda buat
sebelumnya, jalankan kubectl delete
dengan file pubsub-topic.yaml
Anda:
kubectl delete -f pubsub-topic.yaml
Anda menerima konfirmasi bahwa resource telah dihapus:
pubsubtopic.pubsub.cnrm.cloud.google.com "TOPIC_NAME" deleted
Secara default, Config Connector menghapus resource PubSubTopic
. Jika Anda lebih suka
untuk menyimpan referensi ini, lihat petunjuknya di
Mengelola dan menghapus resource.
Langkah selanjutnya
- Pelajari cara Config Connector membuat model resource Google Cloud dengan konstruksi Kubernetes.
- Lihat referensi Google Cloud Config Connector dapat mengelola.
- Gunakan Config Connector untuk mengelola resource Google Cloud yang ada.
- Lihat contoh tambahan tentang cara menggunakan Config Connector di Repositori GitHub.
- Pelajari cara Kubernetes menangani konfigurasi deklaratif objek terstruktur dalam jumlah besar.