Mengupdate atau mengupgrade cluster ke cluster lanjutan

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

Prasyarat

  • 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

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

  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

  1. Upgrade workstation admin Anda jika diperlukan.

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

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

Perbarui

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

Upgrade

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