הגדרת מאזן עומסים ל-AlloyDB Omni ב-Kubernetes

בוחרים גרסת תיעוד:

כדי לחשוף את אשכול מסד הנתונים של AlloyDB Omni ללקוחות מחוץ לאשכול Kubernetes, אתם יכולים להגדיר שירות 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: השם של אובייקט LoadBalancer Service שמנוהל על ידי המפעיל. לנקודת הקצה הראשית לקריאה ולכתיבה, אופרטור AlloyDB Omni נותן את השם Service al-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 מתעד את שם המארח והיציאה).

המאמרים הבאים