Menerima notifikasi cluster


Halaman ini menunjukkan cara menggunakan Pub/Sub untuk menerima notifikasi tentang cluster Google Kubernetes Engine (GKE).

Ringkasan

Jika terjadi peristiwa tertentu yang relevan dengan cluster GKE, seperti upgrade terjadwal yang penting atau buletin keamanan yang tersedia, GKE memublikasikan notifikasi tentang peristiwa tersebut sebagai pesan ke topik Pub/Sub yang Anda konfigurasikan. Anda dapat menerima notifikasi ini di langganan Pub/Sub, berintegrasi dengan layanan pihak ketiga, dan memfilter jenis notifikasi yang ingin diterima.

Untuk mempelajari lebih lanjut manfaat notifikasi cluster, cara kerja notifikasi, dan alasan pentingnya pemfilteran, lihat Notifikasi cluster. Anda dapat mengonfigurasi notifikasi cluster di cluster Standard baru dan yang sudah ada, serta dengan mengupdate cluster Autopilot yang ada.

Sebelum memulai

Sebelum memulai, pastikan Anda telah menjalankan tugas berikut:

  • Aktifkan Google Kubernetes Engine API.
  • Aktifkan Google Kubernetes Engine API
  • Jika ingin menggunakan Google Cloud CLI untuk tugas ini, instal lalu initialize gcloud CLI. Jika sebelumnya Anda telah menginstal gcloud CLI, dapatkan versi terbaru dengan menjalankan gcloud components update.

Mengaktifkan notifikasi cluster di cluster baru

Anda dapat mengaktifkan notifikasi cluster GKE pada cluster Standard baru menggunakan Google Cloud CLI atau Konsol Google Cloud. Untuk mengaktifkan notifikasi pada cluster Autopilot, Anda harus membuat cluster Autopilot terlebih dahulu, lalu mengupdate cluster untuk menggunakan notifikasi cluster.

gcloud

Untuk mengaktifkan notifikasi cluster di cluster baru, jalankan perintah berikut:

gcloud container clusters create CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --notification-config=pubsub=ENABLED,pubsub-topic=projects/PROJECT_ID/topics/TOPIC_NAME,filter=NOTIFICATION_TYPE

Ganti kode berikut:

  • CLUSTER_NAME: nama cluster baru.
  • COMPUTE_REGION: region komputasi untuk cluster baru Anda. Untuk cluster Standard zona, gunakan --zone=COMPUTE_ZONE.
  • PROJECT_ID: ID project Google Cloud Anda.
  • TOPIC_NAME: nama topik Pub/Sub Anda.
  • NOTIFICATION_TYPE: daftar jenis notifikasi yang ingin diterima yang dipisahkan tanda pipa (|). Misalnya, filter="UpgradeEvent|SecurityBulletinEvent" hanya mengirim notifikasi UpgradeEvent dan SecurityBulletinEvent, mengabaikan semua jenis lainnya.

Konsol

Untuk mengaktifkan notifikasi cluster di cluster Standard yang baru, lakukan hal berikut:

  1. Buka halaman Google Kubernetes Engine di Konsol Google Cloud.

    Buka Google Kubernetes Engine

  2. Klik Create.

  3. Pada dialog Buat cluster, di samping GKE Standard, klik Konfigurasi.

  4. Di panel navigasi, di bagian Cluster, klik Automation.

  5. Centang kotak Aktifkan notifikasi.

  6. Dari menu drop-down, pilih topik Pub/Sub yang Anda buat.

  7. Untuk memfilter notifikasi, pilih kotak centang Filter jenis notifikasi, lalu pilih jenis notifikasi yang ingin Anda terima.

  8. Lanjutkan untuk mengonfigurasi cluster sesuai keinginan.

  9. Klik Create.

Setelah mengaktifkan notifikasi, buat langganan Pub/Sub untuk topik Anda.

Mengaktifkan notifikasi cluster di cluster yang ada

Anda dapat mengaktifkan notifikasi cluster GKE pada cluster yang ada menggunakan Google Cloud CLI atau Konsol Google Cloud.

gcloud

Untuk mengaktifkan notifikasi cluster di cluster yang ada, jalankan perintah berikut:

gcloud container clusters update CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --notification-config=pubsub=ENABLED,pubsub-topic=projects/PROJECT_ID/topics/TOPIC_NAME,filter=NOTIFICATION_TYPE

Ganti kode berikut:

  • CLUSTER_NAME: nama cluster Anda.
  • COMPUTE_REGION: region komputasi untuk cluster baru Anda. Untuk cluster Standard zona, gunakan --zone=COMPUTE_ZONE.
  • PROJECT_ID: ID project Google Cloud Anda.
  • TOPIC_NAME: nama topik Pub/Sub Anda.
  • NOTIFICATION_TYPE: daftar jenis notifikasi yang ingin diterima yang dipisahkan tanda pipa (|). Misalnya, filter="UpgradeEvent|SecurityBulletinEvent" hanya mengirim notifikasi UpgradeEvent dan SecurityBulletinEvent, mengabaikan semua jenis lainnya.

Konsol

Untuk mengaktifkan notifikasi cluster di cluster yang ada, lakukan langkah berikut:

  1. Buka halaman Google Kubernetes Engine di konsol Google Cloud.

    Buka Google Kubernetes Engine

  2. Klik nama cluster yang ingin diubah.

  3. Di bagian Automation, di samping Notifications, klik Edit notifications.

  4. Dalam dialog Edit notifikasi, pilih kotak centang Aktifkan notifikasi.

  5. Dari menu drop-down, pilih topik Pub/Sub yang Anda buat.

  6. Untuk memfilter notifikasi, pilih kotak centang Filter jenis notifikasi, lalu pilih jenis notifikasi yang ingin Anda terima.

  7. Klik Simpan perubahan.

Setelah mengaktifkan notifikasi, buat langganan Pub/Sub untuk topik Anda.

Filter notifikasi cluster

Anda dapat memfilter notifikasi menurut jenis notifikasi untuk memastikan bahwa Anda menerima notifikasi yang diinginkan.

Anda dapat memilih untuk memfilter notifikasi menggunakan metode berikut:

  • GKE: Tentukan nilai untuk filter di flag --notification-config, seperti yang ditunjukkan pada contoh sebelumnya untuk mengaktifkan notifikasi cluster.
  • Pub/Sub: Konfigurasikan langganan Pub/Sub untuk memfilter pesan saat Anda membuat langganan.

Mengubah filter yang ada di GKE

Untuk mengubah filter notifikasi cluster GKE yang ada, ikuti petunjuk dalam artikel Mengaktifkan notifikasi di cluster yang ada dan tentukan jenis notifikasi baru untuk memfilter dalam perintah gcloud atau pilih jenis baru di Konsol Google Cloud.

Menonaktifkan filter di GKE

Anda dapat menonaktifkan filter notifikasi GKE dan menerima semua jenis notifikasi yang berlaku untuk cluster Anda menggunakan gcloud CLI atau Konsol Google Cloud.

gcloud

Untuk menonaktifkan filter menggunakan gcloud CLI, jalankan perintah berikut:

gcloud container clusters update CLUSTER_NAME \
  --region=COMPUTE_REGION \
  --notification-config=pubsub=ENABLED,pubsub-topic=projects/PROJECT_ID/topics/TOPIC_NAME

Konsol

Untuk menonaktifkan filter menggunakan Konsol Google Cloud, lakukan langkah berikut:

  1. Buka halaman Google Kubernetes Engine di konsol Google Cloud.

    Buka Google Kubernetes Engine

  2. Klik nama cluster yang ingin diubah.

  3. Di bagian Automation, di samping Notifications, klik Edit notifications.

  4. Dalam dialog Edit notifikasi, hapus centang pada kotak Filter jenis notifikasi.

  5. Klik Simpan perubahan.

Memverifikasi penyiapan untuk notifikasi cluster

Dalam mode Autopilot, Anda dapat memverifikasi notifikasi cluster sebagai berikut:

  1. Memulai upgrade bidang kontrol.
  2. Tunggu hingga GKE mengupgrade node Anda secara otomatis ke versi baru. Waktu yang diperlukan dapat bervariasi berdasarkan masa pemeliharaan dan pengecualian yang dikonfigurasi.
  3. Setelah GKE mengupgrade node Anda, periksa langganan Pub/Sub Anda.

Pada mode Standard, Anda dapat memverifikasi notifikasi cluster sebagai berikut:

  1. Upgrade node pool tertentu ke versi baru. Jika tidak ingin mengubah versi GKE pada node, Anda dapat mengupgrade ke versi yang sama dengan yang saat ini ada di node.

  2. Setelah GKE mengupgrade node Anda, periksa langganan Pub/Sub Anda.

Anda hanya dapat memverifikasi penyiapan secara manual untuk jenis notifikasi UpgradeEvent. Jika filter Anda dikonfigurasi untuk mengabaikan jenis ini, Anda tidak akan melihat pesan.

Menonaktifkan notifikasi cluster

Anda dapat menonaktifkan notifikasi cluster menggunakan gcloud CLI atau Konsol Google Cloud.

gcloud

Untuk menonaktifkan notifikasi menggunakan gcloud CLI, jalankan perintah berikut:

gcloud container clusters update CLUSTER_NAME \
  --region=COMPUTE_REGION \
  --notification-config=pubsub=DISABLED

Konsol

Untuk menonaktifkan notifikasi menggunakan Konsol Google Cloud, lakukan hal berikut:

  1. Buka halaman Google Kubernetes Engine di konsol Google Cloud.

    Buka Google Kubernetes Engine

  2. Klik nama cluster yang ingin diubah.

  3. Di bagian Automation, di samping Notifications, klik Edit notifications.

  4. Dalam dialog Edit notifikasi, hapus centang pada kotak Aktifkan notifikasi.

  5. Klik Simpan perubahan.

Atau, hapus topik Pub/Sub yang Anda buat untuk notifikasi.

Langkah selanjutnya