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:
- 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 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 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 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 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:
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
Di konsol Google Cloud , buka halaman Kubernetes clusters.
Pilih nama cluster Anda untuk melihat halaman Cluster Details-nya.
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 setiap node pool untuk cluster Standar. Bagian ini tidak berlaku untuk cluster Autopilot, tempat GKE mengelola node, sehingga Anda tidak perlu mengelola node pool.
Konsol
Di konsol Google Cloud , buka halaman Kubernetes clusters.
Klik nama cluster Anda 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 container node-pools get-upgrade-info POOL_NAME
--cluster=CLUSTER_NAME
Ganti POOL_NAME
dengan nama node pool.
Status upgrade otomatis cluster
Berikut adalah potensi 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 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 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 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 mengetahui kapan upgrade berikutnya 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:
- Mendapatkan informasi upgrade di tingkat project (Pratinjau). Klik tab Upgrade, tempat Anda dapat melihat tabel Status upgrade. Cari cluster Anda dalam tabel, dan lihat kolom Upgrade otomatis cluster.
- Dapatkan informasi upgrade di tingkat cluster untuk mengetahui status upgrade otomatis cluster Anda.
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:
- Notifikasi cluster: GKE mengirimkan notifikasi saat GKE menyelesaikan operasi untuk mengupgrade cluster. Untuk melihat notifikasi ini, filter
UpgradeInfoEvent
saat Anda melihat notifikasi cluster di Cloud Logging. - Dasbor upgrade (Pratinjau): Buka tabel Status upgrade di konsol Google Cloud . Temukan cluster Anda. Jika kolom Status menampilkan Diupgrade, lihat dari kolom Update terbaru kapan upgrade selesai.
- Mendapatkan informasi upgrade di tingkat cluster: Gunakan gcloud CLI untuk menemukan histori upgrade cluster Anda, yang mencakup upgrade terbaru.
Mengetahui 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 bidang 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:
- 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 tanggal akhir dukungan standar. Untuk cluster yang berada di channel Extended, lihat tanggal akhir dukungan yang diperpanjang.
- Notifikasi cluster: GKE mengirimkan notifikasi saat
cluster menjalankan versi minor di 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 Anda menjalankan versi minor setelah akhir dukungan standar. Untuk mengetahui informasi selengkapnya, lihat Mengidentifikasi cluster yang menjalankan versi minor yang melewati 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.