Memulai Config Connector


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

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:

  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 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:

  1. Ubah bagian metadata dari file pubsub-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
  2. Gunakan kubectl apply untuk mengupdate resource. Jalankan perintah berikut:

    kubectl apply -f pubsub-topic.yaml
  3. 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