Memperbarui atau mengupgrade cluster ke cluster lanjutan

Anda dapat mengonversi cluster versi 1.32 menjadi cluster lanjutan dengan mengupdatenya di tempat pada versi 1.32 atau dengan mengupgradenya ke versi 1.33. Mengonversi ke cluster lanjutan akan menyiapkan lingkungan Anda untuk versi 1.33 dan yang lebih baru, yang menjadikan cluster lanjutan sebagai arsitektur default atau yang diperlukan.

Perbedaan utama setelah beralih ke cluster lanjutan

Mengupgrade atau mengupdate cluster Anda ke cluster lanjutan akan menimbulkan beberapa perbedaan utama dibandingkan dengan cluster standar. Berikut adalah perubahan besar dalam cluster lanjutan:

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

  • NodeExternalIP: NodeExternalIP tidak ditetapkan pada node.

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

Perbedaan fitur antara cluster lanjutan dan non-lanjutan

Saat Anda mengaktifkan cluster lanjutan, beberapa fitur atau kemampuan tidak akan berfungsi dengan cara yang sama seperti di cluster non-lanjutan. Beberapa perubahan ini hanya berlaku untuk versi Pratinjau cluster lanjutan di versi 1.31. Perbedaannya dicantumkan di seluruh dokumentasi.

Tabel berikut mencantumkan fitur yang didukung untuk software Google Distributed Cloud khusus untuk VMware, status ketersediaannya saat cluster lanjutan diaktifkan, dan perbedaan perilaku atau penggunaan:

Fitur/kemampuan 1.31 Cluster lanjutan (Pratinjau) 1.32 Tidak diaktifkan 1.32 Cluster lanjutan (GA) 1.33 Cluster lanjutan (GA) Perbedaan
Cluster lanjutan Pratinjau GA GA GA Tidak didukung
Domain topologi Pratinjau Pratinjau Pratinjau Perubahan akan diterapkan. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan domain topologi dan referensi konfigurasi cluster terkait.
Keanggotaan fleet regional GA GA GA GA Tidak ada perbedaan.
Penyimpangan versi n+2 cluster admin - cluster pengguna GA GA GA Tidak direkomendasikan: Karena mengelola cluster pengguna pratinjau versi lebih rendah tidak didukung, jangan gunakan fitur ini.
Perbedaan versi n+2 node pool - cluster pengguna GA GA GA Tidak direkomendasikan: Karena mengelola cluster pengguna pratinjau versi lebih rendah tidak didukung, jangan gunakan fitur ini.
Setelan lonjakan maksimum untuk update node pool Pratinjau Pratinjau Pratinjau Pratinjau Tidak ada perbedaan.
cgroup v2 untuk node GA GA GA GA Tidak ada perbedaan.
Mode DSR untuk Dataplane V2 GA GA GA GA Tidak ada perbedaan.
Otorisasi Biner untuk cluster pengguna Controlplane V2 GA GA GA GA Tidak ada perbedaan.
Workstation admin yang dikelola pengguna GA GA GA GA Tidak ada perbedaan.
Alat migrasi CSI StatefulSet GA GA GA GA Tidak ada perbedaan.
Migrasi Seesaw ke MetalLB GA GA GA GA Tidak ada perbedaan.
Menonaktifkan ingress yang dipaketkan GA GA GA GA Tidak ada perbedaan.
Kredensial yang disiapkan cluster admin GA GA GA Tidak ada perbedaan.
Kebijakan penyimpanan untuk cluster pengguna GA GA GA GA Tidak ada perbedaan.
Kebijakan penyimpanan untuk cluster admin GA GA GA GA Tidak ada perbedaan.
Perbaikan otomatis node GA GA GA GA Perubahan berlaku: Jika cluster lanjutan diaktifkan, health check berkala tidak akan dijalankan sebagai bagian dari perbaikan otomatis. Untuk mengetahui informasi dan perbedaan lainnya, lihat Perbaikan node otomatis dan health check.
Cluster admin ketersediaan tinggi GA GA GA GA Tidak ada perbedaan.
Afinitas host VM GA GA GA Didukung di cluster lanjutan dalam versi 1.32.200 dan 1.33 dan yang lebih baru. Saat Anda menggunakan domain topologi, konfigurasikan grup host di topologyDomains[i].compute.hostGroups dalam file konfigurasi infrastruktur vSphere, bukan nodePools[i].vsphere.hostgroups dalam file konfigurasi cluster pengguna.
Membuat file konfigurasi dari cluster yang ada GA GA GA GA Perubahan akan diterapkan. Cluster yang menggunakan domain topologi tidak didukung.
Pengumpulan metrik sistem Google Cloud Managed Service for Prometheus GA GA GA GA Tidak ada perbedaan.
Upgrade dan rollback node pool GA GA GA Tidak ada perbedaan.
Memperbarui kredensial registry pribadi GA GA GA GA Tidak ada perbedaan.
Pencadangan dan pemulihan cluster admin dengan gkectl Pratinjau Pratinjau GA Perubahan akan diterapkan. Memperbarui perintah gkectl untuk meningkatkan pemulihan cluster admin dan untuk mendukung pencadangan dan pemulihan cluster pengguna. Untuk mengetahui informasi selengkapnya, lihat Mencadangkan dan memulihkan cluster lanjutan dengan gkectl.
Penskalaan otomatis node pool cluster pengguna GA GA GA GA Tidak ada perbedaan.
Pengubahan ukuran node otomatis cluster GA GA Tidak ada perbedaan.
Dukungan beberapa cluster vSphere GA GA GA GA Tidak ada perbedaan.
Dukungan beberapa pusat data vSphere GA GA GA GA Tidak ada perbedaan.
Dukungan OpenID Connect (OIDC) untuk autentikasi ke cluster GA GA GA GA Tidak ada perbedaan.
Rotasi sertifikat CA GA GA GA Tidak ada perbedaan.
Dukungan Workload Identity Federation GA GA GA GA Tidak ada perbedaan.
GKE Identity Service dengan dukungan autentikasi LDAP GA GA GA GA Tidak ada perbedaan.
Enkripsi secret yang selalu aktif tanpa modul keamanan hardware (HSM) GA GA GA Tidak ada perbedaan.
Memperbarui sertifikat CA vCenter dengan gkectl GA GA GA GA Tidak ada perbedaan.
Gateway NAT egress GA GA GA GA Tidak ada perbedaan.
Pendaftaran fleet cluster admin GA GA GA GA Tidak ada perbedaan.
Dukungan node pool Windows GA Tidak didukung.
Runtime containerd untuk node pool Windows GA Tidak didukung.
Dukungan node pool Container-Optimized OS GA GA GA Tidak ada perbedaan.
CoreDNS sebagai penyedia DNS cluster GA GA GA GA Tidak ada perbedaan.
Siklus proses cluster pengguna di konsol Google Cloud GA Dukungan sebagian GA Perubahan akan diterapkan. Untuk mengetahui informasi selengkapnya, lihat Batasan cluster lanjutan.
Pembuatan node cluster admin dengan Container-Optimized OS GA GA GA Tidak ada perbedaan.
Kemampuan multi-NIC untuk Pod GA GA GA GA Tidak ada perbedaan.
Opsi load balancer MetalLB GA GA GA GA Perubahan akan diterapkan. Untuk mengetahui detailnya, lihat Load balancing yang dipaketkan dengan MetalLB.
Dukungan gkectl update admin untuk mengaktifkan dan menonaktifkan Cloud Logging dan Cloud Monitoring GA GA GA GA Tidak ada perbedaan.
Dukungan Dataplane V2 Windows GA Tidak didukung.
Metrik API Ringkasan GA GA GA GA Tidak ada perbedaan.
Dukungan gkectl update credentials untuk memperbarui kunci akun layanan akses komponen Dukungan sebagian GA Dukungan sebagian Dukungan sebagian Perubahan akan diterapkan. Untuk mengetahui detail tentang hal yang didukung atau tidak didukung untuk memperbarui kredensial untuk cluster lanjutan, lihat Perbedaan cluster lanjutan untuk merotasi kunci akun layanan.
Kredensial yang disiapkan untuk cluster pengguna GA GA GA Tidak ada perbedaan.
Uji coba upgrade cluster pengguna GA GA GA GA Tidak ada perbedaan.
Upgrade asinkron cluster pengguna GA GA GA GA Tidak ada perbedaan.
Uji coba upgrade cluster admin GA GA Tidak ada perbedaan.
Upgrade asinkron cluster admin GA GA GA GA Tidak ada perbedaan.
Update berurutan untuk node pool GA GA GA Tidak ada perbedaan.
Membuat snapshot volume dengan driver CSI vSphere Pratinjau Pratinjau Pratinjau Pratinjau Tidak ada perbedaan.
Membuat cluster pengguna dengan Controlplane V2 diaktifkan GA GA GA GA Tidak ada perbedaan.
Migrasi penyimpanan dengan SPBM GA GA GA GA Tidak ada perbedaan.
Memigrasikan datastore ke SPBM GA GA GA GA Tidak ada perbedaan.
Memigrasikan cluster pengguna ke Controlplane V2 GA GA GA GA Tidak ada perbedaan.
Bermigrasi ke cluster admin dengan ketersediaan tinggi (HA) GA GA GA GA Tidak ada perbedaan.
Memigrasikan setelan konfigurasi untuk F5 BIG-IP GA GA GA GA Tidak ada perbedaan.
Load balancer Dukungan sebagian GA GA GA Perubahan akan diterapkan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi konfigurasi load balancer dan cluster yang relevan.
Pemeriksaan preflight Dukungan sebagian GA GA GA Tidak ada perbedaan.
Persyaratan hardware GA GA GA GA Perubahan akan diterapkan. Untuk mengetahui detailnya, lihat Persyaratan CPU, RAM, dan penyimpanan.
Snapshot GA GA GA GA Tidak ada perbedaan.
Registry pribadi GA GA GA GA Perubahan akan diterapkan. Untuk mengetahui detail tentang penggunaan registry pribadi di cluster lanjutan, lihat Batasan dengan cluster lanjutan dan paket lengkap.
IPAM, DNS, NTP, dan multi-NIC GA GA GA GA Tidak ada perbedaan.
Pembuatan/upgrade/penghapusan cluster GA GA GA GA Perubahan akan diterapkan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi operasi cluster yang relevan dan Batasan cluster lanjutan.
Proxy GA GA GA GA Tidak ada perbedaan.
Kebijakan update NodePool GA GA GA Tidak ada perbedaan.
Mendiagnosis GA GA GA Perubahan berlaku. Pemeriksaan terkait vCenter tidak tersedia untuk cluster lanjutan. Karena pengontrol onprem-user-cluster-controller tidak ada lagi, panduan Mendiagnosis masalah cluster sudah tidak berlaku untuk cluster lanjutan. Untuk cluster lanjutan versi 1.32, perintah gkectl diagnose cluster menjalankan health check untuk cluster yang ditentukan.
Tag vSphere dan pelacakan VM GA GA Tidak ada perbedaan.
Grup host vSphere GA GA Tidak ada perbedaan.
Logging dan pemantauan GA GA GA GA Tidak ada perbedaan.
Grup anti-afinitas GA GA GA Tidak ada perbedaan.
Bidang kontrol cluster pengguna non-HA GA Tidak didukung.
gkectl check-config GA GA GA Perubahan akan diterapkan. Dukungan untuk perintah pada cluster pengguna lanjutan ditambahkan dalam versi berikut: 1.32.700+, 1.33.300+, dan 1.34.0 dan yang lebih tinggi.

Prasyarat

  • Versi gkectl harus sama dengan versi cluster target.

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

  • Selalu diagnosis cluster Anda sebelum mengupdate atau mengupgrade ke cluster lanjutan:

    • Jalankan gkectl diagnose cluster di cluster admin dan pengguna untuk memastikan bahwa cluster tersebut responsif.
    • 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 pada cluster lanjutan, Anda masih dapat mengupdate 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 apa pun.

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

Mengupdate atau mengupgrade cluster admin ke cluster lanjutan

Perbarui

  1. Diagnosis cluster Anda untuk memastikan cluster tersebut responsif:

    gkectl diagnose cluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

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

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

  4. Update 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

  1. Upgrade workstation admin Anda jika diperlukan.

  2. Diagnosis cluster Anda untuk memastikan cluster tersebut responsif:

    gkectl diagnose cluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

  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 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 seperti biasa.

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

Upgrade semua cluster pengguna ke cluster lanjutan segera setelahnya untuk mempertahankan lingkungan yang konsisten dan berfitur lengkap.

Mengupdate atau mengupgrade cluster pengguna ke cluster lanjutan

Perbarui

  1. Diagnosis cluster Anda untuk memastikan cluster tersebut responsif:

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

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

  5. Update 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

  1. Diagnosis cluster Anda untuk memastikan cluster tersebut responsif:

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

  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. 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 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 dipaketkan dengan cluster lanjutan

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

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

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

Kompatibilitas Apigee Hybrid

cert-manager yang dipaketkan sepenuhnya kompatibel dengan workload Apigee Hybrid. Saat Anda mengupgrade ke cluster lanjutan, penginstal mungkin akan 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 upgrade untuk menghindari penyimpangan konfigurasi dan potensi jeda upgrade.

Kemampuan dan batasan

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

  • Membuat dan mengedit resource Issuer dan ClusterIssuer.
  • Membuat dan mengedit 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 dalam penerbit Anda.
  • Konfigurasikan penerbit Anda untuk menggunakan solver HTTP-01 atau DNS-01 tertentu.

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

  • Tetapkan nilai deployment atau helm.
  • Tambahkan argumen atau flag command line ke biner cert-manager.
  • Mengubah 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 mencegah Anda menggunakan cert-manager yang dipaketkan, hubungi dukunganGoogle Cloud untuk mendapatkan bantuan terkait opsi konfigurasi lanjutan.

Versi paket

Tabel berikut mencantumkan versi cert-manager yang dipaketkan 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