Prerrequisitos de implementación Multi-clúster

Revisar arquitecturas de hardware compatibles

Consulta arquitecturas de hardware compatibles.

Clona el repositorio de MongoDB Controllers for Kubernetes Operator

Clona el Repositorio de Controladores MongoDB para Kubernetes operador y consulta la etiqueta de la versión actual:

git clone https://github.com/mongodb/mongodb-kubernetes.git
cd mongodb-kubernetes
git checkout 1.10.0

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.

• Usa Helm para configurar los Roles y cuentas de servicio requeridos de Kubernetes para cada clúster nodo:

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

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

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

• Crea manualmente los archivos .yaml de objetos de Kubernetes y añade los Roles de Kubernetes requeridos y las cuentas de servicio a tu implementación de 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, Binding de Roles y Cuentas de Servicio para tu clúster Central

  • 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 Central

  • 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-kubernetes-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 central 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-kubernetes-operator-multi-cluster \
  mongodb/mongodb-kubernetes \
  --namespace mongodb \
  --set namespace=mongodb \
  --version <mongodb-kubernetes-operator-version>\
  --set operator.name=mongodb-kubernetes-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-kubernetes-operator-multi-cluster \
  mongodb/mongodb-kubernetes \
  --namespace mongodb \
  --set namespace=mongodb \
  --version <mongodb-kubernetes-operator-version>\
  --set operator.name=mongodb-kubernetes-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. Revisa la sección ¿Cómo establece la 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 de este procedimiento para verificar que los FQDNdel servicio sean accesibles en 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-kubernetes/1.10.0/scripts/release/kubectl_mongodb/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

MongoDBMultiCluster Recursos

implementación en un entorno GitOps.

Si utiliza un flujo de trabajo GitOps, no podrá usar el complemento kubectl mongodb, que configura automáticamente el control de acceso basado en roles (RBAC) y crea el archivo kubeconfig que permite que el clúster central se comunique con sus clústeres miembros. En su lugar, deberá configurar manualmente o crear su propia automatización para configurar los archivos RBAC y kubeconfig siguiendo el procedimiento y los ejemplos de Configurar 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 utilizas un flujo de trabajo GitOps, no podrás 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 central se comunique con sus clústeres nodos. En su lugar, deberás configurar y aplicar manualmente los siguientes archivos de recursos o compilar tu 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-kubernetes-operator-member-list
  labels:
    multi-cluster: "true"