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 ke cluster lanjutan:

  • Jalankan gkectl diagnose cluster di cluster admin dan pengguna Anda untuk memastikan bahwa cluster tersebut dalam kondisi baik.
  • Jika perintah melaporkan error atau peringatan, selesaikan masalah tersebut sebelum Anda memulai update atau upgrade ke cluster lanjutan.

• 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.

• Tentang penginstalan cert-manager: cert-manager diinstal secara otomatis di cluster lanjutan. Saat Anda bermigrasi dari cluster non-lanjutan ke cluster lanjutan, cert-manager terintegrasi akan otomatis menggantikan versi cert-manager yang diinstal pelanggan. Pastikan Anda tidak menerapkan konfigurasi atau fitur kustom penting ke cert-manager yang ada sebelum mengupdate atau mengupgrade ke cluster lanjutan. Untuk mengetahui informasi selengkapnya, lihat Upgrade ke cert-manager yang disertakan dengan cluster lanjutan.

Memperbarui atau mengupgrade cluster admin ke cluster lanjutan

Perhatian: Jika update atau upgrade ke cluster admin gagal, pastikan Anda tidak menghapus cluster bootstrap eksternal dari workstation. Cluster bootstrap berisi semua status yang diperlukan untuk melanjutkan update atau upgrade. Jika Anda perlu menjalankan kembali gkectl update admin atau gkectl upgrade admin setelah terjadi kegagalan, Anda harus menambahkan flag --reuse-bootstrap-cluster (atau -r). Kegagalan menggunakan tanda ini dapat menyebabkan masalah serius yang mengakibatkan hilangnya data penting.

Perbarui

Penting: Pastikan versi cluster Anda minimal 1.32.0.

1. Mendiagnosis cluster Anda untuk memastikan kondisinya baik:

   gkectl diagnose cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG
   

   • Jika perintah melaporkan error atau peringatan, lihat Mendiagnosis masalah cluster dan selesaikan masalah tersebut sebelum melanjutkan.

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 Anda ke true.

4. 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 bidang 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. Mendiagnosis cluster Anda untuk memastikan kondisinya baik:

   gkectl diagnose cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG
   

   • Jika perintah melaporkan error atau peringatan, lihat Mendiagnosis masalah cluster dan selesaikan masalah tersebut sebelum melanjutkan.

3. Bersiap untuk 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.

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

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

6. 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 pembuatan 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. Mendiagnosis cluster Anda untuk memastikan kondisinya baik:

   gkectl diagnose cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --cluster-name USER_CLUSTER_NAME
   

   • Jika perintah melaporkan error atau peringatan, lihat Mendiagnosis masalah cluster dan selesaikan masalah tersebut sebelum melanjutkan.

2. 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.

3. 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.

4. Tetapkan enableAdvancedCluster di file konfigurasi cluster pengguna Anda ke true.

5. 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 bidang 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. Mendiagnosis cluster Anda untuk memastikan kondisinya baik:

   gkectl diagnose cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --cluster-name USER_CLUSTER_NAME
   

   • Jika perintah melaporkan error atau peringatan, lihat Mendiagnosis masalah cluster dan selesaikan masalah tersebut sebelum melanjutkan.

2. 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.

3. 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.

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

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

6. Upgrade 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.

cert-manager yang dibundel dengan cluster lanjutan

cert-manager adalah komponen yang dikelola sistem dan wajib ada di cluster lanjutan.

Jika Anda menggunakan cert-manager tanpa cluster lanjutan, periksa hal berikut sebelum mengupgrade ke cluster lanjutan:

• Tidak ada konfigurasi kustom atau tanda fitur di cert-manager Anda.
• Versi cert-manager Anda adalah versi yang sama atau satu versi di bawah versi yang dibundel.

Kompatibilitas Apigee Hybrid

cert-manager yang dibundel sepenuhnya kompatibel dengan beban kerja Apigee Hybrid. Saat Anda mengupgrade ke cluster lanjutan, penginstal mungkin memperingatkan Anda bahwa penginstalan cert-manager yang ada akan diganti. Ini adalah perilaku yang diharapkan dan ditangani sistem secara otomatis.

Untuk memastikan transisi yang lancar bagi workload Apigee Anda:

• Jangan meng-uninstal cert-manager yang ada secara manual sebelum upgrade.
• Mengembalikan penyesuaian: Jika Anda mengelola cert-manager menggunakan GitOps atau telah menerapkan konfigurasi kustom ke deployment cert-manager, Anda harus mengembalikan penyesuaian ini atau menangguhkan sinkronisasi sebelum melakukan upgrade untuk menghindari penyimpangan konfigurasi dan potensi jeda upgrade.

Kemampuan dan batasan

Anda dapat melakukan hal berikut dengan cert-manager yang disertakan:

• Membuat dan mengedit resource Issuer dan ClusterIssuer.
• Buat dan edit resource sertifikat yang mereferensikan penerbit dan jenis penerbit standar.
• Membuat dan mengedit resource Kubernetes standar yang digunakan cert-manager.
• Buat Secret Kubernetes yang berisi kunci API dan referensikan di penerbit Anda.
• Konfigurasi penerbit Anda untuk menggunakan pemecah HTTP-01 atau DNS-01 tertentu.

Anda tidak dapat menyesuaikan hal berikut dalam cert-manager yang dibundel:

• Tetapkan nilai deployment atau helm.
• Tambahkan argumen atau tanda command line ke biner cert-manager.
• Ubah batas resource atau pemilih node untuk pod cert-manager.
• Ubah logika penginstalan software cert-manager.
• Aktifkan fitur eksperimental.
• Memaksa pod bidang kontrol cert-manager untuk berjalan di node infrastruktur tertentu.

Jika Anda memiliki batasan tertentu yang menghalangi Anda menggunakan cert-manager yang dibundel, hubungi Google Cloud dukungan untuk mendapatkan bantuan terkait opsi konfigurasi lanjutan.

Versi paket

Tabel berikut mencantumkan versi cert-manager yang disertakan untuk setiap versi Google Distributed Cloud (khusus software) untuk VMware.

Google Distributed Cloud (khusus software) untuk VMware	Versi cert-manager yang dipaketkan
1,32	1.17
1.33	1,18
1.34	1,19

Perbedaan utama setelah beralih ke cluster lanjutan

Mengupgrade atau mengupdate cluster ke cluster lanjutan akan memperkenalkan beberapa perbedaan utama dibandingkan dengan cluster standar. Berikut 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 di 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.