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 MongoDB Controllers for Kubernetes Operator y consulta la etiqueta de la versión actual:

git clone https://github.com/mongodb/mongodb-kubernetes.git
cd mongodb-kubernetes
git checkout 1.2.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. Instale 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 en un clúster de múltiples Kubernetes, debe tener un conjunto específico de Kubernetes Roles, ClusterRoles, RoleBindings, ClusterRoleBindings y ServiceAccounts, que puede 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.

• Utilice Helm para configurar los roles de Kubernetes y las cuentas de servicio necesarios para cada clúster miembro:

  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 para clústeres múltiples tiene un ámbito limitado al espacio de nombres en el que se instala. El operador de Kubernetes concilia el recurso MongoDBMultiCluster desplegado en el mismo espacio de nombres que el operador de Kubernetes.

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 cuentas de servicio, roles, roles de clúster, enlacesde roles y enlaces de roles de clúster en el clúster central y en cada clúster miembro.

• 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 el despliegue de MongoDB en clústeres de múltiples Kubernetes, el operador de Kubernetes comienza a observar los recursos MongoDB en el espacio de nombresmongodb.

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 instale la implementación de MongoDB en un clúster multi-Kubernetes en varios o todos los espacios de nombres, puede 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 usar una malla de servicios, instala Istio.

• Si no puedes usar un malla de servicios:

  1. Revise 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

Siga los pasos de este procedimiento para verificar que los nombres de dominio completos (FQDN)de los servicios sean accesibles en todos los clústeres de Kubernetes.

En este ejemplo, se implementa 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 planea proteger su implementación de MongoDB en clústeres de Kubernetes múltiples mediante cifrado TLS, complete las siguientes tareas para habilitar la autenticación interna del clúster y generar certificados TLS para los clústeres miembros y el agente de MongoDB:

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

curl https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/master/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 implementación de recursos en MongoDBMultiCluster 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 complemento kubectl para MongoDB si no utiliza GitOps o cómo configurar los recursos para GitOps si lo utiliza.

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 GitOps, no podrá usar el complemento kubectl mongodb para configurar automáticamente el control de acceso basado en roles (RBAC) ni el archivo kubeconfig que permite que el clúster central se comunique con sus clústeres miembros. En su lugar, deberá configurar y aplicar manualmente los siguientes archivos de recursos o crear su propia automatización basándose en la información que se detalla 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"