Memigrasikan cluster pengguna ke Controlplane V2

Dokumen ini menunjukkan cara memigrasikan cluster pengguna versi 1.29 atau yang lebih baru menggunakan kubeception ke Controlplane V2.

1.29: Pratinjau
1.28: Tidak tersedia
1.16: Tidak tersedia

Tentang bidang kontrol cluster pengguna

Sebelum Google Distributed Cloud versi 1.13, bidang kontrol untuk cluster pengguna berjalan di satu atau beberapa node dalam cluster admin. Bidang kontrol semacam ini disebut sebagai kubeception. Pada versi 1.13, Controlplane V2 diperkenalkan untuk cluster pengguna baru. Jika Controlplane V2 diaktifkan, bidang kontrol untuk cluster pengguna akan berjalan di cluster pengguna itu sendiri.

Manfaat Controlplane V2 mencakup hal berikut:

  • Isolasi kegagalan. Kegagalan cluster admin tidak memengaruhi cluster pengguna.

  • Pemisahan operasional. Upgrade cluster admin tidak menyebabkan periode nonaktif untuk cluster pengguna.

  • Pemisahan deployment. Anda dapat menempatkan cluster admin dan pengguna di domain kegagalan atau situs geografis yang berbeda. Misalnya, cluster pengguna di lokasi edge mungkin berada di situs geografis yang berbeda dengan cluster admin.

Persyaratan

Untuk memigrasikan cluster pengguna ke Controlplane V2, cluster pengguna harus memenuhi persyaratan berikut:

  • Cluster pengguna harus versi 1.29 atau yang lebih tinggi. Cluster admin dan kumpulan node dapat berupa satu atau dua versi minor yang lebih rendah dari cluster pengguna. Jika perlu, upgrade cluster.

  • Cluster pengguna harus mengaktifkan Dataplane V2. Kolom ini tidak dapat diubah. Jadi, jika Dataplane V2 tidak diaktifkan di cluster, Anda tidak dapat memigrasikannya ke Controlplane V2.

  • Cluster pengguna harus dikonfigurasi untuk menggunakan MetalLB atau load balancer manual. Jika cluster pengguna menggunakan load balancer SeeSaw, Anda dapat memigrasikannya ke MetalLB.

  • Tinjau dokumen perencanaan alamat IP, dan pastikan Anda memiliki alamat IP yang memadai untuk node bidang kontrol cluster pengguna. Node bidang kontrol memerlukan alamat IP statis, dan Anda memerlukan alamat IP tambahan untuk IP virtual bidang kontrol (VIP) baru.

Mengupdate file konfigurasi cluster pengguna

Buat perubahan berikut pada file konfigurasi cluster pengguna yang ada:

  1. Tetapkan enableControlplaneV2 ke benar (true).

  2. Atau, buat bidang kontrol untuk cluster pengguna Controlplane V2 sangat tersedia (HA). Untuk beralih dari cluster non-HA ke cluster HA, ubah masterNode.replicas dari 1 menjadi 3.

  3. Tambahkan alamat IP statis (atau beberapa alamat) untuk node bidang kontrol cluster pengguna ke bagian network.controlPlaneIPBlock.ips. Hapus alamat IP (atau beberapa alamat) untuk node bidang kontrol cluster pengguna kubeception dari file blok IP cluster admin.

  4. Isi netmask dan gateway di bagian network.controlPlaneIPBlock.

  5. Jika bagian network.hostConfig kosong, isilah.

  6. Jika cluster pengguna menggunakan load balancing manual, konfigurasikan load balancer Anda untuk menyertakan IP node bidang kontrol untuk traffic bidang data:

    • (ingressVIP.80) -> (CP_tanda_IP_ADDRESSES:ingressHTTPNodePort)
    • (ingressVIP.443) -> (CP_saluran_IP_ADDRESSES:ingressHTTPSNodePort)

  7. Perbarui kolom loadBalancer.vips.controlPlaneVIP dengan alamat IP baru untuk VIP bidang kontrol.

  8. Semua kolom sebelumnya tidak dapat diubah, kecuali saat memperbarui cluster untuk migrasi. Pastikan untuk memeriksa ulang semua setelan.

  9. Jalankan gkectl diagnose cluster, dan perbaiki masalah apa pun yang ditemukan perintah.

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

    Ganti kode berikut:

    • ADMIN_CLUSTER_KUBECONFIG: jalur file cluster kubeconfig admin.

    • CLUSTER_NAME: nama cluster pengguna.

Menyesuaikan konfigurasi load balancer manual

Jika cluster pengguna Anda menggunakan load balancing manual, lakukan langkah-langkah di bagian ini. Jika tidak, lewati bagian ini.

Demikian pula untuk mengonfigurasi load balancer untuk cluster pengguna CPv2, untuk masing-masing dari tiga alamat IP node bidang kontrol baru yang Anda tentukan di bagian network.controlPlaneIPBlock, konfigurasikan pemetaan di load balancer:

  • (ingressVIP:80) -> (NEW_ ditemukan_IP_ADDRESS:ingressHTTPNodePort)
  • (ingressVIP:443) -> (NEW_ ditemukan_IP_ADDRESS:ingressHTTPNodePort)

Mengupdate cluster

Jalankan perintah berikut untuk memigrasikan cluster ke Controlplane V2:

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.