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:
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
Di konsol Google Cloud, buka halaman Kubernetes clusters.
Pilih nama cluster untuk melihat halaman Cluster Details-nya.
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
Di konsol Google Cloud, buka halaman Kubernetes clusters.
Klik nama cluster untuk melihat detailnya.
Klik tab Nodes.
Di bagian Node Pools, klik nama node pool yang ingin Anda dapatkan informasi upgrade-nya.
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, sepertiMAINTENANCE_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:
- Mendapatkan informasi upgrade di tingkat project (Pratinjau). Klik tab Upgrade, tempat Anda dapat melihat tabel Status upgrade. Cari cluster Anda di tabel, dan lihat kolom Upgrade otomatis cluster.
- Mendapatkan informasi upgrade di tingkat cluster untuk menemukan status upgrade otomatis cluster Anda.
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:
- Notifikasi cluster: GKE mengirimkan notifikasi saat GKE menyelesaikan operasi untuk mengupgrade cluster. Untuk melihat pemberitahuan ini, filter
UpgradeInfoEvent
saat Anda melihat pemberitahuan cluster di Cloud Logging. - Dasbor upgrade (Pratinjau): Buka tabel Status upgrade di konsol Google Cloud. Temukan cluster Anda. Jika kolom Status bertuliskan Diupgrade, lihat dari kolom Update terbaru saat upgrade selesai.
- Mendapatkan informasi upgrade di tingkat cluster: Gunakan gcloud CLI untuk menemukan histori upgrade cluster, yang mencakup upgrade terbaru.
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:
- Jadwal rilis: Di perkiraan jadwal untuk saluran rilis, temukan tanggal akhir dukungan yang sesuai dengan versi minor dan saluran rilis cluster Anda. Untuk cluster yang tidak berada di saluran Extended, lihat akhir tanggal dukungan standar. Untuk cluster yang berada di saluran yang Diperluas, lihat tanggal akhir dukungan yang diperluas.
- Notifikasi cluster: GKE mengirimkan notifikasi saat
cluster menjalankan versi minor pada atau mendekati akhir dukungan. Untuk melihat notifikasi ini, filter
UpgradeInfoEvent
saat Anda melihat notifikasi cluster di Cloud Logging. - Insight dan rekomendasi: GKE memberi tahu Anda saat cluster menjalankan versi minor setelah akhir dukungan standar. Untuk informasi selengkapnya, lihat Mengidentifikasi cluster yang menjalankan versi minor setelah akhir dukungan standar.
- Mendapatkan informasi upgrade di tingkat cluster: Temukan tanggal akhir dukungan versi minor cluster Anda.
- Dasbor upgrade (Pratinjau): Dasbor Upgrade menyertakan bagian Akhir dukungan versi dengan versi tertentu dan sisa hari hingga akhir dukungan.