Memulai Config Connector

Panduan ini menunjukkan dasar-dasar pengelolaan resource Config Connector dengan mengajari Anda cara menyelesaikan tugas-tugas berikut:

  • Aktifkan Google Cloud API.
  • Membuat dan mengelola topik Pub/Sub.

Sebelum memulai

Sebelum memulai latihan di halaman ini, selesaikan tugas berikut:

Menemukan resource Google Cloud yang tersedia

Untuk melihat jenis resource Google Cloud yang dapat Anda buat dengan Config Connector, jalankan:

kubectl get crds --selector cnrm.cloud.google.com/managed-by-kcc=true

Outputnya adalah daftar semua resource yang dapat dibuat dan dikelola oleh versi Config Connector Anda.

Misalnya, Anda dapat melihat deskripsi API untuk resource PubSubTopic dengan kubectl describe:

kubectl describe crd pubsubtopics.pubsub.cnrm.cloud.google.com

Anda juga dapat melihat informasi tentang resource 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:

  1. 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 Anda

  2. Gunakan 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 label. Misalnya, environment:production.
  • TOPIC_NAME: nama topik Pub/Sub.

Saat Anda membuat resource, Config Connector akan membuat resource tersebut jika tidak ada. Jika resource Google Cloud sudah ada dengan nama yang sama, Config Connector akan mengakuisisi resource tersebut dan mengelolanya. Untuk mempelajari lebih lanjut cara memperoleh resource yang ada, lihat Mengelola dan menghapus resource.

Gunakan perintah kubectl apply untuk membuat resource. Untuk membuat topik Pub/Sub, jalankan perintah berikut:

kubectl apply -f pubsub-topic.yaml

Mendeskripsikan resource

Gunakan kubectl describe untuk mendapatkan detail tentang resource.

Misalnya, untuk melihat semua topik Pub/Sub, jalankan perintah berikut:

kubectl describe pubsubtopics

Dalam daftar ini, Anda akan melihat topik Pub/Sub yang Anda buat di bagian sebelumnya.

Memverifikasi bahwa resource sudah siap

Setelah membuat topik Pub/Sub, Anda dapat memeriksa status.condition-nya. 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 topik Pub/Sub Anda.

Anda akan melihat output yang mirip dengan contoh berikut ini:

pubsubtopic.pubsub.cnrm.cloud.google.com/TOPIC_NAME condition met

Memperbarui resource

Anda dapat memperbarui metadata di resource dengan memperbarui file YAML dan menerapkannya kembali dengan kubectl.

Untuk mengubah label pada topik Pub/Sub yang Anda buat di bagian sebelumnya, selesaikan langkah-langkah berikut:

  1. Ubah bagian metadata dari file pubsub-topic.yaml 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 tambahkan sebelumnya. Contoh, environment: staging.
    • TOPIC_NAME: nama topik Pub/Sub

  2. Gunakan kubectl apply untuk memperbarui resource. Jalankan perintah berikut:

    kubectl apply -f pubsub-topic.yaml

  3. Periksa instance Pub/Sub untuk mengetahui perubahan nama:

    kubectl describe pubsubtopics

    Topik Anda akan memiliki label baru.

Menghapus resource

Gunakan kubectl delete untuk menghapus resource. Misalnya, untuk menghapus PubSubTopic yang Anda buat sebelumnya, jalankan kubectl delete dengan file pubsub-topic.yaml:

kubectl delete -f pubsub-topic.yaml

Anda akan menerima konfirmasi bahwa resource telah dihapus:

pubsubtopic.pubsub.cnrm.cloud.google.com "TOPIC_NAME" deleted

Secara default, Config Connector akan menghapus resource PubSubTopic. Jika Anda lebih memilih untuk mempertahankan resource ini, lihat petunjuk di Mengelola dan menghapus resource.

Langkah selanjutnya