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 administratorpostgres, yang dienkode sebagai string base64.ANNOTATION_KEYdanANNOTATION_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 bagianannotations.
Dalam manifes ini:
ANNOTATION_KEY: "ANNOTATION_VALUE": menentukan anotasi kustom yang ditambahkan operator AlloyDB Omni ke objekServiceload balancer untuk cluster database Anda.allowExternalIncomingTraffic: true: menetapkan kolomallowExternalIncomingTrafficketrueuntuk 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 -wGanti 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 yamlGanti kode berikut:
LOAD_BALANCER_SERVICE_NAME: nama objekServiceLoadBalanceryang dikelola operator. Untuk endpoint baca-tulis utama, operator AlloyDB Omni menamaiServiceal-DB_CLUSTER_NAME-rw-elbini (Anda juga dapat mencantumkan objekServicedengan menjalankankubectl get svc -n NAMESPACE).NAMESPACE: nama namespace Kubernetes untuk objekServiceload 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.84Output-nya mencakup kolom berikut:
metadata.annotations: berisi anotasiANNOTATION_KEY: "ANNOTATION_VALUE"yang Anda konfigurasi dalam manifesDBCluster.status.loadBalancer.ingress: menampilkan endpoint eksternal yang ditetapkan ke objekServiceload balancer. Bergantung pada lingkungan Kubernetes Anda, pengontrol load balancer akan mengisiip(yang cocok dengan nilaiPRIMARYENDPOINTcluster database Anda) atauhostname(untuk load balancer berbasis DNS seperti di AWS EKS, tempatstatus.primary.endpointsdiDBClustermencatat nama host dan port).