Ringkasan upgrade

Merencanakan upgrade cluster untuk software Google Distributed Cloud khusus untuk VMware membantu Anda menentukan urutan upgrade yang diperlukan, memilih alat pengelolaan yang kompatibel, dan meminimalkan gangguan workload di lingkungan multi-cluster. Untuk checklist kesiapan pra-upgrade, lihat Praktik terbaik upgrade.

Pengaruh versi, urutan, dan alat terhadap upgrade

Urutan upgrade cluster, alat yang Anda gunakan, dan pemeriksaan yang harus Anda lakukan sangat bervariasi, bergantung pada hal berikut:

  • Versi yang Anda mulai
  • Versi yang Anda upgrade
  • Apakah Anda mengupgrade dari cluster lanjutan atau non-lanjutan
  • Apakah Anda mengupgrade ke cluster lanjutan atau non-lanjutan
  • Apakah Controlplane V2 diaktifkan di cluster pengguna

Bergantung pada versi yang Anda mulai, urutan upgrade cluster, alat yang Anda gunakan untuk mengupdate, versi cluster, serta hal yang dapat dan tidak dapat Anda lakukan akan sangat bervariasi.

Memeriksa apakah cluster bersifat lanjutan atau non-lanjutan

Untuk memeriksa apakah cluster Anda lanjutan atau non-lanjutan, identifikasi versi yang Anda gunakan:

  • Jika cluster Anda menggunakan versi 1.30 atau yang lebih lama, cluster tersebut bukan cluster lanjutan.
  • Jika cluster Anda menggunakan versi 1.33 dan Anda tidak secara eksplisit memilih untuk tidak menggunakan cluster lanjutan, cluster tersebut adalah cluster lanjutan.
  • Jika cluster Anda menggunakan versi 1.34 dan yang lebih baru, cluster tersebut adalah cluster lanjutan.

Jika cluster Anda menggunakan versi 1.31 dan 1.32, periksa apakah cluster tersebut advanced atau tidak dengan memeriksa resource kustom cluster menggunakan kubectl:

  1. Di kubeconfig cluster admin, periksa kolom spesifikasi enableAdvancedCluster untuk cluster admin:

    kubectl get onpremadminclusters -A \
    -o custom-columns=NAME:.metadata.name,VERSION:.spec.gkeOnPremVersion,ADVANCED:.spec.enableAdvancedCluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

    Ganti ADMIN_CLUSTER_KUBECONFIG dengan jalur ke file kubeconfig cluster admin Anda.

  2. Di kubeconfig cluster admin, periksa kolom spesifikasi enableAdvancedCluster untuk cluster pengguna:

    kubectl get onpremuserclusters -A \
    -o custom-columns=NAME:.metadata.name,VERSION:.spec.gkeOnPremVersion,ADVANCED:.spec.enableAdvancedCluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

Jika cluster lanjutan diaktifkan, output-nya akan mirip dengan berikut ini:

NAME              VERSION           ADVANCED
gke-admin-abc12   1.32.0-gke.1085   true

Jika ADVANCED adalah true, cluster tersebut adalah cluster lanjutan. Untuk versi 1.32 atau yang lebih lama, ADVANCED mungkin ditampilkan sebagai <none>.

Proses upgrade tingkat tinggi

Bagian berikut menjelaskan keseluruhan proses upgrade saat mengupgrade cluster, bergantung pada jenis cluster yang Anda upgrade dari dan ke.

Sebelum memulai upgrade, tinjau informasi mendetail tentang pengaruh versi terhadap upgrade. Lihat Aturan versi upgrade untuk mengetahui daftar mendetail dependensi berdasarkan versi dan informasi tentang melewati versi dan aturan penyimpangan versi.

Cluster lanjutan versus non-lanjutan

Ada dua jenis cluster: lanjutan dan non-lanjutan. Semua cluster yang dibuat di versi 1.33 atau yang lebih baru adalah cluster lanjutan. Cluster lanjutan menggunakan arsitektur yang ditingkatkan yang memberikan fleksibilitas dan skalabilitas yang lebih besar.

Setelah mengupgrade cluster ke cluster lanjutan, Anda akan selalu menggunakan cluster lanjutan dan menggunakan proses upgrade cluster lanjutan. Apakah cluster bersifat lanjutan atau non-lanjutan hanya penting saat Anda mengupgrade dari versi sebelum 1.33.

Cluster lanjutan menggunakan arsitektur Google Distributed Cloud yang digabungkan dengan menggunakan Google Distributed Cloud khusus software untuk bare metal sebagai framework dasar untuk Google Distributed Cloud khusus software untuk VMware. Anda mungkin melihat referensi ke "bare metal" di label node, resource API, dan tag sistem.

Fitur cluster lanjutan menerapkan arsitektur cluster yang lebih menyelaraskan software Google Distributed Cloud khusus untuk VMware dengan produk Google Distributed Cloud lainnya. Cluster yang mengaktifkan cluster lanjutan memiliki platform bersama dengan cluster Google Distributed Cloud lainnya. Platform bersama ini menggunakan pengontrol dan agen yang sama, sehingga meningkatkan keandalan dan dapat membantu Google memberikan dukungan yang lebih baik. Performa untuk operasi cluster juga ditingkatkan saat cluster lanjutan diaktifkan.

Arsitektur baru ini menghadirkan pengalaman dan implementasi yang konsisten dengan semua penawaran Google Distributed Cloud lainnya. Untuk mengetahui detail tentang fitur yang tersedia untuk cluster lanjutan versus cluster non-lanjutan, lihat Dukungan fitur cluster lanjutan.

Mengupgrade dari cluster lanjutan ke cluster lanjutan (versi saat ini, mulai dari 1.31)

Di versi 1.32 dan yang lebih baru, saat mengupgrade dari satu cluster lanjutan ke cluster lanjutan lainnya, Anda dapat melakukan upgrade versi patch dan upgrade versi minor berurutan. Di Pratinjau versi 1.31, Anda hanya dapat melakukan upgrade versi patch dalam versi 1.31.

Untuk melakukan upgrade ini, Anda dapat menggunakan gkectl CLI, Google Cloud CLI, konsol Google Cloud , atau Terraform (tergantung versinya).

Untuk mengupgrade dari cluster lanjutan ke cluster lanjutan, Anda harus mengikuti urutan berikut:

  1. Upgrade workstation admin, jika ada.
  2. Gunakan gkectl diagnose cluster untuk memverifikasi bahwa cluster admin Anda responsif. Selesaikan masalah apa pun.
  3. Upgrade cluster admin.
  4. Gunakan gkectl diagnose cluster untuk memverifikasi bahwa upgrade berhasil dan cluster pengguna Anda responsif. Selesaikan masalah apa pun.
  5. Upgrade cluster pengguna, satu per satu. Anda dapat mengupgrade bidang kontrol dan node pool cluster pengguna secara bersamaan atau terpisah. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade node pool.
  6. Verifikasi bahwa upgrade telah berhasil menggunakan gkectl diagnose cluster.

Jika semua node pool di cluster pengguna memiliki versi yang sama dengan bidang kontrol cluster pengguna, cluster pengguna akan diupgrade dan upgrade selesai.

Bidang kontrol untuk cluster pengguna berjalan di cluster pengguna itu sendiri dan diupgrade selama upgrade cluster pengguna. Node bidang kontrol cluster admin diupgrade selama upgrade cluster admin.

Untuk mengetahui informasi selengkapnya tentang cara mendiagnosis cluster menggunakan gkectl diagnose cluster, lihat Mendiagnosis cluster.

Untuk mengetahui informasi tentang cara melakukan upgrade dari cluster lanjutan ke cluster lanjutan, lihat Mengupgrade cluster.

Mengupgrade dari cluster non-lanjutan ke cluster lanjutan

Upgrade dari cluster non-lanjutan ke cluster lanjutan hanya terjadi untuk versi 1.31, 1.32, 1.33, dan 1.34. Untuk mengetahui informasi selengkapnya tentang cara mengupgrade dari cluster non-lanjutan ke cluster lanjutan dalam versi ini, lihat Aturan versi upgrade.

Untuk mengupgrade dari cluster non-lanjutan ke cluster lanjutan, Anda harus menggunakan gkectl dengan versi yang sama dengan versi target (misalnya, jika Anda mengupgrade ke versi 1.32.0, Anda harus menggunakan gkectl versi 1.32.0) dan ikuti urutan ini:

  1. Mengupgrade workstation admin dan artefak.
  2. Gunakan gkectl diagnose cluster untuk memverifikasi bahwa cluster admin Anda responsif. Selesaikan masalah apa pun.
  3. Upgrade cluster admin.
  4. Gunakan gkectl diagnose cluster untuk memverifikasi bahwa upgrade berhasil dan cluster pengguna Anda responsif. Selesaikan masalah apa pun.
  5. Upgrade cluster pengguna.
  6. Verifikasi bahwa upgrade telah berhasil menggunakan gkectl diagnose cluster.

Untuk mengetahui informasi selengkapnya tentang cara mendiagnosis cluster menggunakan gkectl diagnose cluster, lihat Mendiagnosis cluster.

Untuk mengetahui informasi selengkapnya tentang cara melakukan upgrade dari cluster non-lanjutan ke cluster lanjutan, lihat Mengupdate atau mengupgrade dari cluster non-lanjutan ke cluster lanjutan.

Mengupgrade dari cluster non-lanjutan ke cluster non-lanjutan

Anda dapat mengupgrade dari cluster non-lanjutan ke cluster non-lanjutan lainnya untuk versi 1.33 dan yang lebih lama. Untuk mengetahui detail tentang versi yang memungkinkan upgrade dari cluster non-lanjutan ke cluster non-lanjutan lainnya, lihat Aturan versi upgrade.

Urutan upgrade cluster non-lanjutan bergantung pada versi target:

  • Untuk versi target 1.31, 1.32, dan 1.33, Anda harus mengupgrade cluster admin sebelum mengupgrade cluster pengguna.
  • Untuk versi target 1.30 dan yang lebih lama, Anda harus mengupgrade semua cluster pengguna sebelum mengupgrade cluster admin.

Mengupgrade ke versi 1.31, 1.32, atau 1.33

Untuk mengupgrade ke versi 1.31, 1.32, atau 1.33 sambil mempertahankan cluster Anda non-lanjutan, Anda harus mengikuti urutan ini:

  1. Mengupgrade workstation admin dan menyiapkan artefak paket.
  2. Gunakan gkectl diagnose cluster untuk memverifikasi bahwa cluster admin Anda responsif. Selesaikan masalah apa pun.
  3. Upgrade cluster admin.
  4. Gunakan gkectl diagnose cluster untuk memverifikasi bahwa upgrade berhasil dan cluster pengguna Anda responsif. Selesaikan masalah apa pun.
  5. Upgrade cluster pengguna, satu per satu.
  6. Verifikasi bahwa upgrade telah berhasil menggunakan gkectl diagnose cluster.

Upgrade ke versi 1.30 atau yang lebih lama

Untuk mengupgrade ke versi 1.30 atau yang lebih lama, Anda harus mengikuti urutan ini:

  1. Mengupgrade workstation admin dan menyiapkan artefak paket.
  2. Gunakan gkectl diagnose cluster untuk memverifikasi bahwa cluster pengguna Anda responsif. Selesaikan masalah apa pun.
  3. Upgrade semua cluster pengguna, satu per satu.
  4. Gunakan gkectl diagnose cluster untuk memverifikasi bahwa upgrade berhasil dan cluster admin Anda responsif. Selesaikan masalah apa pun.
  5. Upgrade cluster admin.
  6. Verifikasi bahwa upgrade telah berhasil menggunakan gkectl diagnose cluster.

Untuk mengetahui informasi selengkapnya tentang cara mendiagnosis cluster menggunakan gkectl diagnose cluster, lihat Mendiagnosis cluster.

Untuk mengetahui informasi selengkapnya tentang cara melakukan upgrade dari cluster non-lanjutan ke cluster non-lanjutan, lihat Mengupgrade dan memelihara cluster non-lanjutan.

Upgrade cluster

Anda selalu mengupgrade cluster admin satu per satu.

Saat mengupgrade cluster pengguna, Anda dapat mengupgrade seluruh cluster pengguna (bidang kontrol dan semua node pool dalam cluster secara bersamaan), 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 tetap sederhana dan mengupgrade bidang kontrol cluster pengguna dan semua node pool. Namun, di lingkungan produksi dengan masa pemeliharaan yang singkat, Anda mungkin hanya ingin mengupgrade bidang kontrol karena memerlukan waktu lebih singkat dan dengan bidang kontrol ketersediaan tinggi (HA), upgrade bidang kontrol tidak boleh mengganggu workload pengguna.

Memilih alat untuk mengupgrade cluster

Alat yang Anda gunakan bergantung pada cara dan hal yang ingin Anda upgrade.

Untuk cluster admin, Anda harus menggunakan gkectl untuk mengupgrade.

Untuk cluster pengguna, Anda dapat menggunakan salah satu alat berikut untuk mengupgrade cluster:

  • Alat command line gkectl (diperlukan untuk upgrade dari cluster non-lanjutan ke cluster lanjutan)
  • Terraform, jika Anda membuat cluster pengguna menggunakan Terraform
  • KonsolGoogle Cloud
  • Google Cloud CLI

Tabel berikut mencantumkan alat yang mendukung kasus penggunaan tertentu.

Kasus penggunaan upgrade gkectl gcloud CLI console Terraform Catatan & batasan
Mengupgrade cluster admin (jalur apa pun) Ya Tidak Tidak Tidak Cluster admin selalu memerlukan gkectl.
Mengupgrade cluster non-lanjutan ke cluster lanjutan (konversi) Ya Tidak Tidak Tidak Versi gkectl harus cocok dengan versi target; tidak ada perbedaan versi yang diizinkan antara bidang kontrol (CP) dan node pool.
Mengupgrade cluster non-lanjutan ke cluster non-lanjutan (lama) Ya Tidak Tidak Tidak Hanya tersedia di versi 1.33 dan yang lebih lama (jalur nonaktifkan); klien API tidak didukung.
Mengupgrade cluster pengguna: Advanced ke advanced Ya Ya Ya Ya1 Aturan perbedaan versi standar berlaku.
Mengupgrade seluruh cluster pengguna (CP dan node pool bersama-sama) Ya Ya Ya Ya1 Didukung di semua alat untuk cluster pengguna tingkat lanjut.
Mengupgrade bidang kontrol cluster pengguna secara terpisah (khusus CP) Ya Ya Tidak Ya1 Konsol tidak mendukung upgrade hanya pada bidang kontrol.
Mengupgrade node pool secara selektif setelah upgrade CP Ya Ya Tidak Ya1 Konsol tidak mendukung upgrade node pool individual.
Mengupgrade CP dan satu atau beberapa node pool secara bersamaan Ya Tidak Tidak Tidak Hanya gkectl yang mendukung upgrade versi CP + node pool serentak parsial.

1 Persyaratan Terraform: Anda dapat menggunakan Terraform untuk upgrade cluster pengguna hanya jika cluster pengguna awalnya dibuat dan dikelola menggunakan Terraform.

Untuk mendapatkan informasi tentang cluster yang Anda buat dengan gkectl menggunakan konsol atau gcloud CLI, daftarkan cluster di GKE On-Prem API.

Langkah berikutnya

Tinjau Aturan versi upgrade untuk memahami pengaruh versi terhadap upgrade dan menemukan aturan versi untuk versi yang Anda miliki dan versi yang akan diupgrade.

Tinjau Praktik terbaik upgrade dan buat rencana untuk mengupgrade cluster Anda.