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 administradorpostgres, codificada como una cadena base64.ANNOTATION_KEYyANNOTATION_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 enannotations.
En el manifiesto se muestra lo siguiente:
ANNOTATION_KEY: "ANNOTATION_VALUE": Especifica una anotación personalizada que el operador de AlloyDB Omni agrega al objetoServicedel balanceador de cargas para tu clúster de base de datos.allowExternalIncomingTraffic: true: Establece el campoallowExternalIncomingTrafficentruepara 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 -wReemplaza 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 yamlReemplaza lo siguiente:
LOAD_BALANCER_SERVICE_NAME: Es el nombre del objetoServiceLoadBalanceradministrado por el operador. Para el extremo de lectura y escritura principal, el operador de AlloyDB Omni lo denominaServiceal-DB_CLUSTER_NAME-rw-elb(también puedes enumerar objetosServiceejecutandokubectl get svc -n NAMESPACE).NAMESPACE: Es el nombre del espacio de nombres de Kubernetes para el objetoServicedel 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.84El resultado incluye los siguientes campos:
metadata.annotations: contiene la anotaciónANNOTATION_KEY: "ANNOTATION_VALUE"que configuraste en tu manifiesto deDBCluster.status.loadBalancer.ingress: Muestra el extremo externo asignado al objetoServicedel balanceador de cargas. Según tu entorno de Kubernetes, el controlador del balanceador de cargas propagaip(que coincide con el valorPRIMARYENDPOINTde tu clúster de base de datos) ohostname(para balanceadores de cargas basados en DNS, como en AWS EKS, en los questatus.primary.endpointsenDBClusterregistra el nombre de host y el puerto).