Mendapatkan visibilitas ke upgrade cluster

Halaman ini menjelaskan cara mendapatkan informasi tentang upgrade untuk cluster Google Kubernetes Engine (GKE). GKE secara otomatis mengupgrade semua cluster dari waktu ke waktu. Saat mengupgrade cluster, GKE mengupdate versi bidang kontrol Kubernetes dan worker node dalam operasi terpisah.

GKE menggabungkan informasi tentang upgrade cluster untuk membantu Anda lebih memahami status cluster Anda. Anda bisa mendapatkan informasi berikut untuk cluster:

  • Upgrade terjadwal (Pratinjau): GKE akan memberi tahu Anda setidaknya 72 jam sebelum upgrade otomatis bidang kontrol cluster. Saat Anda mengaktifkan upgrade terjadwal, GKE tetap mengupgrade bidang kontrol cluster secara otomatis secara berkala, tetapi hanya setelah memberikan pemberitahuan lanjutan ini. Jika Anda tidak diberi tahu sebelumnya, bidang kontrol cluster Anda tidak akan diupgrade.
  • Target upgrade otomatis: Temukan versi baru yang ditargetkan GKE untuk cluster Anda, yang bisa berupa patch atau versi minor baru, bergantung pada versi dan batasan yang ada di cluster Anda. Jika tidak ada target upgrade otomatis, cluster sudah menggunakan target upgrade terbaru, atau GKE belum menetapkan target upgrade otomatis karena alasan teknis atau bisnis. Anda juga dapat mengambil target upgrade otomatis umum berdasarkan versi minor cluster dalam catatan rilis GKE Pembaruan versi, seperti catatan 2024-R33.
  • Status upgrade otomatis: Cluster GKE memiliki status untuk upgrade cluster. Gunakan status ini untuk mempelajari lebih lanjut upgrade saat ini, dan batasan yang dipertimbangkan GKE saat memilih waktu untuk mengupgrade cluster Anda secara otomatis, termasuk faktor-faktor seperti pengecualian pemeliharaan atau alasan yang mencegah upgrade. Untuk mempelajari lebih lanjut, lihat Status upgrade otomatis cluster.

  • Histori upgrade: GKE memberikan ringkasan upgrade bidang kontrol dan upgrade node terbaru untuk cluster Anda, termasuk upgrade otomatis dan manual. Untuk upgrade node dan bidang kontrol terbaru, Anda dapat melihat detail seperti berikut:

    • Versi: versi awal dan target.
    • Status: apakah upgrade masih berjalan, atau berhasil, gagal, atau dibatalkan.
    • Waktu: waktu mulai dan berakhir.
    • Jenis mulai: apakah upgrade dipicu secara otomatis atau manual.

  • Tanggal akhir dukungan: GKE mendukung versi minor hingga 24 bulan. Untuk mempelajari lebih lanjut, lihat siklus proses versi minor GKE. Untuk mengetahui tanggal akhir dukungan semua versi minor saat ini, lihat Perkiraan jadwal untuk saluran rilis.

  • Peristiwa cluster: GKE mengirimkan notifikasi cluster ke Cloud Logging untuk peristiwa tertentu, seperti saat upgrade dimulai atau selesai, saat versi baru tersedia, buletin keamanan, dan tanggal akhir dukungan. Selain GKE yang menampilkan peristiwa ini secara otomatis dengan Cloud Logging, Anda juga dapat merutekan notifikasi ini ke Pub/Sub. Untuk mempelajari lebih lanjut, lihat Notifikasi cluster.

Sebelum memulai

Sebelum memulai, pastikan Anda telah melakukan 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 perintah gcloud components update. gcloud CLI versi sebelumnya mungkin tidak mendukung menjalankan perintah dalam dokumen ini.

Mendapatkan notifikasi tentang upgrade cluster terjadwal

Anda dapat mengaktifkan upgrade terjadwal agar GKE memberi tahu Anda sebelumnya tentang upgrade otomatis bidang kontrol cluster. Jika Anda mengaktifkan fitur keikutsertaan ini, GKE akan memublikasikan notifikasi cluster ke Cloud Logging, atau, secara opsional, ke Pub/Sub, yang memberi tahu Anda tentang waktu mulai upgrade, versi target, dan control plane cluster mana yang akan diupgrade. GKE akan memberi tahu Anda antara 72 dan 96 jam sebelum waktu mulai. GKE memulai upgrade dalam waktu delapan jam dari waktu mulai terjadwal ke salah satu dari berikut ini:

  • Versi GKE yang dinyatakan dalam notifikasi
  • Patch yang lebih baru dalam versi minor yang sama jika patch menjadi target upgrade otomatis di saluran rilis cluster Anda sebelum upgrade

Notifikasi upgrade terjadwal memberikan kepastian tentang kapan GKE akan memulai upgrade bidang kontrol. Namun, notifikasi ini tidak menjamin bahwa GKE akan mengupgrade cluster Anda pada waktu yang ditentukan. Selain itu, notifikasi hanya memberi tahu Anda kapan upgrade dimulai, dan tidak menjamin apakah upgrade akan selesai.

Jika Anda tidak mengaktifkan fitur ini, GKE akan tetap mengupgrade bidang kontrol cluster Anda secara otomatis. Namun, perilaku default tanpa fitur ini adalah Anda tidak menerima notifikasi upgrade terjadwal sebelumnya.

Tinjau bagian berikut untuk memahami tindakan yang dapat Anda lakukan, atau tidak dapat Anda lakukan, saat Anda menerima notifikasi upgrade terjadwal, dan alasan lain mengapa GKE mungkin tidak mengupgrade cluster pada waktu yang ditentukan.

Yang harus dilakukan saat Anda mendapatkan notifikasi upgrade terjadwal

Jika Anda siap untuk melanjutkan upgrade terjadwal pada waktu yang diberikan dalam notifikasi, Anda tidak perlu melakukan tindakan lebih lanjut, selain memantau kondisi lingkungan cluster dan workload Anda saat GKE memulai upgrade otomatis.

Atau, Anda dapat melakukan beberapa tindakan berikut, yang akan memengaruhi waktu upgrade:

Alasan GKE mungkin tidak melakukan upgrade terjadwal

GKE mungkin tidak melakukan upgrade terjadwal pada waktu yang ditentukan jika masalah dengan versi teramati antara saat notifikasi dikirim dan saat upgrade dijadwalkan untuk dimulai. Untuk mengetahui informasi selengkapnya, lihat Menemukan apa yang menghalangi upgrade berikutnya cluster Anda.

Jika GKE membatalkan upgrade terjadwal, baik karena tindakan Anda atau keadaan tak terduga lainnya, GKE akan mengirimkan notifikasi cluster lain saat upgrade dijadwalkan ulang.

Batasan

  • Anda tidak dapat mengaktifkan upgrade terjadwal dengan pengurutan peluncuran.
  • GKE tidak mengirimkan notifikasi untuk upgrade terjadwal yang dibatalkan. GKE hanya mengirimkan notifikasi untuk upgrade terjadwal baru.
  • Jika Anda mengaktifkan upgrade terjadwal, pengaktifan ini dapat menyebabkan upgrade otomatis diselesaikan lebih lambat daripada tanpa mengaktifkan notifikasi. Efek ini terjadi karena, untuk setiap upgrade, GKE perlu memberikan pemberitahuan minimal 72 jam, mematuhi periode mulai 8 jam, dan mematuhi masa pemeliharaan, jika Anda telah mengonfigurasi masa pemeliharaan untuk cluster. Jika Anda memerlukan upgrade untuk dilanjutkan di cluster dengan efisiensi maksimum, sebaiknya jangan gunakan fitur ini. Anda juga dapat mengaktifkan fitur ini, tetapi menggunakan upgrade manual untuk memajukan upgrade jika diperlukan.
  • GKE hanya memberikan pemberitahuan awal untuk upgrade versi bidang kontrol, dan bukan untuk upgrade node pool atau jenis update node lainnya. Untuk informasi selengkapnya tentang perbedaan antara upgrade (update versi) dan jenis update lainnya, lihat Mengelola perubahan siklus proses cluster untuk meminimalkan gangguan.
  • Anda tidak dapat mengaktifkan atau menonaktifkan upgrade terjadwal dengan Terraform.

  • Notifikasi upgrade terjadwal hanya memberikan jaminan bahwa upgrade bidang kontrol otomatis tidak dimulai tanpa notifikasi sebelumnya. Namun, notifikasi tidak menjamin hal berikut:

    • Upgrade tidak dijamin dimulai pada waktu yang tepat, hanya dalam jangka waktu mulai 8 jam.
    • GKE tidak dijamin akan memulai upgrade dalam jangka waktu tersebut. Untuk mengetahui informasi selengkapnya, lihat Alasan GKE mungkin tidak melakukan upgrade terjadwal.
    • Tidak ada jaminan bahwa GKE akan otomatis mengupgrade bidang kontrol Anda ke versi patch yang tepat, jika ada target upgrade otomatis patch yang lebih baru dengan versi minor yang sama di saluran rilis.

Mengaktifkan upgrade terjadwal

Aktifkan upgrade terjadwal, dengan mengganti CLUSTER_NAME dengan nama cluster:

gcloud beta container clusters update CLUSTER_NAME
   --enable-scheduled-upgrades

Setelah mengaktifkan upgrade terjadwal, Anda dapat melihat notifikasi dengan Cloud Logging, atau mengonfigurasi notifikasi dengan Pub/Sub. Untuk mengetahui informasi selengkapnya, lihat Notifikasi cluster.

Saat Anda mendapatkan notifikasi upgrade terjadwal, tinjau Yang harus dilakukan saat Anda mendapatkan notifikasi upgrade terjadwal.

Menonaktifkan upgrade terjadwal

Nonaktifkan upgrade terjadwal, dengan mengganti CLUSTER_NAME dengan nama cluster:

gcloud beta container clusters update CLUSTER_NAME
   --disable-scheduled-upgrades

Setelah Anda menonaktifkan fitur ini, GKE tidak akan lagi memberi tahu Anda tentang upgrade terjadwal.

Mendapatkan informasi tentang upgrade cluster

Anda bisa mendapatkan informasi proaktif tentang upgrade cluster menggunakan KonsolGoogle Cloud atau gcloud CLI.

Mendapatkan informasi tentang upgrade di tingkat project

Untuk mendapatkan informasi gabungan tentang upgrade cluster di seluruh project, Anda dapat menggunakan dasbor Upgrade.

Di konsol Google Cloud , buka dasbor Upgrade:

Buka Upgrade

Tab yang disertakan dalam dasbor ini menggabungkan informasi yang relevan tentang upgrade seperti berikut:

  • Status upgrade bidang kontrol dan node terbaru
  • Log notifikasi cluster untuk upgrade
  • Rekomendasi yang terkait dengan upgrade
  • Linimasa akhir dukungan untuk versi minor tertentu
  • Jumlah cluster di setiap saluran rilis

Mendapatkan informasi upgrade di tingkat cluster

Konsol

  1. Di konsol Google Cloud , buka halaman Kubernetes clusters.

    Buka cluster Kubernetes

  2. Pilih nama cluster Anda untuk melihat halaman Cluster Details-nya.

  3. Di halaman Cluster Details, lihat bagian Cluster upgrades.

gcloud

Jalankan perintah berikut:

gcloud container clusters get-upgrade-info CLUSTER_NAME

Ganti CLUSTER_NAME dengan nama cluster.

Mendapatkan informasi upgrade untuk node pool cluster Standard

Anda dapat melihat perincian node pool individual untuk cluster Standar. Bagian ini tidak berlaku untuk cluster Autopilot, tempat GKE mengelola node, sehingga Anda tidak perlu mengelola node pool.

Konsol

  1. Di konsol Google Cloud , buka halaman Kubernetes clusters.

    Buka cluster Kubernetes

  2. Klik nama cluster Anda untuk melihat detailnya.

  3. Klik tab Nodes.

  4. Di bagian Node Pools, klik nama node pool yang ingin Anda dapatkan informasi upgrade-nya.

  5. Di halaman Node pool details, lihat bagian Upgrades.

gcloud

Jalankan perintah berikut:

gcloud container node-pools get-upgrade-info POOL_NAME
    --cluster=CLUSTER_NAME

Ganti POOL_NAME dengan nama node pool.

Status upgrade otomatis cluster

Berikut adalah kemungkinan status upgrade otomatis untuk cluster:

  • ACTIVE: Status upgrade aktif.
  • UNKNOWN: Status upgrade tidak diketahui.
  • MINOR_UPGRADE_PAUSED: Upgrade versi minor dijeda.
  • UPGRADE_PAUSED: Semua upgrade otomatis dijeda.

Berikut adalah kemungkinan alasan GKE menjeda upgrade otomatis untuk cluster:

  • MAINTENANCE_WINDOW: Masa pemeliharaan mencegah upgrade cluster.
  • MAINTENANCE_EXCLUSION_: Alasan dijeda dengan awalan ini menunjukkan bahwa pengecualian pemeliharaan mencegah upgrade cluster. Akhiran menunjukkan cakupan pengecualian pemeliharaan, seperti MAINTENANCE_EXCLUSION_NO_UPGRADES.
  • CLUSTER_DISRUPTION_BUDGET: Setelah operasi tertentu, seperti pembuatan atau upgrade cluster, cluster memerlukan periode pendinginan untuk melindungi stabilitas dan ketersediaan cluster serta aplikasinya.
  • CLUSTER_DISRUPTION_BUDGET_MINOR_UPGRADE: Cluster berada di luar anggaran gangguan cluster untuk upgrade versi minor.
  • SYSTEM_CONFIG: Upgrade otomatis dijeda untuk sementara waktu karena alasan teknis atau bisnis. Dengan status ini, sebaiknya jangan lakukan upgrade manual kecuali jika diperlukan.
  • AUTO_UPGRADE_PAUSED_REASON_UNSPECIFIED: Alasan yang tidak ditentukan.

Menemukan informasi tentang skenario umum untuk upgrade cluster

Temukan informasi tentang skenario umum yang mungkin Anda alami saat mengelola upgrade cluster.

Menemukan kapan upgrade berikutnya untuk cluster Anda akan dilakukan

Untuk mempelajari kapan upgrade berikutnya pada cluster Anda akan dilakukan sehingga Anda dapat merencanakan dan memenuhi syarat upgrade ke versi baru, gunakan referensi berikut:

  • Jadwal rilis: Di perkiraan jadwal untuk saluran rilis, temukan perkiraan tanggal upgrade otomatis yang sesuai dengan versi minor dan saluran rilis cluster Anda.
  • Mendapatkan informasi upgrade di tingkat cluster: Temukan target upgrade otomatis cluster Anda.
  • Notifikasi cluster: GKE mengirimkan notifikasi saat versi baru tersedia di saluran. Setelah versi baru tersedia, dengan waktu yang bergantung pada saluran, GKE menetapkan versi tersebut sebagai target upgrade otomatis di saluran. Untuk melihat notifikasi ini, filter UpgradeAvailableEvent saat Anda melihat notifikasi cluster di Cloud Logging.
  • Catatan rilis: Ikuti catatan rilis untuk mempelajari kapan GKE menetapkan versi minor baru sebagai target upgrade otomatis di saluran.

Menemukan apa yang menghalangi upgrade berikutnya pada cluster Anda

Untuk mengetahui apa yang menghalangi upgrade sehingga Anda dapat mengatasinya, temukan status upgrade otomatis cluster Anda. Jika upgrade otomatis dijeda, lihat alasannya. Gunakan salah satu metode berikut:

Menemukan kapan upgrade cluster Anda selesai

Untuk mengetahui kapan upgrade node dan panel kontrol cluster Anda selesai sehingga Anda dapat memverifikasi bahwa beban kerja Anda berfungsi seperti yang diharapkan, gunakan referensi berikut:

Menemukan perkiraan durasi upgrade

Untuk mengetahui perkiraan durasi upgrade, Anda dapat menemukan durasi upgrade sebelumnya dengan mendapatkan informasi upgrade di tingkat cluster. Lihat histori upgrade untuk contoh terbaru.

Durasi upgrade bergantung pada apakah panel kontrol atau node sedang diupgrade, strategi upgrade, Anggaran Gangguan Pod (PDB), kebijakan pemeliharaan aktif, dan faktor lainnya.

Menemukan kapan versi minor cluster Anda mencapai akhir dukungan

GKE secara otomatis mengupgrade cluster yang masih menjalankan versi minor setelah tanggal akhir dukungan. Untuk mengetahui informasi selengkapnya, lihat Upgrade otomatis di akhir dukungan.

Untuk mempelajari kapan versi minor cluster Anda mencapai akhir dukungan—misalnya, untuk menetapkan pengecualian pemeliharaan atau memahami kapan API yang tidak digunakan lagi tidak dapat digunakan lagi—gunakan referensi berikut:

Langkah berikutnya