Configura un balanceador de cargas para AlloyDB Omni en Kubernetes

Selecciona una versión de la documentación:

Para exponer tu clúster de base de datos de AlloyDB Omni a clientes fuera de tu clúster de Kubernetes, puedes configurar un Service LoadBalancer en el manifiesto DBCluster. Este documento está dirigido a los administradores de bases de datos y operadores de Kubernetes que administran implementaciones de AlloyDB Omni en Kubernetes y necesitan personalizar el comportamiento del balanceador de cargas.

Cuando habilitas el tráfico entrante externo en tu manifiesto de DBCluster, el operador de AlloyDB Omni para Kubernetes crea un objeto Service de Kubernetes de tipo LoadBalancer. Las diferentes plataformas de Kubernetes usan anotaciones personalizadas para controlar las propiedades del balanceador de cargas, como la asignación de direcciones IP internas o externas. AlloyDB Omni te permite especificar estas anotaciones en el campo spec.primarySpec.dbLoadBalancerOptions.annotations de tu manifiesto DBCluster. Cuando creas o actualizas el clúster de base de datos con spec.allowExternalIncomingTraffic configurado como true, el operador de AlloyDB Omni aplica esas anotaciones al campo metadata.annotations del objeto Service de LoadBalancer.

Configura un balanceador de cargas con la especificación de la base de datos

Puedes configurar anotaciones personalizadas del balanceador de cargas estableciendo el campo dbLoadBalancerOptions en la sección spec.primarySpec de tu manifiesto de DBCluster.

Kubernetes

Las anotaciones definen el tipo y las propiedades del objeto Service del balanceador de cargas en tu entorno de Kubernetes. Consulta la documentación de tu plataforma de Kubernetes o la implementación del balanceador de cargas para identificar las claves y los valores de anotación admitidos.

Para crear un clúster de base de datos con anotaciones de balanceador de cargas personalizadas y permitir el tráfico entrante desde fuera del clúster de Kubernetes, aplica el siguiente manifiesto:

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: "16.3.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

Reemplaza lo siguiente:

  • DB_CLUSTER_NAME: Es un nombre para tu clúster de base de datos, por ejemplo, my-db-cluster.
  • NAMESPACE: Es el espacio de nombres de Kubernetes para tu clúster de base de datos.
  • ENCODED_PASSWORD: Es la contraseña del usuario administrador postgres, codificada como una cadena base64.
  • ANNOTATION_KEY y ANNOTATION_VALUE: una clave de anotación del balanceador de cargas y un valor de cadena que admite tu entorno de Kubernetes. Encierra el valor entre comillas dobles, incluso para valores booleanos o numéricos, como "true". Puedes especificar uno o más pares clave-valor en annotations.

En el manifiesto se muestra lo siguiente:

  • ANNOTATION_KEY: "ANNOTATION_VALUE": Especifica una anotación personalizada que el operador de AlloyDB Omni agrega al objeto Service del balanceador de cargas para tu clúster de base de datos.
  • allowExternalIncomingTraffic: true: Establece el campo allowExternalIncomingTraffic en true para permitir el tráfico entrante desde fuera del clúster de Kubernetes.

Obtén los detalles de la conectividad y del clúster de base de datos

Kubernetes

Para verificar que el recurso del clúster de la base de datos esté en el estado Ready, ejecuta el siguiente comando:

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

Reemplaza NAMESPACE por el espacio de nombres de Kubernetes para tu clúster de base de datos.

El resultado es similar a lo siguiente:

NAME               PRIMARYENDPOINT   PRIMARYPHASE   DBCLUSTERPHASE
DB_CLUSTER_NAME    10.95.0.84        Ready          DBClusterReady

Para verificar que la anotación personalizada y el extremo externo asignado existan en el objeto Service del balanceador de cargas, ejecuta el siguiente comando:

kubectl get svc LOAD_BALANCER_SERVICE_NAME -n NAMESPACE -o yaml

Reemplaza lo siguiente:

  • LOAD_BALANCER_SERVICE_NAME: Es el nombre del objeto Service LoadBalancer administrado por el operador. Para el extremo de lectura y escritura principal, el operador de AlloyDB Omni lo denomina Service al-DB_CLUSTER_NAME-rw-elb (también puedes enumerar objetos Service ejecutando kubectl get svc -n NAMESPACE).
  • NAMESPACE: Es el nombre del espacio de nombres de Kubernetes para el objeto Service del balanceador de cargas.

El resultado es similar a lo siguiente:

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

El resultado incluye los siguientes campos:

  • metadata.annotations: contiene la anotación ANNOTATION_KEY: "ANNOTATION_VALUE" que configuraste en tu manifiesto de DBCluster.
  • status.loadBalancer.ingress: Muestra el extremo externo asignado al objeto Service del balanceador de cargas. Según tu entorno de Kubernetes, el controlador del balanceador de cargas propaga ip (que coincide con el valor PRIMARYENDPOINT de tu clúster de base de datos) o hostname (para balanceadores de cargas basados en DNS, como en AWS EKS, en los que status.primary.endpoints en DBCluster registra el nombre de host y el puerto).

¿Qué sigue?