Notifikasi cluster

Dokumen ini menjelaskan cara Google Kubernetes Engine (GKE) memublikasikan notifikasi cluster ke Cloud Logging secara default (dan secara opsional ke Pub/Sub) saat peristiwa tertentu terjadi di cluster GKE Anda. Notifikasi ini berisi informasi tentang peristiwa yang relevan dengan konfigurasi cluster Anda, seperti upgrade terjadwal, tersedia, atau sedang berlangsung, buletin keamanan, dan tanggal akhir dukungan. Untuk menemukan log ini di Cloud Logging, lihat Melihat notifikasi cluster di Cloud Logging.

GKE juga 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 mengetahui informasi selengkapnya tentang cara menyiapkan notifikasi cluster dengan Pub/Sub, lihat Menerima notifikasi cluster melalui Pub/Sub.

Selain notifikasi cluster, GKE juga menyediakan notifikasi untuk urutan peluncuran dengan tahap kustom secara eksklusif ke Cloud Logging.

Manfaat

Notifikasi cluster memberikan manfaat berikut:

  • Anda akan menerima notifikasi saat buletin keamanan yang khusus untuk cluster Anda dikeluarkan, yang memberikan informasi risiko dan dampak yang akurat.
  • Anda akan menerima notifikasi jika ada versi GKE baru yang tersedia untuk cluster Anda, sehingga Anda dapat merencanakan pengujian dan kualifikasi dengan lebih baik, serta membantu memastikan proses upgrade yang lancar dan dapat diprediksi. Sebelumnya, Anda harus memeriksa catatan rilis GKE atau GKE API untuk mengetahui kapan versi GKE baru dirilis.
  • Anda akan menerima notifikasi saat GKE atau pengguna memulai upgrade cluster, dan saat operasi upgrade selesai, yang memberi Anda lebih banyak visibilitas ke operasi latar belakang cluster Anda.
  • Anda akan menerima notifikasi saat cluster menjalankan versi minor GKE yang berada di atau mendekati akhir dukungan.

  • Anda dapat memilih apakah akan menggunakan Cloud Logging atau Pub/Sub:

    • Notifikasi cluster dikirim ke Cloud Logging secara default. Anda dapat menggunakan semua kemampuan Cloud Logging, termasuk mengkueri dan melihat log, serta mengonfigurasi kebijakan pemberitahuan berbasis log.
    • Pub/Sub sangat mudah diperluas, memberikan Anda fleksibilitas dalam memproses notifikasi yang masuk. Misalnya, Anda dapat mengintegrasikan Slack untuk meneruskan notifikasi ke saluran Slack, atau memulai fungsi Cloud Run untuk menjalankan proses kustom. Jika proses kustom diperlukan (misalnya, mengorkestrasi staging ke alur kerja produksi untuk menguji dan memastikan upgrade), Anda dapat menggunakan notifikasi untuk memicu alur kerja ini secara otomatis.

Notifikasi pengurutan peluncuran memberi tahu Anda tentang hal berikut:

  • Progres peluncuran dalam urutan peluncuran dengan tahap kustom. Notifikasi akan terus memberi Anda informasi terkait status peluncuran, sehingga Anda dapat memantau performa cluster dan workload, serta mengambil tindakan, jika diperlukan.
  • Jika urutan peluncuran dengan tahap kustom salah dikonfigurasi, artinya Anda perlu memperbaikinya.

Jenis notifikasi upgrade

GKE mengirimkan jenis notifikasi cluster berikut:

Jika Anda melihat notifikasi cluster di Cloud Logging, Anda dapat menggunakan kemampuan Cloud Logging untuk memfilter log. Jika menggunakan Pub/Sub, Anda dapat memfilter notifikasi yang diterima agar hanya diberi tahu untuk peristiwa yang relevan.

GKE mengirimkan jenis notifikasi urutan peluncuran berikut untuk urutan peluncuran dengan tahap kustom:

SecurityBulletinEvent

Saat GKE mengeluarkan buletin keamanan yang berkaitan langsung dengan konfigurasi atau versi cluster, GKE mengirimkan notifikasi SecurityBulletinEvent yang memberi Anda informasi tentang kerentanan, dampak, dan, tindakan yang dapat Anda ambil jika memungkinkan.

UpgradeAvailableEvent

Saat versi baru tersedia di saluran rilis, GKE mengirimkan notifikasi UpgradeAvailableEvent ke cluster di saluran rilis tersebut untuk menginformasikan cluster bahwa versi baru telah tersedia. Notifikasi ini memberikan pemberitahuan awal satu minggu untuk versi patch dan setidaknya 2-4 minggu untuk versi minor (tergantung saluran). Untuk mengetahui informasi selengkapnya, lihat Versi yang tersedia di saluran.

Untuk cluster yang tidak berada di saluran rilis, GKE mengirimkan notifikasi UpgradeAvailableEvent untuk semua versi baru yang dapat diupgrade cluster, termasuk patch pada versi minor saat ini dan versi minor berikutnya.

Jika Anda menggunakan node pool Windows Server, informasi versi Windows dikirim sebagai bagian dari notifikasi UpgradeAvailableEvent.

UpgradeEvent

Saat Anda atau GKE memulai upgrade, GKE mengirimkan notifikasi UpgradeEvent yang memberi tahu Anda bahwa upgrade telah dimulai. Idealnya, Anda harus menggunakan jenis notifikasi UpgradeAvailableEvent untuk mengetahui upgrade mendatang sehingga Anda dapat melakukan upgrade lebih awal atau mengambil tindakan yang diperlukan untuk mempersiapkan diri, seperti menyiapkan masa pemeliharaan.

Notifikasi UpgradeEvent dikirim saat awal operasi upgrade. ID operasi diteruskan dalam pesan.

Untuk upgrade minor bidang kontrol dua langkah dengan keamanan rollback, GKE mengirimkan notifikasi ini saat upgrade biner dimulai, dan saat upgrade versi yang di-emulasi dimulai. Untuk mengetahui informasi selengkapnya tentang detail kunci yang disediakan GKE, lihat Yang disertakan dalam notifikasi untuk upgrade dua langkah.

UpgradeInfoEvent

GKE mengirimkan notifikasi UpgradeInfoEvent untuk berbagai jenis peristiwa, yang diuraikan di bagian berikutnya.

Untuk mengetahui informasi selengkapnya tentang pemfilteran jenis UpgradeInfoEvent tertentu, lihat Memfilter notifikasi cluster UpgradeInfoEvent.

Upgrade cluster terjadwal

Saat GKE menjadwalkan upgrade cluster, GKE akan mengirimkan notifikasi kepada Anda antara 72 jam hingga 96 jam sebelumnya. Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan upgrade cluster terjadwal, lihat Mendapatkan notifikasi tentang upgrade cluster terjadwal.

Operasi upgrade selesai

Saat GKE menyelesaikan operasi untuk mengupgrade bidang kontrol atau node cluster secara otomatis atau manual, GKE akan mengirimkan notifikasi untuk memberi tahu Anda bahwa operasi telah selesai. Operasi selesai dengan salah satu status berikut:

  • SUCCEEDED: GKE berhasil mengupgrade bidang kontrol atau node.
  • FAILED: GKE gagal mengupgrade bidang kontrol atau node.
  • CANCELED: GKE membatalkan operasi upgrade karena alasan teknis atau bisnis, atau Anda membatalkan operasi upgrade.

Gunakan notifikasi untuk mengonfirmasi keberhasilan operasi upgrade.

Yang disertakan dalam notifikasi untuk upgrade dua langkah

Untuk upgrade minor bidang kontrol dua langkah dengan keamanan rollback, GKE mengirimkan notifikasi ini sekali setelah upgrade biner selesai, yaitu saat waktu tunggu dimulai, dan lagi, setelah upgrade versi yang di-emulasi selesai. Notifikasi ini mencakup informasi seperti berikut, jika berlaku berdasarkan status upgrade dua langkah:

  • Versi awal
  • Versi target
  • Versi yang diemulasi awal
  • Versi emulasi target

Versi minor mencapai atau mendekati akhir dukungan

Saat cluster Anda menjalankan versi minor GKE yang mendekati akhir dukungan standar atau akhir dukungan yang diperpanjang, atau telah mencapai salah satu dari pencapaian tersebut, GKE akan mengirimkan notifikasi bahwa Anda harus mengupgrade node atau bidang kontrol cluster ke versi minor berikutnya yang didukung. Menjalankan versi minor yang didukung akan memastikan Anda terus menerima patch keamanan, perbaikan bug, dan dukungan. GKE mengirimkan satu notifikasi 30 hari sebelum akhir dukungan, dan satu notifikasi di akhir dukungan, jika cluster Anda masih menjalankan versi minor.

GKE mengirimkan notifikasi tingkat cluster, meskipun beberapa komponen cluster Anda mungkin terpengaruh, dan cluster Anda dapat menjalankan versi minor yang berbeda secara bersamaan. Jika versi minor mencapai akhir dukungan standar dan Anda memerlukan waktu untuk mempersiapkan upgrade ke versi yang didukung, Anda dapat beralih ke saluran rilis Extended untuk mendapatkan dukungan jangka panjang. Jika tidak, GKE akan menjadwalkan upgrade otomatis di akhir dukungan. Notifikasi ini membantu memastikan Anda siap untuk penegakan kebijakan akhir dukungan ini.

Notifikasi menyertakan detail berikut:

  • Cluster yang terpengaruh.
  • Versi saat ini yang berada di atau mendekati akhir dukungan.
  • Tanggal akhir dukungan.

Untuk mengetahui detail selengkapnya tentang linimasa dukungan untuk versi minor GKE, lihat siklus proses versi minor GKE.

Versi patch baru berubah menjadi tonggak pencapaian Container-Optimized OS baru selama dukungan yang diperpanjang

Jika cluster Anda terdaftar di saluran Extended selama periode dukungan yang diperpanjang, dan milestone Container-Optimized OS yang digunakan oleh versi minor GKE mencapai akhir dukungan sebelum versi minor, GKE akan mengirimkan notifikasi cluster. GKE mengirimkan notifikasi ini saat versi patch pertama yang menggunakan milestone baru tersedia di saluran Extended.

Notifikasi ini mencakup detail berikut:

  • Cluster yang terpengaruh.
  • Versi patch yang menggunakan tonggak pencapaian baru.
  • Milestone yang sudah ada dan yang baru.
  • Cara GKE menjeda upgrade patch otomatis untuk node.

Versi patch yang menggunakan tonggak pencapaian baru pada akhirnya menjadi target upgrade otomatis patch untuk cluster, dan upgrade otomatis node dijeda. Administrator cluster harus memutuskan langkah berikutnya yang harus dilakukan:

  • Upgrade node cluster secara manual ke versi patch berikutnya yang menggunakan milestone Container-Optimized OS berikutnya.
  • Upgrade cluster secara manual ke versi minor berikutnya.
  • Melewati upgrade patch hingga GKE mengupgrade cluster ke versi minor berikutnya menjelang akhir dukungan yang diperpanjang.

Untuk mempelajari lebih lanjut, lihat Milestone Container-Optimized OS mencapai akhir dukungan sebelum akhir dukungan yang diperpanjang untuk versi minor.

Peristiwa yang mengganggu selama upgrade node pool

Saat node pool mengalami jenis peristiwa yang mengganggu tertentu selama upgrade node pool, GKE akan mengirimkan notifikasi untuk memberi tahu Anda tentang peristiwa ini.

GKE mengirimkan notifikasi cluster untuk jenis peristiwa yang mengganggu berikut:

  • Pengosongan node diblokir oleh Anggaran Gangguan Pod (PDB).
  • Waktu tunggu PDB tercapai dan Pod akan dihapus secara paksa meskipun ada pelanggaran PDB.

Notifikasi ini mencakup detail berikut:

  • Node yang terpengaruh oleh peristiwa gangguan ini.
  • Pod yang terpengaruh oleh peristiwa gangguan ini.
  • Operasi yang memicu pengurasan node.
  • Waktu tunggu PDB sebelum Pod dihapus secara paksa.

RolloutEvent

GKE mengirimkan notifikasi saat peristiwa berikut terjadi untuk peluncuran versi GKE dalam urutan peluncuran dengan tahap kustom:

  • ROLLOUT_CREATED: peluncuran baru telah dibuat.
  • ROLLOUT_STAGE_TRANSITION: tahap dalam peluncuran telah bertransisi ke status baru.
  • ROLLOUT_BLOCKED: peluncuran diblokir karena bidang kontrol atau node pool tidak memenuhi syarat untuk diupgrade.
  • ROLLOUT_AUTO_PAUSED: peluncuran telah dijeda secara otomatis oleh GKE.
  • ROLLOUT_AUTO_RESUMED: peluncuran telah dilanjutkan secara otomatis setelah dijeda.
  • ROLLOUT_CANCELLATION_WARNING: peluncuran telah dijeda terlalu lama dan akan otomatis dibatalkan dalam tujuh hari jika tidak dilanjutkan.
  • ROLLOUT_AUTO_CANCELLED: peluncuran telah otomatis dibatalkan oleh GKE.
  • ROLLOUT_COMPLETED: peluncuran telah berhasil diselesaikan.

RolloutSequenceEvent

GKE mengirimkan notifikasi untuk situasi berikut untuk urutan peluncuran dengan tahap kustom:

  • SEQUENCE_MISCONFIGURED: urutan peluncuran salah dikonfigurasi, yang berarti GKE tidak dapat melakukan upgrade dalam urutan dengan konfigurasi saat ini.
  • SEQUENCE_DEACTIVATION_WARNING: peringatan bahwa GKE akan menonaktifkan urutan peluncuran jika kesalahan konfigurasi tidak diperbaiki.

Melihat notifikasi cluster di Cloud Logging

Petunjuk berikut berlaku untuk notifikasi cluster dan notifikasi pengurutan peluncuran.

Untuk melihat log cluster GKE, lihat Mengakses log Anda.

Agar tidak menyimpan log ini, Anda dapat mengonfigurasi filter pengecualian.

Lihat log di Cloud Logging dengan filter berikut untuk melihat semua jenis notifikasi cluster:

logName=projects/PROJECT_ID/logs/container.googleapis.com%2Fnotifications

Ganti PROJECT_ID dengan project ID Google Cloud Anda.

Lihat log dengan filter berikut untuk melihat jenis notifikasi cluster tertentu, seperti UpgradeEvent:

jsonPayload.@type=type.googleapis.com/google.container.v1beta1.NOTIFICATION_TYPE

Ganti NOTIFICATION_TYPE dengan jenis notifikasi cluster untuk log yang ingin Anda lihat.

Memfilter notifikasi cluster UpgradeInfoEvent

Lihat log dengan filter berikut untuk melihat UpgradeInfoEvent tertentu, seperti notifikasi tempat operasi upgrade selesai:

jsonPayload.@type=type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
jsonPayload.eventType=EVENT_TYPE

Ganti EVENT_TYPE dengan salah satu dari yang berikut ini:

Memfilter notifikasi ke Pub/Sub

Anda dapat memfilter notifikasi cluster untuk memastikan bahwa Anda hanya menerima notifikasi yang diinginkan di Pub/Sub. Anda dapat menerapkan pemfilteran untuk notifikasi ke Pub/Sub dengan salah satu cara berikut:

Untuk melihat dan memfilter notifikasi di Cloud Logging, lihat Melihat notifikasi cluster di Cloud Logging.

Memfilter notifikasi ke Pub/Sub di GKE

Anda dapat menyiapkan pemfilteran ke Pub/Sub untuk satu atau beberapa jenis notifikasi yang tersedia saat mengaktifkan notifikasi cluster dengan menentukan nilai untuk filter dalam flag --notification-config. filter menggunakan daftar jenis notifikasi yang dipisahkan tanda pipa ( | ) yang ingin Anda terima.

Misalnya, menetapkan filter="UpgradeEvent|SecurityBulletinEvent" memberi tahu GKE untuk hanya mengirim notifikasi untuk jenis notifikasi UpgradeEvent dan SecurityBulletinEvent.

Memfilter notifikasi menggunakan filter memiliki manfaat berikut:

  • Lebih mudah digunakan, karena Anda memfilter jenis notifikasi tanpa menggunakan sintaksis khusus.
  • Notifikasi yang Anda filter tidak pernah dikirim ke Pub/Sub, sehingga Anda tidak dikenai biaya untuk pesan yang tidak terkirim.
  • Anda dapat mengedit konfigurasi filter kapan saja.

Untuk mendapatkan petunjuk tentang cara memfilter notifikasi di GKE, lihat Menerima notifikasi cluster melalui Pub/Sub.

Memfilter notifikasi di GKE tidak memengaruhi log yang muncul di Cloud Logging.

Memfilter notifikasi di Pub/Sub

Pub/Sub mendukung pemfilteran pesan dalam langganan menggunakan sintaksis pemfilteran. Saat Anda menggunakan metode ini, GKE mengirimkan semua jenis notifikasi ke topik Pub/Sub Anda. Pub/Sub memfilter pesan berdasarkan konfigurasi langganan Anda dan mengirimkan pesan yang ingin Anda terima.

Misalnya, Anda dapat memfilter notifikasi UpgradeEvent dan UpgradeAvailableEvent menggunakan sintaksis berikut dalam langganan Anda:

attributes.type_url = "type.googleapis.com/google.container.v1beta1.UpgradeEvent" OR "type.googleapis.com/google.container.v1beta1.UpgradeAvailableEvent"

Anda tetap ditagih untuk pesan yang tidak terkirim yang difilter berdasarkan langganan Anda. Anda juga tidak dapat mengubah filter setelah mengonfigurasi langganan. Namun, sintaksis pemfilteran lebih luas daripada pemfilteran di GKE.

Untuk mempelajari lebih lanjut cara memfilter langganan Pub/Sub, lihat Memfilter pesan.

Pemberitahuan tentang notifikasi cluster di Cloud Logging

Anda dapat mengonfigurasi pemberitahuan berbasis log untuk menerima notifikasi saat peristiwa cluster tertentu terjadi. Bagian berikut memberikan contoh dasar dalam menyiapkan pemberitahuan berbasis log, tetapi Anda dapat menemukan contoh lainnya di repositori contoh dasbor pemantauan.

Membuat pemberitahuan berbasis log

Untuk membuat pemberitahuan untuk jenis pemberitahuan tertentu, selesaikan langkah-langkah berikut. Langkah-langkah berikut menggunakan UpgradeEvent sebagai contoh.

  1. Di konsol Google Cloud , buka Logs Explorer.

  2. Di kolom Query, masukkan kueri berikut untuk memfilter jenis pemberitahuan yang Anda pilih:

    resource.type="RESOURCE_TYPE"
log_id("container.googleapis.com/notifications")
jsonPayload.@type="type.googleapis.com/google.container.v1beta1.NOTIFICATION_TYPE"

    Ganti kode berikut:

    • RESOURCE_TYPE: jenis resource yang ingin Anda filter, misalnya gke_cluster ATAU gke_nodepool, atau kombinasi.
    • NOTIFICATION_TYPE: Jenis notifikasi cluster yang ingin Anda beri pemberitahuan, seperti UpgradeEvent.

    Beberapa jenis notifikasi memerlukan pemfilteran tambahan. Misalnya, jika Anda ingin memfilter jenis UpgradeInfoEvent tertentu, tambahkan filter jsonPayload.eventType ke kueri Anda. Contoh kueri berikut memfilter UpgradeInfoEvent dengan jenis peristiwa UPGRADE_LIFECYCLE:

    resource.type="RESOURCE_TYPE"
log_id("container.googleapis.com/notifications")
jsonPayload.@type="type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent"
jsonPayload.eventType="UPGRADE_LIFECYCLE"

    Untuk mengetahui informasi selengkapnya tentang pemfilteran UpgradeInfoEvent, lihat Memfilter notifikasi cluster UpgradeInfoEvent.

  3. Di menu Actions, klik Create log alert.

  4. Di halaman Alert details, beri nama kebijakan pemberitahuan Anda, lalu klik Next.

    Di bagian Define log entries to alert on, kueri Anda akan diisi otomatis.

  5. Di bagian Extract log labels, klik Add a label. Mengekstrak label log membantu membuat notifikasi Anda lebih informatif. Misalnya, untuk UpgradeEvent, Anda dapat menyertakan versi saat ini dan target upgrade dengan menambahkan label berikut:

    • CurrentVersion: jsonPayload.currentVersion
    • TargetVersion: jsonPayload.targetVersion

  6. Klik Berikutnya.

  7. Konfigurasi frekuensi notifikasi dan durasi penutupan otomatis, lalu klik Next.

  8. Di bagian Who should be notified?, pilih saluran notifikasi tempat Anda ingin menerima pemberitahuan, lalu klik Save.

Setelah Anda mengonfigurasi pemberitahuan, notifikasi untuk UpgradeEvent akan menyertakan label CurrentVersion dan TargetVersion, yang memberikan konteks berharga langsung dalam notifikasi.

Memakai pesan Pub/Sub

Pesan Pub/Sub berisi dua kolom: data (string) dan attributes (peta string-ke-string).

Untuk notifikasi GKE, kolom data berisi informasi yang dapat dibaca manusia. Kolom attributes memiliki informasi notifikasi umum seperti jenis notifikasi, project ID, nama cluster, dan lokasi cluster Anda. Kolom attributes.payload adalah string yang dapat diuraikan JSON yang berisi informasi notifikasi khusus, seperti detail buletin keamanan.

Notifikasi selalu berisi atribut berikut:

Atribut Deskripsi Contoh
project_id Nomor project yang memiliki cluster. 123456789
cluster_location Lokasi cluster. us-central1-c
cluster_name Nama cluster. example-cluster
type_url Jenis notifikasi. type.googleapis.com/google.container.v1beta1.UpgradeEvent
payload String yang dapat diuraikan JSON yang berisi informasi khusus notifikasi. 
{ "resourceType":"MASTER",
  "operation":"operation-1595889094437-87b7254a",
  "operationStartTime":"2020-07-27T22:31:34.437652293Z",
  "currentVersion":"1.15.12-gke.2",
  "targetVersion":"1.15.12-gke.9"}

GKE akan selalu mengirimkan jenis notifikasi beta. Namun, Anda dapat mengurai payload untuk menampilkan jenis notifikasi GA yang sesuai jika tersedia.

Contoh pesan notifikasi cluster

Selain teks di kolom data, setiap pesan yang dikirim GKE ke Cloud Logging atau Pub/Sub memiliki nilai khusus di kolom attributes.type_url dan attributes.payload. Tabel berikut menunjukkan contoh informasi yang mungkin Anda terima untuk setiap jenis notifikasi:

SecurityBulletinEvent

Outputnya mirip dengan berikut ini untuk pesan SecurityBulletinEvent:

Atribut
type_url type.googleapis.com/google.container.v1beta1.SecurityBulletinEvent
payload 
{    "resourceTypeAffected":"RESOURCE_TYPE_CONTROLPLANE",
         "bulletinId":"GCP-2021-001",
         "cveIds":[
            "CVE-2021-3156"
         ],
         "severity":"Medium",
         "briefDescription":"A vulnerability was recently discovered in the Linux utility sudo, described in CVE-2021-3156, that may allow an attacker with unprivileged local shell access on a system with sudo installed to escalate their privileges to root on the system.",
         "affectedSupportedMinors":["1.18", "1.19"],
         "patchedVersions":["1.18.9-gke.1900", "1.19.9-gke.1900"],
         "suggestedUpgradeTarget":"1.19.9-gke.1900",
         "bulletinUri":"https://docs.cloud.google.com/kubernetes-engine/security-bulletins#gcp-2021-001"
      }

UpgradeAvailableEvent

Outputnya mirip dengan berikut ini untuk pesan UpgradeAvailableEvent:

Atribut
type_url type.googleapis.com/google.container.v1beta1.UpgradeAvailableEvent
payload 
{ "version":"1.17.15-gke.800",
  "resourceType":"MASTER",
  "releaseChannel":{"channel":"RAPID"},
  "windowsVersions": [
    {
      "imageType": "WINDOWS_SAC",
      "osVersion": "10.0.18363.1198",
      "supportEndDate": {
        "day": 10,
        "month": 5,
        "year": 2022
      }
    },
    {
      "imageType": "WINDOWS_LTSC",
      "osVersion": "10.0.17763.1577",
      "supportEndDate": {
        "day": 9,
        "month": 1,
        "year": 2024
      }
    }
  ]
}

UpgradeEvent

Outputnya mirip dengan berikut ini untuk pesan UpgradeEvent:

Atribut
type_url type.googleapis.com/google.container.v1beta1.UpgradeEvent
payload 
{ "resourceType":"MASTER",
  "operation":"operation-1595889094437-87b7254a",
  "operationStartTime":"2020-07-27T22:31:34.437652293Z",
  "currentVersion":"1.15.12-gke.2",
  "targetVersion":"1.15.12-gke.9"}

Output ini menunjukkan notifikasi untuk upgrade bidang kontrol satu langkah. Upgrade dua langkah menyertakan informasi yang berbeda dalam notifikasi. Untuk mengetahui informasi selengkapnya tentang berbagai jenis upgrade bidang kontrol, lihat Mengupgrade bidang kontrol cluster.

UpgradeInfoEvent

Outputnya mirip dengan berikut ini untuk pesan UpgradeInfoEvent saat operasi upgrade selesai, seperti contoh ini untuk upgrade node pool:

Atribut
type_url type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
payload 
{ "currentVersion":"1.31.1-gke.1846000",
  "endTime":"2024-11-06T17:12:54.111640650Z",
  "operation":"operation-1730912205658-de2f88a8-6290-4718-b2c1-fb19611060b8",
  "resource":"projects/PROJECT_ID/locations/CLUSTER_LOCATION/clusters/CLUSTER_NAME/nodePools/NODE_POOL_NAME",
  "resourceType":"NODE_POOL"
  "startTime":"2024-11-06T16:56:45.658321844Z",
  "state":"SUCCEEDED",
  "targetVersion":"1.31.1-gke.2105000"}

Output ini berbeda dengan notifikasi untuk upgrade bidang kontrol, saat pesan ditujukan untuk versi minor di atau mendekati akhir dukungan, saat versi patch baru berubah menjadi tonggak pencapaian Container-Optimized OS baru selama dukungan yang diperpanjang, atau untuk peristiwa yang mengganggu selama upgrade node pool.

Notifikasi upgrade cluster terjadwal

Saat upgrade cluster dijadwalkan dan notifikasi upgrade terjadwal diaktifkan, GKE akan mengirimkan pesan output UpgradeInfoEvent yang mirip dengan berikut untuk upgrade bidang kontrol terjadwal:

Atribut
type_url type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
payload 
{
  "insertId": "[...]",
  "jsonPayload": {
    "description": "Your cluster control plane will be upgraded to 1.32.9-gke.1239000 after 2025-12-13 12:46 UTC",
    "startTime": "2025-12-13T12:46:37.380970854Z",
    "targetVersion": "1.32.9-gke.1239000",
    "@type": "type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent",
    "currentVersion": "1.31.14-gke.1081000",
    "eventType": "UPGRADE_LIFECYCLE",
    "state": "SCHEDULED",
    "resourceType": "MASTER"
  },
  "resource": {
    "type": "gke_cluster",
    "labels": {
      "cluster_name": "CLUSTER_NAME",
      "location": "LOCATION",
      "project_id": "PROJECT_ID"
    }
  },
  "timestamp": "2025-12-10T12:46:37.989407414Z",
  "severity": "NOTICE",
  "logName": "projects/PROJECT_ID/logs/container.googleapis.com%2Fnotifications",
  "receiveTimestamp": "2025-12-10T12:46:38.007312354Z"
}

GKE mengirimkan pesan output yang mirip dengan berikut ini untuk upgrade node terjadwal:

Atribut
type_url type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
payload 
{
  "insertId": "[...]",
  "jsonPayload": {
    "description": "Your cluster node pools will be upgraded to 1.32.9-gke.1239000 (or latest target patch) after 2025-12-13 12:46 UTC: NODE_POOL_1, NODE_POOL_2, [...] and 23 more.",
    "startTime": "2025-12-13T12:46:37.380970854Z",
    "targetVersion": "1.32.9-gke.1239000",
    "@type": "type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent",
    "currentVersion": "1.31.14-gke.1081000",
    "eventType": "UPGRADE_LIFECYCLE",
    "state": "SCHEDULED",
    "resource": "projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_NAME/nodePools/NODE_POOL_1",
    "resourceType": "NODE_POOL"
  },
  "resource": {
    "type": "gke_nodepool",
    "labels": {
      "cluster_name": "CLUSTER_NAME",
      "location": "LOCATION",
      "nodepool_name": "NODE_POOL_NAME",
      "project_id": "PROJECT_ID"
    }
  },
  "timestamp": "2025-12-10T12:46:37.989407414Z",
  "severity": "NOTICE",
  "logName": "projects/PROJECT_ID/logs/container.googleapis.com%2Fnotifications",
  "receiveTimestamp": "2025-12-10T12:46:38.007312354Z"
}

Untuk upgrade node terjadwal, yang dikelompokkan menurut target upgrade otomatis, GKE mencantumkan hingga 10 node pool secara alfabetis—dengan memberikan informasi mendetail hanya untuk node pool pertama. Jika lebih dari 10 node pool dijadwalkan, GKE akan menampilkan jumlah pool yang tersisa dan tidak tercantum (misalnya, total 33 upgrade dalam contoh ini).

Langkah berikutnya