Mengaktifkan mode load balancing manual

Sebaiknya Anda mengonfigurasi salah satu mode load balancing berikut:

  • Dengan mode paket, Google Distributed Cloud menyediakan dan mengelola load balancer. Anda tidak perlu mendapatkan lisensi untuk load balancer, dan jumlah penyiapan yang harus Anda lakukan sangat minim.

  • Dengan mode manual, Google Distributed Cloud akan menggunakan load balancer pilihan Anda, seperti F5 BIG-IP atau Citrix. Mode load balancing manual mengharuskan Anda melakukan lebih banyak konfigurasi daripada dengan mode terpaket.

Load balancing manual didukung untuk jenis cluster berikut:

  • Cluster pengguna yang mengaktifkan Controlplane V2. Dengan Controlplane V2, node bidang kontrol untuk cluster pengguna berada di cluster pengguna itu sendiri.

  • Cluster pengguna yang menggunakan kubeception. Istilah kubeception mengacu pada kasus ketika bidang kontrol untuk cluster pengguna berjalan pada satu atau beberapa node di cluster admin. Jika Controlplane V2 tidak diaktifkan, cluster pengguna akan menggunakan kubeception.

Halaman ini menjelaskan langkah-langkah yang perlu dilakukan jika Anda memilih untuk menggunakan mode load balancing manual.

Dalam topik ini, Anda menyisihkan alamat IP untuk node bidang kontrol dan node pekerja untuk digunakan nanti. Anda juga menyisihkan alamat IP untuk IP virtual (VIP) dan menentukan nilai nodePort. Idenya adalah Anda memilih alamat IP dan nilai nodePort yang ingin digunakan, lalu mencatatnya dalam spreadsheet atau alat lainnya. Jika sudah siap untuk membuat cluster, Anda memerlukan alamat IP dan nilai nodePort guna mengisi file konfigurasi untuk cluster admin dan cluster pengguna, serta file blok IP untuk cluster Anda.

Anda juga memerlukan alamat IP dan nilai nodePort saat mengonfigurasi load balancer untuk cluster pengguna secara manual.

Mengesampingkan alamat IP node

Dengan mode load balancing manual, Anda tidak dapat menggunakan DHCP. Anda harus menentukan alamat IP statis untuk node cluster. Anda perlu menyisihkan cukup alamat untuk node di cluster admin dan node di semua cluster pengguna yang ingin Anda buat. Untuk mengetahui detail tentang jumlah alamat IP node yang harus disisihkan, lihat Merencanakan alamat IP (Controlplane V2) dan Merencanakan alamat IP (kubeception).

Konfigurasi alamat IP

Tempat Anda mengonfigurasi alamat IP statis yang telah Anda sisihkan bergantung pada jenis cluster dan apakah Controlplane V2 diaktifkan di cluster pengguna Anda.

Cluster admin ketersediaan tinggi (HA)

Tabel berikut menjelaskan penggunaan alamat IP dan tempat Anda mengonfigurasinya untuk cluster admin HA.

IP statis Konfigurasi
Node bidang kontrol File konfigurasi cluster admin di bagian network.controlPlaneIPBlock.ips
1.16 dan yang lebih lama: Node add-on File blok IP cluster admin dan tambahkan jalur di kolom network.ipMode.ipBlockFilePath pada file konfigurasi cluster admin

Pada versi 1.28 dan yang lebih tinggi, cluster admin HA baru tidak memiliki node add-on, sehingga Anda tidak perlu menyisihkan alamat IP untuk node add-on seperti pada versi sebelumnya.

Cluster admin non-HA

Tabel berikut menjelaskan alamat IP dan tempat Anda mengonfigurasinya untuk cluster admin non-HA.

IP statis Konfigurasi
Node bidang kontrol File blok IP cluster admin dan tambahkan jalur di kolom network.ipMode.ipBlockFilePath pada file konfigurasi cluster admin
Node add-on File blok IP cluster admin

Pada versi 1.28 dan yang lebih tinggi, semua cluster admin baru harus berupa cluster dengan ketersediaan tinggi (HA) dengan 3 node bidang kontrol.

Cluster pengguna CP V2

Tabel berikut menjelaskan alamat IP dan tempat Anda mengonfigurasinya untuk cluster pengguna yang mengaktifkan Controlplane V2.

IP statis Konfigurasi
Node bidang kontrol File konfigurasi cluster pengguna di bagian network.controlPlaneIPBlock.ips
Node pekerja File blok IP cluster pengguna, lalu tambahkan jalur di kolom network.ipMode.ipBlockFilePath pada file konfigurasi cluster pengguna

Cluster pengguna Kubeception

Tabel berikut menjelaskan penggunaan alamat IP dan tempat Anda mengonfigurasinya untuk cluster pengguna yang menggunakan kubeception.

IP statis Konfigurasi
Node bidang kontrol File blok IP cluster admin dan tambahkan jalur di kolom network.ipMode.ipBlockFilePath pada file konfigurasi cluster admin
Node pekerja File blok IP cluster pengguna, lalu tambahkan jalur di kolom network.ipMode.ipBlockFilePath pada file konfigurasi cluster pengguna

Mengesampingkan alamat IP untuk VIP

Terlepas dari apakah Anda menggunakan mode load balancing terintegrasi, dipaketkan, atau manual, Anda harus menyisihkan beberapa alamat IP yang ingin digunakan untuk IP virtual (VIP) untuk load balancing. VIP ini memungkinkan klien eksternal menjangkau server Kubernetes API dan layanan masuk Anda di cluster pengguna.

Mengonfigurasi VIP

Tempat Anda mengonfigurasi VIP bergantung pada jenis cluster.

Cluster admin ketersediaan tinggi (HA)

Tabel berikut menjelaskan kegunaan VIP dan di mana Anda mengonfigurasinya untuk cluster admin HA.

VIP Konfigurasi
VIP untuk server Kubernetes API cluster admin File konfigurasi cluster admin di kolom loadBalancer.vips.controlPlaneVIP
1.15 dan yang lebih rendah: Add-on VIP File konfigurasi cluster admin di kolom loadBalancer.vips.addonsVIP

Perhatikan perbedaan versi berikut:

  • Pada versi 1.16 dan yang lebih tinggi, Anda tidak perlu mengonfigurasi VIP add-on untuk cluster admin HA.

  • Pada versi 1.28 dan yang lebih tinggi, cluster admin dengan ketersediaan tinggi (HA) baru tidak memiliki node add-on.

Cluster admin non-HA

Tabel berikut menjelaskan kegunaan VIP dan tempat Anda mengonfigurasinya untuk cluster admin non-HA.

VIP Konfigurasi
VIP untuk server Kubernetes API cluster admin File konfigurasi cluster admin di kolom loadBalancer.vips.controlPlaneVIP
1.15 dan yang lebih rendah: Add-on VIP File konfigurasi cluster admin di kolom loadBalancer.vips.addonsVIP

Perhatikan perbedaan versi berikut:

Pada versi 1.16 dan yang lebih tinggi, Anda tidak perlu mengonfigurasi VIP add-on untuk cluster admin non-HA.

Cluster pengguna CP V2

Tabel berikut menjelaskan kegunaan VIP dan di mana Anda mengonfigurasinya untuk cluster pengguna dengan Controlplane V2 yang diaktifkan.

VIP Konfigurasi
VIP untuk server Kubernetes API cluster pengguna File konfigurasi cluster pengguna di kolom loadBalancer.vips.controlPlaneVIP
VIP untuk layanan masuk di cluster pengguna File konfigurasi cluster pengguna di kolom loadBalancer.vips.ingressVIP

Cluster pengguna Kubeception

Tabel berikut menjelaskan kegunaan VIP dan di mana Anda mengonfigurasinya untuk cluster pengguna yang menggunakan kubeception.

VIP Konfigurasi
VIP untuk server Kubernetes API cluster pengguna File konfigurasi cluster pengguna di kolom loadBalancer.vips.controlPlaneVIP
VIP untuk layanan masuk di cluster pengguna File konfigurasi cluster pengguna di kolom loadBalancer.vips.ingressVIP

Mengesampingkan nilai nodePort

Di Google Distributed Cloud, server Kubernetes API dan layanan masuk terekspos oleh Layanan Kubernetes. Dengan mode load balancing manual, Anda harus memilih nilai nodePort sendiri untuk Layanan ini. Pilih nilai dalam rentang 30000 - 32767.

Mengonfigurasi nilai nodePort

Tempat Anda mengonfigurasi nilai nodePort bergantung pada apakah cluster pengguna telah mengaktifkan ControlPlane V2 atau tidak.

Cluster admin ketersediaan tinggi (HA)

Tabel berikut menjelaskan kegunaan nodePort dan tempat Anda mengonfigurasinya untuk cluster admin HA.

nodePort Konfigurasi
1.15 dan yang lebih rendah: nodePort untuk node add-on File konfigurasi cluster admin di kolom loadBalancer.manualLB.addonsNodePort

Pada versi 1.16 dan yang lebih tinggi, Anda tidak perlu mengonfigurasi nodePort untuk node add-on untuk cluster admin HA.

Cluster admin non-HA

Tabel berikut menjelaskan kegunaan nilai nodePort dan tempat Anda mengonfigurasinya untuk cluster admin non-HA.

nodePort Konfigurasi
1.16 dan yang lebih lama: nodePort untuk server Kubernetes API pada cluster admin 1.15 dan yang lebih lama: File konfigurasi cluster admin di kolom loadBalancer.vips.controlPlaneNodePort
1.15 dan yang lebih lama: nodePort untuk node add-on File konfigurasi cluster admin di kolom loadBalancer.manualLB.addonsNodePort

Pada versi 1.16 dan yang lebih tinggi, Anda tidak perlu mengonfigurasi nodePort untuk node add-on untuk cluster admin non-HA.

Cluster pengguna CP V2

Tabel berikut menjelaskan kegunaan nodePorts dan tempat Anda mengonfigurasinya untuk cluster pengguna yang mengaktifkan Controlplane V2.

nodePorts Konfigurasi
nodePort HTTP untuk layanan masuk di cluster pengguna File konfigurasi cluster pengguna di loadBalancer.manualLB.ingressHTTPNodePort
nodePort HTTPS untuk layanan masuk di cluster pengguna File konfigurasi cluster pengguna di loadBalancer.manualLB.ingressHTTPSNodePort

Anda tidak perlu mengonfigurasi nodePort untuk VIP bidang kontrol karena Google Distributed Cloud menangani load balancing ke node bidang kontrol untuk cluster pengguna yang mengaktifkan Controlplane V2.

Cluster pengguna Kubeception

Tabel berikut menjelaskan kegunaan nilai nodePort dan tempat Anda mengonfigurasinya untuk cluster pengguna yang menggunakan kubeception.

nodePort Konfigurasi
nodePort untuk server Kubernetes API cluster pengguna File konfigurasi cluster pengguna di kolom loadBalancer.manualLB.controlPlaneNodePort
nodePort untuk server Konnektivitas cluster pengguna (server Konnectivity menggunakan VIP bidang kontrol) File konfigurasi cluster pengguna di kolom loadBalancer.manualLB.konnectivityServerNodePort
nodePort HTTP untuk layanan masuk di cluster pengguna File konfigurasi cluster pengguna di loadBalancer.manualLB.ingressHTTPNodePort
nodePort HTTPS untuk layanan masuk di cluster pengguna File konfigurasi cluster pengguna di loadBalancer.manualLB.ingressHTTPSNodePort

Contoh file konfigurasi cluster

Contoh berikut menunjukkan sebagian dari file konfigurasi cluster pengguna dan admin:

Cluster admin ketersediaan tinggi (HA)

  • Versi 1.16 dan yang lebih baru:

    network:
  controlPlaneIPBlock:
    netmask: "255.255.248.0"
    gateway: "21.0.143.254"
    ips:
    - ip: "21.0.140.226"
      hostname: "admin-cp-vm-1"
    - ip: "21.0.141.48"
      hostname: "admin-cp-vm-2"
    - ip: "21.0.141.65"
      hostname: "admin-cp-vm-3"
loadBalancer:
  vips:
    controlPlaneVIP: "172.16.21.40"
  kind: ManualLB

  • Versi 1.15 dan yang lebih lama memerlukan VIP dan nodeport untuk node add-on.

    network:
  controlPlaneIPBlock:
    netmask: "255.255.248.0"
    gateway: "21.0.143.254"
    ips:
    - ip: "21.0.140.226"
      hostname: "admin-cp-vm-1"
    - ip: "21.0.141.48"
      hostname: "admin-cp-vm-2"
    - ip: "21.0.141.65"
      hostname: "admin-cp-vm-3"
loadBalancer:
  vips:
    controlPlaneVIP: "172.16.21.40"
    addonsVIP: "203.0.113.4"
  kind: ManualLB
  manualLB:
    addonsNodePort: 31405

Cluster admin non-HA

  • Versi 1.16 dan yang lebih baru:

    network:
  ipMode:
    type: static
    ipBlockFilePath: "ipblock-admin.yaml"
loadBalancer:
  vips:
    controlPlaneVIP: "172.16.21.40"
  kind: ManualLB
  manualLB:
    controlPlaneNodePort: 30562

  • Versi 1.15 dan yang lebih lama memerlukan VIP dan nodeport untuk node add-on.

    network:
ipMode:
  type: static
  ipBlockFilePath: "ipblock-admin.yaml"
loadBalancer:
vips:
  controlPlaneVIP: "172.16.21.40"
  addonsVIP: "172.16.21.41"
kind: ManualLB
manualLB:
  controlPlaneNodePort: 30562
  addonsNodePort: 30563

Cluster pengguna CP V2

network:
  ipMode:
    type: static
    ipBlockFilePath: "ipblock1.yaml"
  controlPlaneIPBlock:
    netmask: "255.255.255.0"
    gateway: "172.16.21.1"
    ips:
    - ip: "172.16.21.6"
      hostname: "cp-vm-1"
    - ip: "172.16.21.7"
      hostname: "cp-vm-2"
    - ip: "172.16.21.8"
      hostname: "cp-vm-3"
loadBalancer:
  vips:
    controlPlaneVIP: "172.16.21.40"
    ingressVIP: "172.16.21.30"
  kind: ManualLB
  manualLB:
    ingressHTTPNodePort: 30243
    ingressHTTPSNodePort: 30879

Cluster pengguna Kubeception

network:
  ipMode:
    type: static
    ipBlockFilePath: "ipblock1.yaml"
loadBalancer:
  vips:
    controlPlaneVIP: "172.16.21.40"
    ingressVIP: "172.16.21.30"
  kind: ManualLB
  manualLB:
    ingressHTTPNodePort: 30243
    ingressHTTPSNodePort: 30879
    konnectivityServerNodePort: 30563
    controlPlaneNodePort: 30562

Mengonfigurasi load balancer

Gunakan konsol pengelolaan atau alat load balancer untuk mengonfigurasi pemetaan berikut di load balancer. Cara melakukannya bergantung pada load balancer Anda.

Cluster admin ketersediaan tinggi (HA)

Traffic ke node bidang kontrol

Google Distributed Cloud secara otomatis menangani load balancing traffic bidang kontrol untuk cluster admin HA. Meskipun tidak perlu mengonfigurasi pemetaan di load balancer, Anda harus menentukan alamat IP di kolom loadBalancer.vips.controlPlaneVIP.

Traffic ke layanan di node add-on

1.15 dan yang lebih lama: Tabel berikut menunjukkan pemetaan ke alamat IP dan nilai nodePort untuk traffic ke layanan di node add-on:

  • (addonsVIP:8443) -> (NODE_IP_ADDRESSES:addonsNodePort)

Tambahkan pemetaan ini untuk semua node di cluster admin, baik node bidang kontrol maupun node add-on.

Pada versi 1.16 dan yang lebih tinggi, Anda tidak perlu mengonfigurasi pemetaan ini untuk node add-on untuk cluster admin HA.

Cluster admin non-HA

Lalu lintas bidang kontrol

Berikut ini adalah pemetaan ke alamat IP dan nilai nodePort untuk node bidang kontrol:

  • (controlPlaneVIP:443) -> (NODE_IP_ADDRESSES:controlPlaneNodePort)

Tambahkan pemetaan ini untuk semua node di cluster admin, baik node bidang kontrol maupun node add-on.

Traffic ke layanan di node add-on

1.15 dan yang lebih lama: Tabel berikut menunjukkan pemetaan ke alamat IP dan nilai nodePort untuk layanan yang berjalan di node add-on:

  • (addonsVIP:8443) -> (NODE_IP_ADDRESSES:addonsNodePort)

Tambahkan pemetaan ini untuk semua node di cluster admin, baik node bidang kontrol maupun node add-on.

Pada versi 1.16 dan yang lebih tinggi, Anda tidak perlu mengonfigurasi pemetaan ini untuk node add-on untuk cluster admin non-HA.

Cluster pengguna CP V2

Lalu lintas bidang kontrol

Google Distributed Cloud secara otomatis menangani load balancing traffic bidang kontrol untuk cluster pengguna yang mengaktifkan Controlplane V2. Meskipun tidak perlu mengonfigurasi pemetaan di load balancer, Anda harus menentukan alamat IP di kolom loadBalancer.vips.controlPlaneVIP.

Traffic bidang data

Berikut adalah pemetaan ke alamat IP dan nilai nodePort untuk traffic bidang data:

  • (ingressVIP:80) -> (NODE_IP_ADDRESSES:ingressHTTPNodePort)
  • (ingressVIP:443) -> (NODE_IP_ADDRESSES:ingressHTTPSNodePort)

Tambahkan pemetaan ini untuk semua node di cluster pengguna, baik node bidang kontrol maupun node pekerja. Karena Anda mengonfigurasi NodePort pada cluster, Kubernetes akan membuka NodePort di semua node cluster. Hal ini memungkinkan node apa pun di cluster menangani traffic bidang data.

Setelah Anda mengonfigurasi pemetaan, load balancer akan memproses traffic di alamat IP yang telah dikonfigurasi untuk VIP traffic masuk cluster pengguna di port HTTP dan HTTPS standar. Load balancer merutekan permintaan ke node mana pun dalam cluster. Setelah permintaan dirutekan ke salah satu node cluster, jaringan Kubernetes internal akan mengambil alih dan merutekan permintaan tersebut ke Pod tujuan.

Cluster pengguna Kubeception

Lalu lintas bidang kontrol

Berikut ini adalah pemetaan ke alamat IP dan nilai nodePort untuk traffic bidang kontrol:

  • (controlPlaneVIP:443) -> (NODE_IP_ADDRESSES:controlPlaneNodePort)
  • (controlPlaneVIP:8132) -> (NODE_IP_ADDRESSES:konnectivityServerNodePort)

Tambahkan pemetaan ini untuk semua node di cluster admin, baik cluster admin maupun node bidang kontrol cluster pengguna.

Traffic bidang data

Berikut adalah pemetaan ke alamat IP dan nilai nodePort untuk traffic bidang data:

  • (ingressVIP:80) -> (NODE_IP_ADDRESSES:ingressHTTPNodePort)
  • (ingressVIP:443) -> (NODE_IP_ADDRESSES:ingressHTTPSNodePort)

Tambahkan pemetaan ini untuk semua node di cluster pengguna. Dengan cluster pengguna yang menggunakan kubeception, semua node dalam cluster adalah worker node.

Selain persyaratan sebelumnya, sebaiknya Anda mengonfigurasi load balancer untuk mereset koneksi klien saat mendeteksi kegagalan node backend. Tanpa konfigurasi ini, klien server Kubernetes API dapat berhenti merespons selama beberapa menit saat instance server nonaktif, yang dapat menyebabkan ketidakstabilan di bidang kontrol Kubernetes.

  • Dengan F5 BIG-IP, setelan ini disebut Action On Service Down di halaman konfigurasi kumpulan backend.
  • Dengan HAProxy, setelan ini disebut sesi penonaktifan on-marked-down di konfigurasi server backend.
  • Jika menggunakan load balancer lain, Anda harus membaca dokumentasi untuk menemukan setelan yang setara.

Mendapatkan dukungan untuk load balancing manual

Google tidak menyediakan dukungan untuk load balancer yang dikonfigurasi menggunakan mode load balancing manual. Jika Anda mengalami masalah dengan load balancer, hubungi vendor load balancer.

Langkah selanjutnya