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 particionado de varios clústeres con 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}
export SC_RESOURCE_NAME=mdb-shexport MONGODB_VERSION="8.0.5-ent"

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_NAMESPACE}.svc.cluster.local"  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_NAMESPACE}.svc.cluster.local"  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_NAMESPACE}.svc.cluster.local"  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_NAMESPACE}.svc.cluster.local"  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_NAMESPACE}.svc.cluster.local"  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_NAMESPACE}.svc.cluster.local"  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  # we don't specify mongodsPerShardCount, mongosCount and configServerCount as they don't make sense for multi-cluster  topology: MultiCluster  type: ShardedCluster  version: ${MONGODB_VERSION}  opsManager:    configMapRef:      name: mdb-org-project-config  credentials: mdb-org-owner-credentials  persistent: true  backup:    mode: enabled  externalAccess: {}  security:    certsSecretPrefix: cert-prefix    tls:      ca: ca-issuer    authentication:      enabled: true      modes: ["SCRAM"]  mongos:    clusterSpecList:      - clusterName: ${K8S_CLUSTER_0_CONTEXT_NAME}        members: 2  configSrv:    clusterSpecList:      - clusterName: ${K8S_CLUSTER_0_CONTEXT_NAME}        members: 3 # config server will have 3 members in main cluster      - 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"  shard:    clusterSpecList:      - clusterName: ${K8S_CLUSTER_0_CONTEXT_NAME}        members: 3 # each shard will have 3 members in this cluster      - 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"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: 1792488930, i: 1 }),    signature: {      hash: Binary.createFromBase64('6gwi95U5QREdZ6vnQExH+SzoKOQ=', 0),      keyId: Long('7698680589762691095')    }  },  operationTime: Timestamp({ t: 1792488930, i: 1 })}
Volver
Set de réplicas Multi-Clúster
Next
Arquitectura Multiclúster sin Service Mesh
Califique esta página

En esta página