Menerima notifikasi cluster

Autopilot Standard

---

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 lakukan inisialisasi gcloud CLI. Jika sebelumnya Anda telah menginstal gcloud CLI, dapatkan versi terbaru dengan menjalankan gcloud components update.
  Catatan: Untuk penginstalan gcloud CLI yang ada, pastikan untuk menyetel properti compute/region dan compute/zone. Dengan menetapkan lokasi default, Anda dapat menghindari error di gcloud CLI seperti berikut: One of [--zone, --region] must be supplied: Please specify location.

• Buat topik Pub/Sub di project Anda.

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.

  Catatan: Jika tidak menetapkan nilai untuk filter, Anda akan menerima semua notifikasi yang berlaku untuk konfigurasi cluster Anda.

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.

   Catatan: Jika tidak memilih jenis notifikasi untuk difilter, Anda akan menerima semua notifikasi yang berlaku.

8. Lanjutkan untuk mengonfigurasi cluster.

9. Klik Create.

Setelah mengaktifkan notifikasi, pilih jenis langganan untuk topik Anda.

Catatan: GKE tidak memiliki batasan dalam cara menghubungkan topik dengan cluster, selama topik tersebut berada dalam project yang sama dengan cluster. Anda dapat memilih untuk membuat satu topik untuk semua cluster, atau membuat beberapa topik untuk grup cluster.

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.

  Catatan: Jika tidak menetapkan nilai untuk filter, Anda akan menerima semua notifikasi yang berlaku untuk konfigurasi cluster Anda.

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.

   Catatan: Jika tidak memilih jenis notifikasi untuk difilter, Anda akan menerima semua notifikasi yang berlaku.

7. Klik Simpan perubahan.

Setelah mengaktifkan notifikasi, pilih jenis langganan untuk topik Anda.

Catatan: GKE tidak memiliki batasan dalam cara menghubungkan topik dengan cluster, selama topik tersebut berada dalam project yang sama dengan cluster. Anda dapat memilih untuk membuat satu topik untuk semua cluster, atau membuat beberapa topik untuk grup cluster

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.

Catatan: Sebaiknya Anda memfilter menggunakan GKE. Dengan memfilter di GKE, Anda dapat memodifikasi filter kapan saja dan menghilangkan biaya pesan tidak terkirim yang terkait dengan filter Pub/Sub. Untuk mempelajari lebih lanjut perbedaan antara opsi pemfilteran, lihat Memfilter notifikasi.

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.

   Perhatian: Mengupgrade node pool Standard secara manual akan mengabaikan masa pemeliharaan yang dikonfigurasi dan dapat menyebabkan gangguan pada workload yang berjalan.

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 berikutnya

• Pelajari notifikasi cluster lebih lanjut.
• Pelajari cara mengonfigurasi notifikasi Pub/Sub.
• Pelajari cara mengonfigurasi notifikasi cluster untuk layanan pihak ketiga.