LoadBalancer במניפסט DBCluster. המסמך הזה מיועד למנהלי מסדי נתונים ולמפעילי Kubernetes שמנהלים פריסות של AlloyDB Omni ב-Kubernetes וצריכים להתאים אישית את ההתנהגות של מאזן העומסים.
כשמפעילים תנועה נכנסת חיצונית במניפסט של DBCluster, מפעיל AlloyDB Omni Kubernetes יוצר אובייקט Service של Kubernetes מסוג LoadBalancer. בפלטפורמות שונות של Kubernetes משתמשים באנוטציות בהתאמה אישית כדי לשלוט במאפיינים של מאזן העומסים, כמו הקצאה של כתובת IP פנימית או כתובת IP חיצונית.
ב-AlloyDB Omni אפשר לציין את ההערות האלה בשדה spec.primarySpec.dbLoadBalancerOptions.annotations במניפסט של DBCluster. כשיוצרים או מעדכנים את אשכול מסד הנתונים עם spec.allowExternalIncomingTraffic שמוגדר ל-true, אופרטור AlloyDB Omni מחיל את ההערות האלה על השדה metadata.annotations של האובייקט LoadBalancer Service.
הגדרת מאזן עומסים באמצעות מפרט מסד הנתונים
כדי להגדיר הערות בהתאמה אישית למאזן העומסים, מגדירים את השדה dbLoadBalancerOptions בקטע spec.primarySpec במניפסט DBCluster.
Kubernetes
ההערות מגדירות את הסוג והמאפיינים של אובייקט מאזן העומסים Service בסביבת Kubernetes. כדי לזהות את המפתחות והערכים הנתמכים של ההערות, צריך לבדוק את התיעוד של פלטפורמת Kubernetes או של הטמעת מאזן העומסים.
כדי ליצור אשכול מסד נתונים עם הערות מותאמות אישית של מאזן עומסים ולאפשר תנועה נכנסת מחוץ לאשכול Kubernetes, צריך להחיל את המניפסט הבא:
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
מחליפים את מה שכתוב בשדות הבאים:
-
DB_CLUSTER_NAME: שם לאשכול מסד הנתונים, לדוגמהmy-db-cluster. -
NAMESPACE: מרחב השמות של Kubernetes לאשכול מסד הנתונים. -
ENCODED_PASSWORD: הסיסמה של המשתמש עם הרשאת אדמין ב-postgres, מקודדת כמחרוזת base64. -
ANNOTATION_KEYו-ANNOTATION_VALUE: מפתח הערה של מאזן עומסים וערך מחרוזת שנתמכים בסביבת Kubernetes. צריך להקיף את הערך במירכאות כפולות, גם אם מדובר בערכים בוליאניים או מספריים כמו"true". אפשר לציין צמד אחד או יותר של מפתח/ערך בקטעannotations.
במניפסט הזה:
-
ANNOTATION_KEY: "ANNOTATION_VALUE": מציין הערה בהתאמה אישית שאופרטור AlloyDB Omni מוסיף לאובייקטServiceשל מאזן העומסים באשכול מסד הנתונים. -
allowExternalIncomingTraffic: true: מגדיר את השדהallowExternalIncomingTrafficלערךtrueכדי לאפשר תנועה נכנסת מחוץ לאשכול Kubernetes.
קבלת פרטי האשכול והקישוריות של מסד הנתונים
Kubernetes
כדי לוודא שמשאב אשכול מסד הנתונים נמצא בסטטוס Ready, מריצים את הפקודה הבאה:
kubectl get dbclusters.alloydbomni.dbadmin.goog -n NAMESPACE -wמחליפים את NAMESPACE במרחב השמות של Kubernetes באשכול מסד הנתונים.
הפלט אמור להיראות כך:
NAME PRIMARYENDPOINT PRIMARYPHASE DBCLUSTERPHASE
DB_CLUSTER_NAME 10.95.0.84 Ready DBClusterReady
כדי לוודא שההערה בהתאמה אישית ונקודת הקצה החיצונית שהוקצתה קיימות באובייקט Service של מאזן העומסים, מריצים את הפקודה הבאה:
kubectl get svc LOAD_BALANCER_SERVICE_NAME -n NAMESPACE -o yamlמחליפים את מה שכתוב בשדות הבאים:
-
LOAD_BALANCER_SERVICE_NAME: השם של אובייקטLoadBalancerServiceשמנוהל על ידי המפעיל. לנקודת הקצה הראשית לקריאה ולכתיבה, אופרטור AlloyDB Omni נותן את השםServiceal-DB_CLUSTER_NAME-rw-elb(אפשר גם להציג רשימה של אובייקטים מסוגServiceעל ידי הפעלתkubectl get svc -n NAMESPACE). -
NAMESPACE: השם של מרחב השמות של Kubernetes לאובייקטServiceשל מאזן העומסים.
הפלט אמור להיראות כך:
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הפלט כולל את השדות הבאים:
-
metadata.annotations: מכיל את ההערהANNOTATION_KEY: "ANNOTATION_VALUE"שהגדרתם במניפסט שלDBCluster. -
status.loadBalancer.ingress: הצגת נקודת הקצה החיצונית שהוקצתה לאובייקטServiceשל מאזן העומסים. בהתאם לסביבת Kubernetes, הבקר של מאזן העומסים מאכלס אתip(שתואם לערךPRIMARYENDPOINTשל אשכול מסד הנתונים) או אתhostname(למאזני עומסים שמבוססים על DNS, כמו ב-AWS EKS, שבהםstatus.primary.endpointsב-DBClusterמתעד את שם המארח והיציאה).