Mengonfigurasi load balancer untuk AlloyDB Omni di Kubernetes

Pilih versi dokumentasi:

Untuk mengekspos cluster database AlloyDB Omni ke klien di luar cluster Kubernetes, Anda dapat mengonfigurasi Service LoadBalancer dalam manifes DBCluster. Dokumen ini ditujukan untuk administrator database dan operator Kubernetes yang mengelola deployment AlloyDB Omni di Kubernetes dan perlu menyesuaikan perilaku load balancer.

Saat Anda mengaktifkan traffic masuk eksternal dalam manifes DBCluster, operator AlloyDB Omni Kubernetes akan membuat objek Service Kubernetes dengan jenis LoadBalancer. Berbagai platform Kubernetes menggunakan anotasi kustom untuk mengontrol properti load balancer, seperti penetapan alamat IP internal atau eksternal. AlloyDB Omni memungkinkan Anda menentukan anotasi ini di kolom spec.primarySpec.dbLoadBalancerOptions.annotations pada manifes DBCluster Anda. Saat Anda membuat atau mengupdate cluster database dengan spec.allowExternalIncomingTraffic yang ditetapkan ke true, operator AlloyDB Omni akan menerapkan anotasi tersebut ke kolom metadata.annotations dari objek LoadBalancer Service.

Mengonfigurasi load balancer menggunakan spesifikasi database

Anda dapat mengonfigurasi anotasi load balancer kustom dengan menetapkan kolom dbLoadBalancerOptions di bagian spec.primarySpec pada manifes DBCluster.

Kubernetes

Anotasi menentukan jenis dan properti objek Service load balancer di lingkungan Kubernetes Anda. Periksa dokumentasi untuk platform Kubernetes atau implementasi load balancer Anda guna mengidentifikasi kunci dan nilai anotasi yang didukung.

Untuk membuat cluster database dengan anotasi load balancer kustom dan mengizinkan traffic masuk dari luar cluster Kubernetes, terapkan manifes berikut:

kubectl apply -f - <<EOF
apiVersion: v1
kind: Secret
metadata:
  name: db-pw-DB_CLUSTER_NAME
  namespace: NAMESPACE
type: Opaque
data:
  DB_CLUSTER_NAME: "ENCODED_PASSWORD"
---
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
  namespace: NAMESPACE
spec:
  databaseVersion: "18.4.0"
  primarySpec:
    adminUser:
      passwordRef:
        name: db-pw-DB_CLUSTER_NAME
    resources:
      memory: 5Gi
      cpu: 1
      disks:
      - name: DataDisk
        size: 10Gi
    dbLoadBalancerOptions:
      annotations:
        ANNOTATION_KEY: "ANNOTATION_VALUE"
  allowExternalIncomingTraffic: true
EOF

Ganti kode berikut:

  • DB_CLUSTER_NAME: nama untuk cluster database Anda—misalnya, my-db-cluster.
  • NAMESPACE: namespace Kubernetes untuk cluster database Anda.
  • ENCODED_PASSWORD: sandi untuk pengguna administrator postgres, yang dienkode sebagai string base64.
  • ANNOTATION_KEY dan ANNOTATION_VALUE: kunci anotasi load balancer dan nilai string yang didukung oleh lingkungan Kubernetes Anda. Sertakan nilai dalam tanda petik ganda, bahkan untuk nilai boolean atau numerik seperti "true". Anda dapat menentukan satu atau beberapa pasangan nilai kunci di bagian annotations.

Dalam manifes ini:

  • ANNOTATION_KEY: "ANNOTATION_VALUE": menentukan anotasi kustom yang ditambahkan operator AlloyDB Omni ke objek Service load balancer untuk cluster database Anda.
  • allowExternalIncomingTraffic: true: menetapkan kolom allowExternalIncomingTraffic ke true untuk mengizinkan traffic masuk dari luar cluster Kubernetes.

Mendapatkan detail konektivitas dan cluster database

Kubernetes

Untuk memverifikasi bahwa resource cluster database berada dalam status Ready, jalankan perintah berikut:

kubectl get dbclusters.alloydbomni.dbadmin.goog -n NAMESPACE -w

Ganti NAMESPACE dengan namespace Kubernetes untuk cluster database Anda.

Outputnya mirip dengan hal berikut ini:

NAME               PRIMARYENDPOINT   PRIMARYPHASE   DBCLUSTERPHASE
DB_CLUSTER_NAME    10.95.0.84        Ready          DBClusterReady

Untuk memverifikasi bahwa anotasi kustom dan endpoint eksternal yang ditetapkan ada di objek Service load balancer, jalankan perintah berikut:

kubectl get svc LOAD_BALANCER_SERVICE_NAME -n NAMESPACE -o yaml

Ganti kode berikut:

  • LOAD_BALANCER_SERVICE_NAME: nama objek Service LoadBalancer yang dikelola operator. Untuk endpoint baca-tulis utama, operator AlloyDB Omni menamai Service al-DB_CLUSTER_NAME-rw-elb ini (Anda juga dapat mencantumkan objek Service dengan menjalankan kubectl get svc -n NAMESPACE).
  • NAMESPACE: nama namespace Kubernetes untuk objek Service load balancer Anda.

Outputnya mirip dengan hal berikut ini:

apiVersion: v1
kind: Service
metadata:
  annotations:
    ANNOTATION_KEY: "ANNOTATION_VALUE"
  creationTimestamp: "2024-02-22T15:26:18Z"
  finalizers:
  - service.kubernetes.io/load-balancer-cleanup
  labels:
    alloydbomni.internal.dbadmin.goog/dbcluster: DB_CLUSTER_NAME
    alloydbomni.internal.dbadmin.goog/dbcluster-ns: NAMESPACE
  name: LOAD_BALANCER_SERVICE_NAME
  namespace: NAMESPACE
  ownerReferences:
  - apiVersion: alloydbomni.dbadmin.goog/v1
    blockOwnerDeletion: true
    controller: true
    kind: DBCluster
    name: DB_CLUSTER_NAME
    uid: 2dd76c9f-7698-4210-be41-6d2259840a85
  resourceVersion: "33628320"
  uid: 1f45362b-6d6f-484d-ad35-11c14e91933e
spec:
  allocateLoadBalancerNodePorts: true
  clusterIP: 10.60.4.76
  clusterIPs:
  - 10.60.4.76
  externalTrafficPolicy: Cluster
  internalTrafficPolicy: Cluster
  ipFamilies:
  - IPv4
  ipFamilyPolicy: SingleStack
  ports:
  - name: db
    nodePort: 31453
    port: 5432
    protocol: TCP
    targetPort: 5432
  selector:
    alloydbomni.internal.dbadmin.goog/dbcluster: DB_CLUSTER_NAME
    alloydbomni.internal.dbadmin.goog/dbcluster-ns: NAMESPACE
    alloydbomni.internal.dbadmin.goog/task-type: database
    dbs.internal.dbadmin.goog/ha-role: Primary
  sessionAffinity: None
  type: LoadBalancer
status:
  loadBalancer:
    ingress:
    - ip: 10.95.0.84

Output-nya mencakup kolom berikut:

  • metadata.annotations: berisi anotasi ANNOTATION_KEY: "ANNOTATION_VALUE" yang Anda konfigurasi dalam manifes DBCluster.
  • status.loadBalancer.ingress: menampilkan endpoint eksternal yang ditetapkan ke objek Service load balancer. Bergantung pada lingkungan Kubernetes Anda, pengontrol load balancer akan mengisi ip (yang cocok dengan nilai PRIMARYENDPOINT cluster database Anda) atau hostname (untuk load balancer berbasis DNS seperti di AWS EKS, tempat status.primary.endpoints di DBCluster mencatat nama host dan port).

Langkah berikutnya