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
.
- 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 notifikasiUpgradeEvent
danSecurityBulletinEvent
, mengabaikan semua jenis lainnya.
Konsol
Untuk mengaktifkan notifikasi cluster di cluster Standard yang baru, lakukan hal berikut:
Buka halaman Google Kubernetes Engine di Konsol Google Cloud.
Klik add_box Create.
Pada dialog Buat cluster, di samping GKE Standard, klik Konfigurasi.
Di panel navigasi, di bagian Cluster, klik Automation.
Centang kotak Aktifkan notifikasi.
Dari menu drop-down, pilih topik Pub/Sub yang Anda buat.
Untuk memfilter notifikasi, pilih kotak centang Filter jenis notifikasi, lalu pilih jenis notifikasi yang ingin Anda terima.
Lanjutkan untuk mengonfigurasi cluster sesuai keinginan.
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 notifikasiUpgradeEvent
danSecurityBulletinEvent
, mengabaikan semua jenis lainnya.
Konsol
Untuk mengaktifkan notifikasi cluster di cluster yang ada, lakukan langkah berikut:
Buka halaman Google Kubernetes Engine di konsol Google Cloud.
Klik nama cluster yang ingin diubah.
Di bagian Automation, di samping Notifications, klik
Edit notifications.Dalam dialog Edit notifikasi, pilih kotak centang Aktifkan notifikasi.
Dari menu drop-down, pilih topik Pub/Sub yang Anda buat.
Untuk memfilter notifikasi, pilih kotak centang Filter jenis notifikasi, lalu pilih jenis notifikasi yang ingin Anda terima.
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:
Buka halaman Google Kubernetes Engine di konsol Google Cloud.
Klik nama cluster yang ingin diubah.
Di bagian Automation, di samping Notifications, klik
Edit notifications.Dalam dialog Edit notifikasi, hapus centang pada kotak Filter jenis notifikasi.
Klik Simpan perubahan.
Memverifikasi penyiapan untuk notifikasi cluster
Dalam mode Autopilot, Anda dapat memverifikasi notifikasi cluster sebagai berikut:
- Memulai upgrade bidang kontrol.
- Tunggu hingga GKE mengupgrade node Anda secara otomatis ke versi baru. Waktu yang diperlukan dapat bervariasi berdasarkan masa pemeliharaan dan pengecualian yang dikonfigurasi.
- Setelah GKE mengupgrade node Anda, periksa langganan Pub/Sub Anda.
Pada mode Standard, Anda dapat memverifikasi notifikasi cluster sebagai berikut:
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.
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:
Buka halaman Google Kubernetes Engine di konsol Google Cloud.
Klik nama cluster yang ingin diubah.
Di bagian Automation, di samping Notifications, klik
Edit notifications.Dalam dialog Edit notifikasi, hapus centang pada kotak Aktifkan notifikasi.
Klik Simpan perubahan.
Atau, hapus topik Pub/Sub yang Anda buat untuk notifikasi.
Langkah selanjutnya
- Pelajari notifikasi cluster lebih lanjut.
- Pelajari cara mengonfigurasi notifikasi Pub/Sub.
- Pelajari cara mengonfigurasi notifikasi cluster untuk layanan pihak ketiga.