Memperbarui atau mengupgrade cluster ke cluster lanjutan

Dokumen ini menunjukkan cara memperbarui atau mengupgrade cluster ke cluster lanjutan dari versi 1.32.

Penting: Cluster non-lanjutan akan diupgrade ke cluster lanjutan secara otomatis di 1.33.

Prasyarat

• Versi gkectl harus sama dengan versi cluster target.

  • Jika perlu, lihat Mendownload gkectl untuk mendapatkan gkectl versi yang didukung.

• Selalu diagnosis cluster Anda sebelum memperbarui atau mengupgrade.

• Pastikan cluster Anda hanya menggunakan fitur yang direkomendasikan.

• Pastikan cluster Anda tidak menggunakan fitur yang tidak didukung oleh cluster lanjutan sebelum memulai update atau upgrade. Jika ada fitur yang tidak didukung yang aktif, nonaktifkan fitur tersebut menggunakan update terlebih dahulu.

  • Meskipun cluster pengguna dengan ketersediaan tinggi (HA) diperlukan di cluster lanjutan, Anda tetap dapat memperbarui atau mengupgrade cluster pengguna non-HA ke cluster lanjutan HA dengan mengikuti panduan ini.

• Anda harus mengupdate atau mengupgrade cluster admin ke cluster lanjutan sebelum mengupdate atau mengupgrade cluster pengguna.

Memperbarui atau mengupgrade cluster admin ke cluster lanjutan

Perbarui

Penting: Pastikan versi cluster Anda minimal 1.32.0.

1. Siapkan cluster lanjutan:

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster
   

   Ganti kode berikut:

   • BUNDLE_PATH: jalur file paket. File ini ada di workstation admin Anda di /var/lib/gke/bundles/. Misalnya:

     /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin.

2. Tetapkan enableAdvancedCluster di file konfigurasi cluster admin Anda ke true.

3. Perbarui cluster admin ke cluster lanjutan:

   gkectl update admin \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config ADMIN_CLUSTER_CONFIG
   

   Ganti kode berikut:

   • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin.
   • ADMIN_CLUSTER_CONFIG: jalur file konfigurasi cluster admin.

   Perintah ini akan membuat ulang semua node di cluster admin.

Upgrade

Perhatian: Jika cluster Anda menggunakan cos atau cos_cgv2 sebagai jenis image OS panel kontrol atau jenis image OS node pool, pastikan versi cluster Anda minimal 1.32.0 sebelum melakukan upgrade. Jika tidak, pastikan versi cluster Anda minimal 1.31.100.

1. Upgrade workstation admin Anda jika diperlukan.

2. Siapkan cluster lanjutan:

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster
   

   Ganti kode berikut:

   • BUNDLE_PATH: jalur file paket. File ini ada di workstation admin Anda di /var/lib/gke/bundles/. Misalnya:

     /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin.

3. Tetapkan enableAdvancedCluster di file konfigurasi cluster admin ke true.

4. Pastikan kolom bundlepath di file konfigurasi cluster admin cocok dengan jalur paket yang ingin Anda upgrade.

5. Upgrade cluster admin ke cluster lanjutan:

   gkectl upgrade admin \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config ADMIN_CLUSTER_CONFIG
   

   Ganti kode berikut:

   • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin.
   • ADMIN_CLUSTER_CONFIG: jalur file konfigurasi cluster admin.

   Perintah ini akan meluncurkan pembuatan ulang semua node di cluster admin. Dengan strategi deployment buat ulang peluncuran, node diupgrade satu per satu. Selama upgrade node, VM akan dihapus lalu dibuat ulang dengan versi baru.

Setelah cluster admin diupdate atau diupgrade ke cluster lanjutan:

• Cluster pengguna non-lanjutan yang ada akan terus berfungsi secara normal.

• Anda hanya dapat membuat cluster pengguna lanjutan yang dikelola oleh cluster admin lanjutan.

Sebaiknya upgrade semua cluster pengguna ke cluster lanjutan segera setelahnya untuk mempertahankan lingkungan yang konsisten dan memiliki fitur lengkap.

Memperbarui atau mengupgrade cluster pengguna ke cluster lanjutan

Penting: Pastikan cluster admin telah diupdate atau diupgrade ke cluster lanjutan.

Perbarui

Penting: Pastikan versi cluster Anda minimal 1.32.0.

1. Jika bidang kontrol cluster pengguna Anda tidak memiliki ketersediaan tinggi (HA):

   Perhatian: Karena masalah umum pada kolom masterNode.replicas, untuk mengupdate cluster pengguna non-HA versi 1.32 atau versi 1.33 ke cluster lanjutan HA, cluster Anda harus menggunakan versi yang lebih tinggi dari 1.32.600 atau lebih tinggi dari 1.33.100.

   1. Ubah masterNode.replicas dari 1 menjadi 3.

   2. Tambahkan alamat IP statis untuk node bidang kontrol cluster pengguna ke bagian network.controlPlaneIPBlock.ips.

2. Siapkan cluster lanjutan:

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster
   

   Ganti kode berikut:

   • BUNDLE_PATH: jalur file paket. File ini ada di workstation admin Anda di /var/lib/gke/bundles/. Misalnya:

     /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin.

3. Tetapkan enableAdvancedCluster di file konfigurasi cluster pengguna ke true.

4. Perbarui cluster pengguna ke cluster lanjutan:

   gkectl update cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config USER_CLUSTER_CONFIG
   

   Ganti kode berikut:

   • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin.
   • USER_CLUSTER_CONFIG: jalur file konfigurasi cluster pengguna.

   Perintah ini akan meluncurkan pembuatan ulang semua node di cluster pengguna. Dengan strategi deployment pembuatan ulang peluncuran, node diupdate satu per satu. Selama update node, VM akan dihapus lalu dibuat ulang dengan konfigurasi baru.

Upgrade

Perhatian: Jika cluster Anda menggunakan cos atau cos_cgv2 sebagai jenis image OS panel kontrol atau jenis image OS node pool, pastikan versi cluster Anda minimal 1.32.0 sebelum melakukan upgrade. Jika tidak, pastikan versi cluster Anda minimal 1.31.100.

1. Jika bidang kontrol cluster pengguna Anda tidak memiliki ketersediaan tinggi (HA):

   1. Ubah masterNode.replicas dari 1 menjadi 3.

   2. Tambahkan alamat IP statis untuk node bidang kontrol cluster pengguna ke bagian network.controlPlaneIPBlock.ips.

2. Siapkan cluster lanjutan:

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster
   

   Ganti kode berikut:

   • BUNDLE_PATH: jalur file paket. File ini ada di workstation admin Anda di /var/lib/gke/bundles/. Misalnya:

     /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin.

3. Tetapkan enableAdvancedCluster di file konfigurasi cluster pengguna ke true.

4. Pastikan kolom gkeOnPremVersion di file konfigurasi cluster pengguna cocok dengan versi target upgrade Anda.

5. Mengupgrade cluster pengguna ke cluster lanjutan:

   gkectl upgrade cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config USER_CLUSTER_CONFIG
   

   Ganti kode berikut:

   • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin.
   • USER_CLUSTER_CONFIG: jalur file konfigurasi cluster pengguna.

   Perintah ini akan membuat ulang semua node di cluster pengguna.

Perbedaan utama setelah beralih ke cluster lanjutan

Mengupgrade atau memperbarui cluster Anda ke cluster lanjutan akan memperkenalkan beberapa perbedaan utama dibandingkan dengan cluster standar. Berikut adalah perubahan besar pada cluster lanjutan:

• Lokasi resource: Resource cluster dan mesin tidak lagi berada di cluster pengguna. Resource ini terletak secara eksklusif dalam cluster admin.

• NodeExternalIP: NodeExternalIP tidak ditetapkan pada node.

• Penginstalan cert-manager: cert-manager diinstal secara otomatis di cluster lanjutan. Jika Anda menginstal cert-manager di cluster, memperbarui atau mengupgrade ke cluster lanjutan akan menggantikannya dengan versi cluster lanjutan.

Untuk ringkasan komprehensif tentang perbedaan fitur, lihat tabel perbandingan fitur.