Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Clúster compartido multi-clúster sin una malla de servicios

Puedes distribuir los clústeres fragmentados de MongoDB en varios clústeres de Kubernetes. Con la funcionalidad de múltiples clústeres, puedes:

  • Mejora la resiliencia de tu implementación distribuyéndolo en múltiples clústeres de Kubernetes, cada uno en una región geográfica diferente.

  • Configura tu implementación para particionado geográfico implementando nodos primarios de particiones específicas en diferentes clústeres de Kubernetes que estén ubicados más cerca de la aplicación o de los clientes que dependen de esos datos, reduciendo la latencia.

  • Optimiza tu implementación para mejorar el rendimiento. Por ejemplo, puedes implementar nodos analíticos de solo lectura para todas o algunas particiones en diferentes clústeres de Kubernetes, o con asignaciones de recursos personalizadas.

Requisitos previos

Antes de comenzar el siguiente procedimiento, tome las siguientes acciones:

# This script builds on top of the environment configured in the setup guides.# It depends (uses) the following env variables defined there to work correctly.# If you don't use the setup guide to bootstrap the environment, then define them here.#  ${K8S_CLUSTER_0_CONTEXT_NAME}#  ${K8S_CLUSTER_1_CONTEXT_NAME}#  ${K8S_CLUSTER_2_CONTEXT_NAME}#  ${MDB_NAMESPACE}#  ${CUSTOM_DOMAIN}
export SC_RESOURCE_NAME=mdb-shexport MONGODB_VERSION="8.0.5-ent"
export MDB_CLUSTER_0_EXTERNAL_DOMAIN="${K8S_CLUSTER_0}.${CUSTOM_DOMAIN}"export MDB_CLUSTER_1_EXTERNAL_DOMAIN="${K8S_CLUSTER_1}.${CUSTOM_DOMAIN}"export MDB_CLUSTER_2_EXTERNAL_DOMAIN="${K8S_CLUSTER_2}.${CUSTOM_DOMAIN}"

Código fuente

Se puede encontrar todo el código fuente incluido en el repositorio de MongoDB Kubernetes operador.

Procedimiento

1

Generar certificados TLS.

Ejecuta el siguiente comando para generar los certificados TLS requeridos para cada partición, tu mongos y tus servidores de configuración.

kubectl apply --context "${K8S_CLUSTER_0_CONTEXT_NAME}" -n "${MDB_NAMESPACE}" -f - <<EOFapiVersion: cert-manager.io/v1kind: Certificatemetadata:  name: mdb-sh-certspec:  dnsNames:  - "*.${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_1_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_2_EXTERNAL_DOMAIN}"  duration: 240h0m0s  issuerRef:    name: my-ca-issuer    kind: ClusterIssuer  renewBefore: 120h0m0s  secretName: cert-prefix-mdb-sh-cert  usages:  - server auth  - client auth---apiVersion: cert-manager.io/v1kind: Certificatemetadata:  name: mdb-sh-0-certspec:  dnsNames:  - "*.${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_1_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_2_EXTERNAL_DOMAIN}"  duration: 240h0m0s  issuerRef:    name: my-ca-issuer    kind: ClusterIssuer  renewBefore: 120h0m0s  secretName: cert-prefix-mdb-sh-0-cert  usages:  - server auth  - client auth---apiVersion: cert-manager.io/v1kind: Certificatemetadata:  name: mdb-sh-1-certspec:  dnsNames:  - "*.${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_1_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_2_EXTERNAL_DOMAIN}"  duration: 240h0m0s  issuerRef:    name: my-ca-issuer    kind: ClusterIssuer  renewBefore: 120h0m0s  secretName: cert-prefix-mdb-sh-1-cert  usages:  - server auth  - client auth---apiVersion: cert-manager.io/v1kind: Certificatemetadata:  name: mdb-sh-2-certspec:  dnsNames:  - "*.${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_1_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_2_EXTERNAL_DOMAIN}"  duration: 240h0m0s  issuerRef:    name: my-ca-issuer    kind: ClusterIssuer  renewBefore: 120h0m0s  secretName: cert-prefix-mdb-sh-2-cert  usages:  - server auth  - client auth---apiVersion: cert-manager.io/v1kind: Certificatemetadata:  name: mdb-sh-config-certspec:  dnsNames:  - "*.${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_1_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_2_EXTERNAL_DOMAIN}"  duration: 240h0m0s  issuerRef:    name: my-ca-issuer    kind: ClusterIssuer  renewBefore: 120h0m0s  secretName: cert-prefix-mdb-sh-config-cert  usages:  - server auth  - client auth---apiVersion: cert-manager.io/v1kind: Certificatemetadata:  name: mdb-sh-mongos-certspec:  dnsNames:  - "*.${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_1_EXTERNAL_DOMAIN}"  - "*.${MDB_CLUSTER_2_EXTERNAL_DOMAIN}"  duration: 240h0m0s  issuerRef:    name: my-ca-issuer    kind: ClusterIssuer  renewBefore: 120h0m0s  secretName: cert-prefix-mdb-sh-mongos-cert  usages:  - server auth  - client authEOF
2

Implementa un recurso personalizado de MongoDB.

Ejecute el siguiente comando para implementar los recursos personalizados.

kubectl apply --context "${K8S_CLUSTER_0_CONTEXT_NAME}" -n "${MDB_NAMESPACE}" -f - <<EOFapiVersion: mongodb.com/v1kind: MongoDBmetadata:  name: ${SC_RESOURCE_NAME}spec:  shardCount: 3  topology: MultiCluster  type: ShardedCluster  version: ${MONGODB_VERSION}  opsManager:    configMapRef:      name: mdb-org-project-config  credentials: mdb-org-owner-credentials  persistent: true  backup:    mode: enabled  security:    certsSecretPrefix: cert-prefix    tls:      ca: ca-issuer    authentication:      enabled: true      modes: ["SCRAM"]  mongos:    clusterSpecList:      - clusterName: ${K8S_CLUSTER_0_CONTEXT_NAME}        members: 2        externalAccess:          externalDomain: "${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"          externalService:            annotations:               external-dns.alpha.kubernetes.io/hostname: "{podName}.${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"  configSrv:    clusterSpecList:      - clusterName: ${K8S_CLUSTER_0_CONTEXT_NAME}        members: 3 # config server will have 3 members in main cluster        externalAccess:          externalDomain: "${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"          externalService:            annotations:               external-dns.alpha.kubernetes.io/hostname: "{podName}.${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"      - clusterName: ${K8S_CLUSTER_1_CONTEXT_NAME}        members: 1 # config server will have additional non-voting, read-only member in this cluster        memberConfig:          - votes: 0            priority: "0"        externalAccess:          externalDomain: "${MDB_CLUSTER_1_EXTERNAL_DOMAIN}"          externalService:            annotations:               external-dns.alpha.kubernetes.io/hostname: "{podName}.${MDB_CLUSTER_1_EXTERNAL_DOMAIN}"  shard:    clusterSpecList:      - clusterName: ${K8S_CLUSTER_0_CONTEXT_NAME}        members: 3 # each shard will have 3 members in this cluster        externalAccess:          externalDomain: "${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"          externalService:            annotations:               external-dns.alpha.kubernetes.io/hostname: "{podName}.${MDB_CLUSTER_0_EXTERNAL_DOMAIN}"      - clusterName: ${K8S_CLUSTER_1_CONTEXT_NAME}        members: 1 # each shard will have additional non-voting, read-only member in this cluster        memberConfig:          - votes: 0            priority: "0"        externalAccess:          externalDomain: "${MDB_CLUSTER_1_EXTERNAL_DOMAIN}"          externalService:            annotations:               external-dns.alpha.kubernetes.io/hostname: "{podName}.${MDB_CLUSTER_1_EXTERNAL_DOMAIN}"EOF
3

Espere a que los recursos se activen.

Ejecuta el siguiente comando para confirmar que todos los recursos se encuentran activos y en funcionamiento.

echo; echo "Waiting for MongoDB to reach Running phase..."kubectl --context "${K8S_CLUSTER_0_CONTEXT_NAME}" -n "${MDB_NAMESPACE}" wait --for=jsonpath='{.status.phase}'=Running "mdb/${SC_RESOURCE_NAME}" --timeout=900secho; echo "Pods running in cluster ${K8S_CLUSTER_0_CONTEXT_NAME}"kubectl --context "${K8S_CLUSTER_0_CONTEXT_NAME}" -n "${MDB_NAMESPACE}" get podsecho; echo "Pods running in cluster ${K8S_CLUSTER_1_CONTEXT_NAME}"kubectl --context "${K8S_CLUSTER_1_CONTEXT_NAME}" -n "${MDB_NAMESPACE}" get podsecho; echo "Pods running in cluster ${K8S_CLUSTER_2_CONTEXT_NAME}"kubectl --context "${K8S_CLUSTER_2_CONTEXT_NAME}" -n "${MDB_NAMESPACE}" get pods
4

Cree un usuario de MongoDB y credenciales.

Ejecuta el siguiente comando para crear un usuario y credenciales en su clúster fragmentado.

kubectl apply --context "${K8S_CLUSTER_0_CONTEXT_NAME}" -n "${MDB_NAMESPACE}" -f - <<EOFapiVersion: v1kind: Secretmetadata:  name: sc-user-passwordtype: OpaquestringData:  password: password---apiVersion: mongodb.com/v1kind: MongoDBUsermetadata:  name: sc-userspec:  passwordSecretKeyRef:    name: sc-user-password    key: password  username: "sc-user"  db: "admin"  mongodbResourceRef:    name: ${SC_RESOURCE_NAME}  roles:  - db: "admin"    name: "root"EOF
kubectl --context "${K8S_CLUSTER_0_CONTEXT_NAME}" wait --for=jsonpath='{.status.phase}'=Updated -n "${MDB_NAMESPACE}" mdbu/sc-user --timeout=300s
5

Verifica la conectividad con MongoDB Shell.

Ejecute el siguiente comando para verificar que su recurso de MongoDB en el clúster sea accesible.

external_ip="$(kubectl get --context "${K8S_CLUSTER_0_CONTEXT_NAME}" -n "${MDB_NAMESPACE}" svc "${SC_RESOURCE_NAME}-mongos-0-0-svc-external" -o=jsonpath="{.status.loadBalancer.ingress[0].ip}")"
mkdir -p certskubectl get --context "${K8S_CLUSTER_0_CONTEXT_NAME}" -n "${MDB_NAMESPACE}" cm/ca-issuer -o=jsonpath='{.data.ca-pem}' > certs/ca.crt
mongosh --host "${external_ip}" --username sc-user --password password --tls --tlsCAFile certs/ca.crt --tlsAllowInvalidHostnames --eval "db.runCommand({connectionStatus : 1})"
{  authInfo: {    authenticatedUsers: [ { user: 'sc-user', db: 'admin' } ],    authenticatedUserRoles: [ { role: 'root', db: 'admin' } ]  },  ok: 1,  '$clusterTime': {    clusterTime: Timestamp({ t: 1792488362, i: 1 }),    signature: {      hash: Binary.createFromBase64('YF0z7xzWoXgimtBNP7Ici9bGZP8=', 0),      keyId: Long('7698678287660220421')    }  },  operationTime: Timestamp({ t: 1792488362, i: 1 })}
Volver
Set de réplicas Multi-Clúster
Next
Referencia
Califique esta página

En esta página