Bermigrasi dari load balancer Seesaw ke MetalLB

Dokumen ini menunjukkan cara bermigrasi dari load balancer Seesaw ke load balancer Metal.

Penggunaan MetalLB memiliki beberapa manfaat dibandingkan dengan opsi load balancing lainnya.

Migrasi cluster pengguna

Di file konfigurasi cluster pengguna, pilih kumpulan node, lalu tetapkan enableLoadBalancer ke true:

nodePools:
- name: pool-1
  replicas: 3
  enableLoadBalancer: true

Update cluster:

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

Selanjutnya, hapus bagian Seesaw dari file, dan tambahkan bagian MetalLB.

Kemudian, update lagi cluster:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG

Pastikan komponen metallb berhasil dijalankan:

kubectl --kubeconfig USER_CLUSTER_KUBECONFIG get pods \
    --namespace kube-system --selector app=metallb

Output menunjukkan Pod untuk pengontrol dan speaker MetalLB. Contoh:

metallb-controller-744884bf7b-rznr9   1/1     Running
metallb-speaker-6n8ws                 1/1     Running
metallb-speaker-nb52z                 1/1     Running
metallb-speaker-rq4pp                 1/1     Running

Setelah migrasi berhasil, hapus VM Seesaw secara manual, yang sudah dinonaktifkan, untuk cluster pengguna. Anda dapat menemukan nama VM Seesaw di bagian vmnames pada file seesaw-for-[USERCLUSTERNAME].yaml di direktori konfigurasi Anda.

Contoh: Cluster pengguna, alamat IP statis

Misalkan Anda memiliki cluster pengguna yang menggunakan alamat IP statis untuk node clusternya. Misalkan juga cluster memiliki dua Service dengan jenis LoadBalancer, dan alamat eksternal untuk Layanan tersebut adalah 172.16.21.41 dan 172.16.21.45.

Sesuaikan file konfigurasi cluster pengguna sebagai berikut:

  • Tetap gunakan bagian network.hostConfig.
  • Tetapkan loadBalancer.kind ke MetalLB.
  • Hapus bagian loadBalancer.seesaw.
  • Tambahkan bagian loadBalancer.metalLB.

Contoh:

network:
  hostConfig:
    dnsServers:
    - "172.16.255.1"
    - "172.16.255.2"
    ntpServers:
    - "216.239.35.0"
loadBalancer:
  vips:
    controlPlaneVIP: "172.16.20.30"
    ingressVIP: "172.16.20.31"
  kind: MetalLB Seesaw
  seesaw:
    ipBlockFilePath: "user-cluster-1-ipblock.yaml"
    vrid: 1
    masterIP: ""
    cpus: 4
    memoryMB: 3072
  metalLB:
    addressPools:
    - name: "address-pool-1"
      addresses:
      - "172.16.20.31/32"
      - "172.16.20.40 - 172.16.21.49"
  

Poin utama dari contoh sebelumnya:

  • Meskipun cluster tidak akan lagi menggunakan load balancer Seesaw, bagian network.hostConfig diperlukan karena node cluster menggunakan alamat IP statis.

  • Nilai ingressVIP muncul di kumpulan alamat MetalLB.

  • Alamat IP eksternal, 172.16.21.41 dan 172.16.21.45, untuk Layanan jenis LoadBalancer yang ada disertakan dalam kumpulan alamat MetalLB.

Contoh: cluster pengguna kubeception, DHCP

Misalkan Anda memiliki cluster pengguna yang menggunakan DHCP untuk node clusternya. Juga, anggaplah bahwa cluster memiliki dua Layanan dengan jenis LoadBalancer, dan alamat eksternal untuk Layanan tersebut adalah 172.16.21.61 dan 172.16.21.65.

Sesuaikan file konfigurasi cluster pengguna sebagai berikut:

  • Hapus bagian network.hostConfig.
  • Tetapkan loadBalancer.kind ke MetalLB.
  • Hapus bagian loadBalancer.seesaw.
  • Tambahkan bagian loadBalancer.metalLB.

Contoh:

enableControlplaneV2: false
network:
  hostConfig:
    dnsServers:
    - "172.16.255.1"
    - "172.16.255.2"
    ntpServers:
    - "216.239.35.0"
loadBalancer:
  vips:
    controlPlaneVIP: "172.16.20.50"
    ingressVIP: "172.16.20.51"
  kind: MetalLB Seesaw
  seesaw:
    ipBlockFilePath: "user-cluster-2-ipblock.yaml"
    vrid: 1
    masterIP: ""
    cpus: 4
    memoryMB: 3072
  metalLB:
    addressPools:
    - name: "address-pool-1"
      addresses:
      - "172.16.20.51/32"
      - "172.16.20.60 - 172.16.21.69"
  

Poin utama dari contoh sebelumnya:

  • Cluster tersebut tidak akan lagi menggunakan load balancer Seesaw, dan cluster tidak menggunakan alamat IP statis untuk node clusternya. Jadi bagian network.hostConfig tidak diperlukan.

  • Nilai ingressVIP muncul di kumpulan alamat MetalLB.

  • Alamat IP eksternal, 172.16.21.61 dan 172.16.21.65, untuk Layanan jenis LoadBalancer yang ada disertakan dalam kumpulan alamat MetalLB.

Contoh: Cluster pengguna Controlplane V2, DHCP

Misalkan Anda memiliki cluster pengguna yang mengaktifkan Controlplane V2, dan menggunakan DHCP untuk node pekerjanya. Misalkan juga cluster memiliki dua Layanan jenis LoadBalancer, dan alamat eksternal untuk Layanan tersebut adalah 172.16.21.81 dan 172.16.21.85.

Sesuaikan file konfigurasi cluster pengguna sebagai berikut:

  • Tetap gunakan bagian network.hostconfig.
  • Tetapkan loadBalancer.kind ke MetalLB.
  • Hapus bagian loadBalancer.seesaw.
  • Tambahkan bagian loadBalancer.metalLB.

Contoh:

enableControlplaneV2: true
network:
  hostConfig:
    dnsServers:
    - "172.16.255.1"
    - "172.16.255.2"
    ntpServers:
    - "216.239.35.0"
loadBalancer:
  vips:
    controlPlaneVIP: "172.16.20.70"
    ingressVIP: "172.16.20.71"
  kind: MetalLB Seesaw
  seesaw:
    ipBlockFilePath: "user-cluster-2-ipblock.yaml"
    vrid: 1
    masterIP: ""
    cpus: 4
    memoryMB: 3072
  metalLB:
    addressPools:
    - name: "address-pool-1"
      addresses:
      - "172.16.20.71/32"
      - "172.16.20.80 - 172.16.21.89"
  

Poin utama dari contoh sebelumnya:

  • Cluster tidak akan lagi menggunakan alamat IP statis untuk worker node, tetapi akan menggunakan alamat IP statis untuk node bidang kontrol. Jadi, bagian network.hostConfig diperlukan.

  • Nilai ingressVIP muncul di kumpulan alamat MetalLB.

  • Alamat IP eksternal, 172.16.21.81 dan 172.16.21.85, untuk Layanan jenis LoadBalancer yang ada disertakan dalam kumpulan alamat MetalLB.

Migrasi cluster admin

Di file konfigurasi cluster admin Anda, tetapkan loadBalancer.kind ke MetalLB, lalu hapus bagian loadBalancer.seesaw.

Update cluster:

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

Pastikan komponen metallb berhasil dijalankan:

kubectl --kubeconfig ADMIN_CLUSTER_KUBECONFIG get pods \
    --namespace kube-system --selector app=metallb

Output menunjukkan Pod untuk pengontrol dan speaker MetalLB. Contoh:

metallb-controller-744884bf7b-rznr9   1/1     Running
metallb-speaker-6n8ws                 1/1     Running
metallb-speaker-nb52z                 1/1     Running
metallb-speaker-rq4pp                 1/1     Running

Setelah migrasi berhasil, hapus VM Seesaw secara manual, yang sudah dinonaktifkan, untuk cluster admin. Anda dapat menemukan nama VM Seesaw di bagian vmnames pada file seesaw-for-gke-admin.yaml di direktori konfigurasi Anda.

Contoh: Cluster admin, alamat IP statis

Misalkan Anda memiliki cluster admin yang menggunakan alamat IP statis untuk node clusternya.

Sesuaikan file konfigurasi cluster admin sebagai berikut:

  • Tetap gunakan bagian network.hostConfig.
  • Tetapkan loadBalancer.kind ke MetalLB.
  • Hapus bagian loadBalancer.seesaw.

Contoh:

network:
  hostConfig:
    dnsServers:
    - "172.16.255.1"
    - "172.16.255.2"
    ntpServers:
    - "216.239.35.0"
loadBalancer:
  vips:
    controlPlaneVIP: "172.16.20.30"
  kind: MetalLB Seesaw
  seesaw:
    ipBlockFilePath: "user-cluster-1-ipblock.yaml"
    vrid: 1
    masterIP: ""
    cpus: 4
    memoryMB: 3072
  

Poin utama dari contoh sebelumnya:

  • Meskipun cluster tidak akan lagi menggunakan load balancer Seesaw, bagian network.hostConfig diperlukan karena node cluster menggunakan alamat IP statis.

Contoh: Cluster Admin, DHCP

Misalkan Anda memiliki cluster admin yang menggunakan DHCP untuk node cluster-nya.

Sesuaikan file konfigurasi cluster admin sebagai berikut:

  • Hapus bagian network.hostConfig.
  • Tetapkan loadBalancer.kind ke MetalLB.
  • Hapus bagian loadBalancer.seesaw.

Contoh:

network:
  hostConfig:
    dnsServers:
    - "172.16.255.1"
    - "172.16.255.2"
    ntpServers:
    - "216.239.35.0"
loadBalancer:
  vips:
    controlPlaneVIP: "172.16.20.30"
  kind: MetalLB Seesaw
  seesaw:
    ipBlockFilePath: "user-cluster-1-ipblock.yaml"
    vrid: 1
    masterIP: ""
    cpus: 4
    memoryMB: 3072
  

Poin utama dari contoh sebelumnya:

  • Cluster tersebut tidak akan lagi menggunakan load balancer Seesaw, dan cluster tidak menggunakan alamat IP statis untuk node clusternya. Jadi bagian network.hostConfig tidak diperlukan.

Pemecahan masalah

Jika gkectl update gagal selama migrasi cluster pengguna, dan Pod metallb tidak berjalan di cluster pengguna, aktifkan VM Seesaw cluster pengguna secara manual. Tindakan ini akan memulihkan traffic ke VIP yang saat ini digunakan. Namun, VIP yang baru dibuat mungkin tidak disalurkan oleh Seesaw VM jika Pod load-balancer-seesaw tidak berjalan. Jika demikian, buat tiket dukungan.

Jika gkectl update gagal selama migrasi cluster admin, dan Pod metallb tidak berjalan di cluster admin, aktifkan secara manual cluster admin Seesaw VM. Hal ini memungkinkan traffic ke VIP bidang kontrol yang saat ini digunakan agar cluster pengguna dapat berfungsi lagi. Namun, VIP untuk bidang kontrol cluster admin itu sendiri mungkin tidak berfungsi. Dalam hal ini, edit file kubeconfig cluster admin agar langsung menggunakan alamat IP node bidang kontrol cluster admin.

Selain itu, di namespace kube-system, ubah jenis Layanan kube-apiserver dari ClusterIP menjadi LoadBalancer. Jika perlu, buat tiket dukungan.