Prerrequisitos para implementaciones multiclúster

Revisar arquitecturas de hardware compatibles

Consulta arquitecturas de hardware compatibles.

Clona el repositorio de MongoDB Enterprise Kubernetes Operator

Clona el repositorio del Enterprise Kubernetes Operator de MongoDB:

git clone https://github.com/mongodb/mongodb-enterprise-kubernetes.git

Establecer Variables de Entorno

Establezca las variables de entorno con los nombres de los clústeres donde implemente los clústeres, como en este ejemplo:

export MDB_CENTRAL_CLUSTER_FULL_NAME="mdb-central"
export MDB_CLUSTER_1_FULL_NAME="mdb-1"
export MDB_CLUSTER_2_FULL_NAME="mdb-2"
export MDB_CLUSTER_3_FULL_NAME="mdb-3"

Instala Go y Helm

Instala las siguientes herramientas:

1. Instala Go v1.17 o posterior.

2. Instalar Helm.

Comprenda los roles de Kubernetes y las vinculaciones de roles

Para utilizar una implementación de MongoDB de múltiples clústeres de Kubernetes, debe tener un conjunto específico de Kubernetes Roles, ClusterRoles, RoleBindings, ClusterRoleBindings, y ServiceAccounts, que se pueden configurar de cualquiera de las siguientes maneras:

• Sigue la Guía Rápida de Multi-Kubernetes-Cluster, que te indica cómo utilizar el Plugin de MongoDB para crear automáticamente los objetos requeridos y aplicarlos a los clústeres apropiados dentro de tu implementación multi-Kubernetes-cluster de MongoDB.

• Utiliza Helm para configurar los Roles de Kubernetes requeridos y las cuentas de servicio para cada clúster miembro:

  helm template --show-only \
    templates/database-roles.yaml \
    mongodb/enterprise-operator \
    --set namespace=mongodb | \
  kubectl apply -f - \
    --context=$MDB_CLUSTER_1_FULL_NAME \
    --namespace mongodb

  helm template --show-only \
    templates/database-roles.yaml \
    mongodb/enterprise-operator \
    --set namespace=mongodb | \
  kubectl apply -f - \
    --context=$MDB_CLUSTER_2_FULL_NAME \
    --namespace mongodb

  helm template --show-only \
    templates/database-roles.yaml \
    mongodb/enterprise-operator \
    --set namespace=mongodb | \
  kubectl apply -f - \
    --context=$MDB_CLUSTER_3_FULL_NAME \
    --namespace mongodb

• Crear manualmente un objeto de Kubernetes .yaml archivos y añadir los roles y cuentas de servicio de Kubernetes necesarios a tu implementación en MongoDB multi-Kubernetes con el comando kubectl apply. Esto puede ser necesario para ciertos flujos de trabajo altamente automatizados. MongoDB proporciona archivos de configuración de muestra.

  Para recursos personalizados dirigidos a un subconjunto de namespaces:

  • Roles, vinculaciones de roles y cuentas de servicio para tu clúster de operadores

  • Roles, enlaces de roles y cuentas de servicio para tus clústeres nodos

  Para recursos personalizados con ámbito de namespace a nivel de clúster:

  • ClusterRoles, ClusterRoleBindings y ServiceAccounts para su Clúster de Operadores

  • ClusterRoles, ClusterRoleBindings y ServiceAccounts para su Clúster nodo

  Cada archivo define múltiples recursos. Para apoyar su implementación, debe reemplazar los valores de marcador de posición en los siguientes campos:

  • subjects.namespace en cada recurso RoleBinding o ClusterRoleBinding

  • metadata.namespace en cada recurso de ServiceAccount

  Después de modificar las definiciones, aplícalas ejecutando el siguiente comando para cada archivo:

  kubectl apply -f <fileName>

Establecer el alcance de la implementación

Por defecto, el operador de Kubernetes multiclúster está limitado al namespace en el que se instala. El Kubernetes operador concilia el recurso MongoDBMultiCluster implementado en el mismo namespace que el Kubernetes operador.

Cuando ejecutes el complemento kubectl de MongoDB como parte del inicio rápido multiclúster y no modifiques los ajustes del complemento de kubectl mongodb, el complemento:

• Crea un ConfigMap por defecto llamado mongodb-enterprise-operator-member-list que contiene todos los nodos clústeres de la implementación multi-Kubernetes de MongoDB. Este nombre está codificado y no puedes cambiarlo. Ver Problemas conocidos.

• Crea ServiceAccounts, Roles, ClusterRoles, RoleBindings y ClusterRoleBindings en el clúster de operador y cada clúster nodo.

• Aplica los permisos correctos para las cuentas de servicio.

• Utiliza la configuración anterior para crear tu implementación MongoDB multi-clúster de Kubernetes.

Una vez que el Operador de Kubernetes crea la implementación de MongoDB de clústeres múltiples en Kubernetes, el Operador de Kubernetes comienza a monitorear los recursos MongoDB en el mongodb namespace.

Para configurar el operador de Kubernetes con los permisos correctos para implementar en un subconjunto o en todos los espacios de nombres, ejecuta el siguiente comando y especifica los espacios de nombres que deseas que el operador de Kubernetes supervise.

kubectl mongodb multicluster setup \
  --central-cluster="${MDB_CENTRAL_CLUSTER_FULL_NAME}" \
  --member-clusters="${MDB_CLUSTER_1_FULL_NAME},${MDB_CLUSTER_2_FULL_NAME},${MDB_CLUSTER_3_FULL_NAME}" \
  --member-cluster-namespace="mongodb2" \
  --central-cluster-namespace="mongodb2" \
  --create-service-account-secrets \
  --cluster-scoped="true"

Cuando instales el despliegue de MongoDB en clústeres múltiples de Kubernetes en uno o más namespaces, podrás configurar el Operador de Kubernetes para:

• Vigila recursos en varios espacios de nombres

• Ver recursos en todos los espacios de nombres

WATCH_NAMESPACE: "$namespace1,$namespace2,$namespace3"

helm upgrade \
  --install \
  mongodb-enterprise-operator-multi-cluster \
  mongodb/enterprise-operator \
  --namespace mongodb \
  --set namespace=mongodb \
  --version <mongodb-kubernetes-operator-version>\
  --set operator.name=mongodb-enterprise-operator-multi-cluster \
  --set operator.createOperatorServiceAccount=false \
  --set operator.createResourcesServiceAccountsAndRoles=false \
  --set "multiCluster.clusters={$MDB_CLUSTER_1_FULL_NAME,$MDB_CLUSTER_2_FULL_NAME,$MDB_CLUSTER_3_FULL_NAME}" \
  --set operator.watchNamespace="$namespace1,$namespace2,$namespace3"

WATCH_NAMESPACE: "*"

helm upgrade \
  --install \
  mongodb-enterprise-operator-multi-cluster \
  mongodb/enterprise-operator \
  --namespace mongodb \
  --set namespace=mongodb \
  --version <mongodb-kubernetes-operator-version>\
  --set operator.name=mongodb-enterprise-operator-multi-cluster \
  --set operator.createOperatorServiceAccount=false \
  --set operator.createResourcesServiceAccountsAndRoles=false \
  --set "multiCluster.clusters={$MDB_CLUSTER_1_FULL_NAME,$MDB_CLUSTER_2_FULL_NAME,$MDB_CLUSTER_3_FULL_NAME}" \
  --set operator.watchNamespace="*"

Planifica la conectividad externa: ¿deberías usar un malla de servicios?

Una malla de servicios permiten la comunicación entre clústeres entre los miembros del set de réplicas desplegados en diferentes clústeres de Kubernetes. Utilizar una malla de servicios simplifica en gran medida la creación de implementaciones de MongoDB en varios clústeres de Kubernetes, y es la forma recomendada de implementar MongoDB en varios clústeres de Kubernetes. Sin embargo, si tu organización de TI no utiliza una malla de servicios, puedes implementar un set de réplicas en una implementación de MongoDB en varios clústeres de Kubernetes sin ella.

Según tu entorno, realiza lo siguiente:

• Si puedes utilizar un service mesh, instala Istio.

• Si no puedes usar un malla de servicios:

  1. Revise la sección ¿Cómo establece conectividad el Operador de Kubernetes?

  2. Habilitar la conectividad externa a través de dominios externos y zonas DNS.

  3. Implementa un clúster multi-Kubernetes sin una malla de servicios.

Verificar conectividad entre clústeres

Sigue los pasos en este procedimiento para verificar que los FQDNde servicio sean alcanzables en todos los clústeres de Kubernetes.

En este ejemplo, implementas una aplicación de muestra definida en sample-service.yaml en dos clústeres de Kubernetes.

kubectl create --context="${CTX_CLUSTER_1}" namespace sample
kubectl create --context="${CTX_CLUSTER_2}" namespace sample

kubectl apply --context="${CTX_CLUSTER_1}" \
   -f sample-service.yaml \
   -l service=helloworld1 \
   -n sample
kubectl apply --context="${CTX_CLUSTER_2}" \
   -f sample-service.yaml \
   -l service=helloworld2 \
   -n sample

kubectl apply --context="${CTX_CLUSTER_1}" \
   -f sample-service.yaml \
   -l version=v1 \
   -n sample

kubectl get pod --context="${CTX_CLUSTER_1}" \
   -n sample \
   -l app=helloworld

kubectl apply --context="${CTX_CLUSTER_2}" \
   -f sample-service.yaml \
   -l version=v2 \
   -n sample

kubectl get pod --context="${CTX_CLUSTER_2}" \
   -n sample \
   -l app=helloworld

kubectl run  --context="${CTX_CLUSTER_1}" \
   -n sample \
   curl --image=radial/busyboxplus:curl \
   -i --tty \
   curl -sS helloworld2.sample:5000/hello

Hello version: v2, instance: helloworld-v2-758dd55874-6x4t8

kubectl run --context="${CTX_CLUSTER_2}" \
   -n sample \
   curl --image=radial/busyboxplus:curl \
   -i --tty \
   curl -sS helloworld1.sample:5000/hello

Hello version: v1, instance: helloworld-v1-758dd55874-6x4t8

Revisar los requisitos para implementar Ops Manager

Como parte de la Guía de inicio rápido, implementas un recurso de Ops Manager en el clúster central.

Prepárate para conexiones encriptadas por TLS

Si planeas asegurar tu implementación de MongoDB en múltiples clústeres de Kubernetes utilizando cifrado TLS, completa las siguientes tareas para habilitar la autenticación interna del clúster y generar certificados TLS para los clústeres nodos y el MongoDB Agent:

kubectl --context $MDB_CENTRAL_CLUSTER_FULL_NAME \
--namespace=<metadata.namespace> \

curl https://raw.githubusercontent.com/mongodb/mongodb-enterprise-kubernetes/master/tools/multicluster/setup_tls.sh -o setup_tls.sh

Elija GitOps o el plugin kubectl de MongoDB

Puede elegir crear y mantener los archivos de recursos necesarios para la implementación de recursos en MongoDBMultiCluster en un entorno GitOps.

Si utilizas un flujo de trabajo GitOps, no puedes usar el plugin kubectl mongodb, que configura automáticamente control de acceso basado en roles (RBAC) y crea el archivo kubeconfig que permite que el clúster de operadores se comunique con sus clústeres nodo. En su lugar, debes configurar manualmente o compilar tu propia automatización para configurar los archivos RBAC y kubeconfig siguiendo el procedimiento y los ejemplos en Configuración de recursos para GitOps.

Las siguientes secciones de requisitos previos describen cómo instalar el plugin kubectl MongoDB en caso de que no se use GitOps o cómo configurar recursos para GitOps si lo hace.

Instala el plugin MongoDB kubectl

Usa el plugin kubectl mongodb para:

• Configura implementaciones en varios clústeres de Kubernetes

• Ejecutar la recuperación ante desastres automática y manual

Para instalar el plugin kubectl mongodb:

tar -zxvf kubectl-mongodb_<version>_darwin_amd64.tar.gz

mv kubectl-mongodb /usr/local/bin/kubectl-mongodb

kubectl mongodb multicluster setup
kubectl mongodb multicluster recover

Configurar recursos para GitOps

Si utiliza un flujo de trabajo de GitOps, no podrá utilizar el plugin kubectl MongoDB para configurar automáticamente el control de acceso basado en roles (RBAC) o el archivo kubeconfig que permite que el clúster operador se comunique con sus clústeres nodos. En su lugar, debe configurar y aplicar manualmente los siguientes archivos de recursos o compilar su propia automatización basada en la información a continuación.

Para configurar RBAC y el kubeconfig para GitOps:

apiVersion: v1
kind: ConfigMap
data:
  cluster1: ""
  cluster2: ""
metadata:
  namespace: <namespace>
  name: mongodb-enterprise-operator-member-list
  labels:
    multi-cluster: "true"