Halaman ini memberikan ringkasan tentang proses upgrade dan informasi kemiringan versi untuk Google Distributed Cloud (khusus software)" untuk cluster VMware. Informasi ini akan membantu Anda merencanakan urutan upgrade cluster di lingkungan multi-cluster. Untuk informasi perencanaan yang lebih mendetail, termasuk checklist untuk membantu Anda merencanakan upgrade, lihat Praktik terbaik upgrade.
Halaman ini ditujukan untuk Operator dan administrator IT yang mengelola siklus proses infrastruktur teknologi yang mendasarinya. Untuk mempelajari lebih lanjut peran umum dan contoh tugas yang kami referensikan dalam konten Google Cloud , lihat Peran dan tugas pengguna GKE Enterprise umum.
Aturan versi
Aturan untuk upgrade bergantung pada versi minor cluster.
Untuk versi 1.30 dan yang lebih lama, versi minor cluster pengguna harus lebih besar atau sama dengan versi minor cluster admin. Versi patch tidak penting. Misalnya, jika cluster pengguna menggunakan versi 1.30.1, cluster admin dapat diupgrade ke versi patch yang lebih tinggi, seperti 1.30.3.
Untuk versi 1.31 dan yang lebih tinggi, versi cluster admin, termasuk versi patch, harus lebih besar dari atau sama dengan versi cluster pengguna. Misalnya, jika cluster admin menggunakan versi 1.31.1, versi tertinggi yang dapat diupgrade oleh cluster pengguna adalah 1.31.1.
Jika ingin mengupgrade cluster ke versi 1.31, Anda harus mengupgrade semua cluster ke versi 1.30 terlebih dahulu. Setelah semua cluster berada di versi 1.30, Anda harus mengupgrade cluster admin ke versi 1.31. Setelah itu, Anda dapat mengupgrade cluster pengguna ke versi patch 1.31 yang sama dengan cluster admin.
Untuk informasi tentang perbedaan versi antara cluster admin dan pengguna, lihat bagian Perbedaan versi dalam dokumen ini.
Urutan upgrade
Urutan upgrade cluster admin dan pengguna bergantung pada versi cluster yang menjadi tujuan upgrade Anda, yang disebut sebagai versi target:
1.31 dan yang lebih tinggi
Jika versi target adalah 1.31 atau yang lebih baru, Anda harus mengupgrade cluster admin sebelum mengupgrade cluster pengguna yang dikelola oleh cluster admin. Langkah-langkah berikut menjelaskan urutan upgrade.
Upgrade workstation admin. Sebaiknya lakukan hal ini meskipun Anda berencana menggunakan konsol Google Cloud , Google Cloud CLI, atau Terraform untuk mengupgrade cluster pengguna.
Mengupgrade cluster admin.
Upgrade cluster pengguna, satu per satu.
Secara opsional, Anda dapat mengupgrade bidang kontrol cluster pengguna secara terpisah dari node pool di cluster pengguna. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade node pool.
Tidak tersedia untuk cluster lanjutan.
Secara opsional, Anda dapat melewati versi minor saat mengupgrade node pool. Untuk mengetahui informasi selengkapnya, lihat Lewati versi saat mengupgrade node pool.
Tidak tersedia untuk cluster lanjutan.
Setelah semua node pool di cluster pengguna memiliki versi yang sama dengan bidang kontrol cluster pengguna, cluster pengguna akan diupgrade sepenuhnya.
1.30 dan yang lebih lama
Jika versi target adalah 1.30 atau yang lebih lama, Anda harus mengupgrade semua cluster pengguna sebelum mengupgrade cluster admin yang mengelolanya.
Upgrade workstation admin. Sebaiknya lakukan hal ini meskipun Anda berencana menggunakan konsol Google Cloud , Google Cloud CLI, atau Terraform untuk mengupgrade cluster pengguna.
Upgrade cluster pengguna, satu per satu.
Pada versi 1.14 dan yang lebih baru, Anda dapat mengupgrade panel kontrol cluster pengguna secara terpisah dari node pool di cluster pengguna.
Pada versi 1.16 dan yang lebih baru, Anda dapat memilih untuk melewati versi minor saat mengupgrade node pool. Untuk informasi selengkapnya, lihat Lewati versi saat mengupgrade node pool.
Setelah semua node pool di cluster pengguna memiliki versi yang sama dengan bidang kontrol cluster pengguna, cluster pengguna akan diupgrade sepenuhnya.
Cluster admin tidak boleh memiliki versi minor yang lebih tinggi daripada cluster pengguna yang dikelolanya. Jika salah satu cluster pengguna Anda memiliki versi minor yang sama dengan cluster admin, Anda tidak dapat mengupgrade cluster admin.
Jika semua cluster pengguna setidaknya satu versi minor lebih baru dari cluster admin, Anda dapat mengupgrade cluster admin secara opsional.
Skew versi dan aturan versi untuk upgrade telah berubah di versi 1.28 dan yang lebih baru. Untuk informasi selengkapnya, lihat bagian Ketidakselarasan versi dalam dokumen ini.
Upgrade cluster admin
1.31 dan yang lebih tinggi
Jika versi targetnya adalah 1.31 atau yang lebih tinggi, Anda harus mengupgrade cluster admin terlebih dahulu, lalu mengupgrade cluster pengguna.
Anda dapat menggunakan gkectl atau gcloud CLI untuk mengupgrade cluster admin.
1.30 dan yang lebih lama
Jika versi targetnya adalah 1.30 atau lebih rendah, upgrade semua cluster pengguna terlebih dahulu, lalu upgrade cluster admin. Anda dapat mengupgrade cluster admin jika bidang kontrol dan kumpulan node di semua cluster pengguna setidaknya memiliki satu versi minor yang lebih tinggi daripada cluster admin.
Hanya gkectl yang mendukung upgrade cluster admin. Klien GKE On-Prem API
tidak mendukung upgrade cluster admin.
Upgrade cluster pengguna
Saat mengupgrade cluster pengguna, Anda dapat memilih untuk mengupgrade cluster pengguna secara keseluruhan (artinya Anda dapat mengupgrade bidang kontrol dan semua node pool dalam cluster), atau Anda dapat mengupgrade bidang kontrol cluster pengguna dan membiarkan node pool pada versi saat ini. Pendekatan yang Anda ambil bergantung pada beberapa faktor, seperti:
- Lingkungan (produksi atau non-produksi) tempat cluster berada.
- Durasi masa pemeliharaan Anda.
- Versi cluster pengguna.
Misalnya, di lingkungan pengembangan, Anda mungkin ingin menjaga prosesnya agar sederhana dan mengupgrade panel kontrol cluster pengguna serta semua kumpulan node. Namun, di lingkungan produksi dengan periode pemeliharaan yang singkat, Anda mungkin ingin hanya mengupgrade bidang kontrol karena memerlukan lebih sedikit waktu dan dengan bidang kontrol ketersediaan tinggi (HA), upgrade bidang kontrol tidak boleh mengganggu beban kerja pengguna. Jika panel kontrol menggunakan versi 1.28 atau yang lebih baru, Anda dapat melewati versi minor saat mengupgrade node pool.
Tidak tersedia di cluster lanjutan.
Mengupgrade node pool secara selektif
Dalam situasi tertentu, Anda mungkin ingin mengupgrade beberapa, tetapi tidak semua node pool di cluster pengguna. Misalnya, setelah mengupgrade control plane, Anda dapat mengupgrade node pool yang memiliki traffic ringan atau menjalankan workload yang paling tidak penting. Setelah yakin bahwa beban kerja Anda berjalan dengan benar di versi baru, Anda dapat mengupgrade node pool tambahan, hingga akhirnya semua node pool diupgrade. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade node pool.
Melewati versi minor saat mengupgrade node pool
Jika cluster Anda menggunakan versi 1.16 atau yang lebih tinggi, Anda dapat melewati versi minor saat mengupgrade node pool. Melakukan upgrade versi lewati akan mengurangi waktu upgrade node pool dua versi secara berurutan menjadi setengah. Selain itu, upgrade versi lewati memungkinkan Anda meningkatkan waktu antara upgrade yang diperlukan untuk tetap menggunakan versi yang didukung. Mengurangi jumlah upgrade akan mengurangi gangguan workload dan waktu verifikasi. Untuk informasi selengkapnya, lihat Lewati versi saat mengupgrade node pool.
Memilih alat untuk mengupgrade cluster pengguna
Google Distributed Cloud menyediakan pilihan alat untuk mengupgrade cluster pengguna.
Alat command line
gkectl, yang Anda jalankan di workstation admin. Sebelum upgrade, Anda perlu mengubah file konfigurasi cluster pengguna untuk menetapkan versi target untuk bidang kontrol cluster dan secara opsional, untuk kumpulan node. Anda menentukan file ini di command line kegkectl.Jika cluster lanjutan diaktifkan, Anda harus menggunakan
gkectluntuk upgrade. Klien GKE On-Prem API tidak didukung di cluster lanjutan.Konsol Google Cloud , Google Cloud CLI, atau Terraform, yang dapat Anda jalankan dari komputer apa pun yang memiliki konektivitas jaringan ke GKE On-Prem API. Alat standar ini adalah klien dari GKE On-Prem API, yang berjalan di infrastruktur Google Cloud .
Anda dapat menggunakan Terraform untuk upgrade hanya jika membuat cluster pengguna menggunakan Terraform.
Jika cluster pengguna Anda dibuat menggunakan
gkectl, cluster tersebut harus terdaftar di GKE On-Prem API untuk menggunakan konsol atau gcloud CLI untuk upgrade. Di versi 1.16 dan yang lebih baru, cluster yang dibuat menggunakangkectlterdaftar di GKE On-Prem API secara default. Untuk cluster yang dibuat di versi sebelumnya, Anda dapat mendaftarkan cluster setelah dibuat.Meskipun Anda memutuskan untuk menggunakan
gkectluntuk upgrade, sebaiknya daftarkan cluster di GKE On-Prem API untuk mendapatkan informasi tentang cluster menggunakan konsol atau gcloud CLI.
Alat yang Anda gunakan bergantung pada cara Anda berencana mengupgrade cluster pengguna:
Mengupgrade cluster secara keseluruhan: Anda dapat menggunakan
gkectl, konsol Google Cloud , Google Cloud CLI, atau Terraform untuk mengupgrade cluster pengguna (panel kontrol beserta semua node pool).Hanya mengupgrade panel kontrol: Anda dapat menggunakan
gkectl, gcloud CLI, atau Terraform untuk mengupgrade panel kontrol cluster pengguna secara terpisah dari node pool. Konsol tidak mendukung upgrade hanya pada bidang kontrol.Mengupgrade node pool secara selektif setelah panel kontrol diupgrade: Anda dapat menggunakan
gkectl, gcloud CLI, atau Terraform untuk mengupgrade node pool tertentu setelah panel kontrol diupgrade.Mengupgrade panel kontrol dan satu atau beberapa node pool secara bersamaan: Hanya
gkectlyang mendukung kasus penggunaan ini.
Skew versi
Skew versi adalah perbedaan versi minor antara cluster admin dan cluster pengguna terkelolanya. Di bagian berikut, versi cluster pengguna mengacu pada versi bidang kontrol dan kumpulan node secara bersamaan, secara keseluruhan.
Selain itu, skew versi adalah perbedaan versi minor antara panel kontrol cluster pengguna dan node pool di cluster pengguna.
Dalam lingkungan multi-cluster, memahami penyimpangan versi yang didukung dan aturan versi untuk upgrade dapat membantu Anda merencanakan urutan upgrade cluster.
Skew versi cluster admin dan pengguna
Cluster admin dapat mengelola cluster pengguna yang memiliki versi berbeda. Kemampuan ini memungkinkan Anda mengupgrade sejumlah cluster pengguna sesuai jadwal yang cocok untuk organisasi Anda.
1.31 dan yang lebih tinggi
Pada versi 1.31 dan yang lebih baru, cluster admin dapat memiliki hingga 2 versi minor yang lebih tinggi daripada cluster penggunanya. Misalnya, jika cluster admin berada di versi 1.31, cluster pengguna yang dikelola oleh cluster admin tersebut dapat berada di versi 1.29, 1.30, atau 1.31.
Secara umum, jika 1.n adalah versi minor cluster admin, cluster pengguna dapat berada di 1.n-2, 1.n-1, atau 1.n. Cluster admin tidak dapat diupgrade ke versi minor berikutnya hingga semua cluster pengguna berada di 1.n atau 1.n-1.
1.29 - 1.30
Skew versi sama dengan di versi 1.28. Di versi 1.29, fitur ini ditransisikan ke tahap Ketersediaan Umum.
Pada versi 1.29 dan yang lebih baru, cluster pengguna dapat memiliki hingga 2 versi minor lebih tinggi daripada cluster adminnya. Misalnya, jika cluster admin berada di versi 1.29, cluster pengguna yang dikelola oleh cluster admin tersebut dapat berada di versi 1.29, 1.30, atau 1.31.
Secara umum, jika 1.n adalah versi minor cluster admin, cluster pengguna dapat berada di 1.n, 1.n+1, atau 1.n+2. Cluster pengguna di 1.n+2 tidak dapat
diupgrade ke versi minor berikutnya hingga cluster admin diupgrade setidaknya
satu versi minor.
1,28
Pada versi 1.28, cluster pengguna dapat memiliki hingga 2 versi minor yang lebih tinggi daripada cluster adminnya. Misalnya, jika cluster admin berada di versi 1.15, cluster pengguna yang dikelola oleh cluster admin tersebut dapat berada di versi 1.15, 1.16, atau 1.28. Cluster pengguna versi 1.28 tidak dapat diupgrade ke 1.29 hingga cluster admin diupgrade ke setidaknya 1.16.
1.16 dan yang lebih lama
Pada versi 1.16 dan yang lebih lama, cluster pengguna hanya boleh 1 versi minor lebih tinggi daripada cluster adminnya. Misalnya, jika cluster admin berada di versi 1.15, cluster pengguna yang dikelola oleh cluster admin tersebut dapat berada di versi 1.15 atau 1.16.
Secara umum, jika 1.n adalah versi minor cluster admin, cluster pengguna dapat berada di 1.n atau 1.n+1. Cluster pengguna tidak dapat diupgrade ke
versi minor berikutnya hingga cluster admin berada di versi minor yang sama dengan
cluster pengguna.
Ketidaksesuaian versi node pool dan bidang kontrol cluster pengguna
1.29 dan yang lebih tinggi
Skew versi sama dengan di versi 1.28. Di versi 1.29, fitur ini ditransisikan ke tahap Ketersediaan Umum.
Pada versi 1.29 dan yang lebih baru, panel kontrol cluster pengguna dapat berisi hingga 2 versi minor yang lebih tinggi daripada node pool di cluster. Misalnya, jika panel kontrol cluster pengguna berada di versi 1.31, node pool di cluster dapat berada di versi 1.29, 1.30, atau 1.31.
Secara umum, jika 1.n adalah versi minor dari panel kontrol cluster pengguna, kumpulan node dalam cluster dapat berada di 1.n, 1.n-1, atau 1.n-2.
Bidang kontrol cluster pengguna tidak dapat diupgrade ke versi minor berikutnya hingga
semua node pool berada di 1.n atau 1.n-1.
1,28
Pada versi 1.28, panel kontrol cluster pengguna dapat berisi hingga 2 versi minor
lebih tinggi daripada node pool dalam cluster. Misalnya, jika panel kontrol cluster pengguna berada di versi 1.28, node pool dalam cluster dapat berada di versi 1.15, 1.16, atau 1.28. Bidang kontrol cluster pengguna tidak dapat diupgrade ke 1.29 hingga semua node pool berada di 1.28 atau 1.16.
1.16 dan yang lebih lama
Pada versi 1.16 dan yang lebih lama, panel kontrol cluster pengguna hanya boleh 1 versi minor lebih tinggi daripada node pool di cluster. Misalnya, jika panel kontrol cluster pengguna berada di versi 1.16, node pool dalam cluster dapat berada di versi 1.15 atau 1.16.
Secara umum, jika 1.n adalah versi minor dari panel kontrol cluster pengguna, kumpulan node dalam cluster dapat berada di 1.n atau 1.n-1. Cluster pengguna
tidak dapat diupgrade ke versi minor berikutnya hingga semua node pool berada di
versi minor yang sama dengan bidang kontrol.
Aturan versi untuk upgrade bidang kontrol cluster admin dan cluster pengguna
Aturan versi untuk cluster admin dan upgrade bidang kontrol cluster pengguna sama. Anda dapat mengupgrade langsung ke versi apa pun yang berada dalam rilis minor yang sama atau rilis minor berikutnya. Misalnya, Anda dapat mengupgrade dari 1.31.0 ke 1.31.1, atau dari 1.30.1 ke 1.31.0. Versi patch tidak memengaruhi aturan versi upgrade.
Jika mengupgrade ke versi yang bukan bagian dari rilis minor berikutnya, Anda harus mengupgrade melalui satu versi dari setiap rilis minor antara versi saat ini dan versi target. Melewati versi minor tidak didukung. Misalnya, jika ingin mengupgrade dari versi 1.29.x ke versi 1.31.x, Anda tidak dapat mengupgrade secara langsung. Anda harus mengupgrade terlebih dahulu dari 1.29.x ke 1.30.x, lalu mengupgrade ke 1.31.x.
Secara umum, hanya upgrade dari 1.n ke 1.n+1 yang didukung untuk upgrade cluster admin dan upgrade panel kontrol cluster pengguna.
Aturan versi untuk upgrade node pool
Pada versi 1.28 dan yang lebih baru, Anda dapat melewati satu versi minor saat mengupgrade kumpulan node di cluster pengguna. Misalnya, jika panel kontrol cluster pengguna berada di versi 1.31 dan node pool berada di versi 1.29, Anda dapat melewati versi 1.30 dan mengupgrade node pool langsung ke versi 1.31. Versi patch tidak memengaruhi aturan versi upgrade.
Secara umum, jika control plane cluster pengguna berada di 1.n, Anda dapat mengupgrade kumpulan node yang berada di 1.n-2 langsung ke 1.n. Melewati satu versi
minor saat mengupgrade node pool dapat mengurangi jumlah waktu daripada melakukan
dua upgrade node pool (untuk mengupgrade dari 1.n-2 ke 1.n-1, lalu ke 1.n). Ini
adalah alasan lain mengapa Anda mungkin lebih memilih untuk mengupgrade panel kontrol cluster pengguna
secara terpisah dari node pool yang berjalan di cluster pengguna.
Tidak tersedia di cluster lanjutan.
Upgrade versi patch
Sebaiknya upgrade ke
versi patch terbaru
jika memungkinkan untuk memastikan cluster Anda memiliki perbaikan keamanan terbaru. Versi
patch tidak memengaruhi penyimpangan versi dan aturan upgrade. Untuk versi minor
tertentu, Anda dapat mengupgrade ke versi patch yang lebih tinggi. Artinya, Anda dapat mengupgrade cluster versi 1.31.X ke versi 1.31.Y selama Y lebih besar dari X. Misalnya, Anda dapat mengupgrade dari
1.30.0 ke 1.30.1 dan Anda dapat mengupgrade dari
1.30.1 ke 1.30.3.
Langkah selanjutnya
Tinjau Praktik terbaik upgrade dan buat rencana untuk mengupgrade cluster Anda.