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 akan mengupdate versi bidang kontrol Kubernetes dan node pekerja dalam operasi terpisah.

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

  • Target upgrade otomatis: Temukan versi baru yang ditargetkan GKE untuk cluster Anda, yang dapat berupa patch atau versi minor baru, bergantung pada versi dan batasan cluster yang ada. 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 di 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 tentang upgrade control plane 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:

    • Versions: versi awal dan target.
    • Status: apakah upgrade masih berjalan, atau berhasil, gagal, atau dibatalkan.
    • Waktu: waktu mulai dan waktu 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 untuk 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 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 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.

Mendapatkan informasi tentang upgrade cluster

Anda bisa mendapatkan informasi tentang upgrade cluster menggunakan Konsol Google 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 node dan bidang kontrol 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 untuk melihat halaman Cluster Details-nya.

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

gcloud

Jalankan perintah berikut:

gcloud beta container clusters get-upgrade-info CLUSTER_NAME

Ganti CLUSTER_NAME dengan nama cluster.

Mendapatkan informasi upgrade untuk node pool cluster Standard

Anda bisa mendapatkan visibilitas ke setiap kumpulan node untuk cluster Standar. Bagian ini tidak berlaku untuk cluster Autopilot, tempat GKE mengelola node, sehingga tidak ada node pool yang dapat Anda kelola.

Konsol

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

    Buka cluster Kubernetes

  2. Klik nama cluster 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 beta container node-pools get-upgrade-info POOL_NAME
    --cluster=CLUSTER_NAME

Ganti POOL_NAME dengan nama node pool.

Status upgrade otomatis cluster

Berikut adalah status potensial 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 potensi 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 tunggu 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 temui saat mengelola upgrade cluster.

Menemukan kapan upgrade cluster berikutnya akan dilakukan

Untuk mempelajari kapan upgrade cluster berikutnya 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 penyebab yang memblokir upgrade cluster berikutnya

Untuk mempelajari apa yang memblokir upgrade sehingga Anda dapat berhenti memblokirnya, temukan status upgrade otomatis cluster. Jika upgrade otomatis dijeda, lihat alasannya. Gunakan salah satu metode berikut:

Menemukan kapan upgrade cluster selesai

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

Menemukan perkiraan waktu yang diperlukan untuk melakukan upgrade

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

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

Menemukan kapan versi minor cluster Anda mencapai akhir dukungan

GKE otomatis mengupgrade cluster yang masih menjalankan versi minor setelah tanggal akhir dukungannya. Untuk 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 akan dapat digunakan lagi—gunakan referensi berikut:

Langkah berikutnya