Requisitos previos para la implementación de varios clústeres

Revisar las arquitecturas de hardware compatibles

Consulte las arquitecturas de hardware compatibles.

Clonar los controladores MongoDB para el repositorio de operadores de Kubernetes

Clonar el Repositorio de operadores de controladores MongoDB para Kubernetes:

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

Establecer variables de entorno

Establezca las variables de entorno con los nombres de clúster donde implementa 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"

Instalar Go y Helm

Instala las siguientes herramientas:

1. Instalar Go 1v.17 o posterior.

2. Instalar Helm.

Comprender los roles y las vinculaciones de roles de Kubernetes

Para utilizar una implementación de MongoDB en un clúster de Kubernetes múltiple, debe tener un conjunto específico de roles deKubernetes, ClusterRoles, RoleBindings, ClusterRoleBindings y ServiceAccounts, que puede configurar de cualquiera de las siguientes maneras:

• Siga el Inicio rápido de múltiples clústeres de Kubernetes, que le indica cómo usar el complemento MongoDB para crear automáticamente los objetos necesarios y aplicarlos a los clústeres adecuados dentro de su implementación de MongoDB de múltiples clústeres de Kubernetes.

• 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

• Crear manualmente un objeto de Kubernetes .yaml Archivos y agregue los roles de Kubernetes y las cuentas de servicio necesarios a su implementación de MongoDB con varios clústeres de Kubernetes mediante el comando kubectl apply. Esto puede ser necesario para ciertos flujos de trabajo altamente automatizados. MongoDB proporciona archivos de configuración de ejemplo.

  Para recursos personalizados limitados a un subconjunto de espacios de nombres:

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

  • Roles, vinculaciones de roles y cuentas de servicio para sus clústeres de miembros

  Para recursos personalizados cuyo ámbito es un espacio de nombres de todo el clúster:

  • ClusterRoles, ClusterRoleBindings y ServiceAccounts para su clúster de operadores

  • ClusterRoles, ClusterRoleBindings y ServiceAccounts para su clúster miembro

  Cada archivo define varios recursos. Para facilitar 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 ServiceAccount

  Después de modificar las definiciones, aplíquelas 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 ejecuta el complemento kubectl de MongoDB como parte del inicio rápido de múltiples clústeres y no modifica la kubectl mongodb configuración del complemento, el complemento:

• Crea un ConfigMap mongodb-kubernetes-operator-member-list predeterminado llamado que contiene todos los clústeres miembros de la implementación de MongoDB con clústeres multi-Kubernetes. Este nombre está predefinido y no se puede cambiar.Consulte 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.

• Utilice las configuraciones anteriores para crear su implementación de MongoDB en varios clústeres de Kubernetes.

Una vez que MongoDB el mongodb operador de Kubernetes crea la implementación de MongoDB en varios clústeres de Kubernetes, comienza a monitorear los recursos en el espacio de nombres.

Para configurar el operador de Kubernetes con los permisos correctos para implementar en un subconjunto o en todos los espacios de nombres, ejecute el siguiente comando y especifique los espacios de nombres que desea 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"

Al instalar la implementación de MongoDB de varios clústeres de 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="*"

Plan de conectividad externa: ¿Debería utilizar una malla de servicios?

Una malla de servicios permite la comunicación entre clústeres entre los miembros del conjunto de réplicas implementados en diferentes clústeres de Kubernetes. Usar una malla de servicios simplifica enormemente 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 su organización de TI no utiliza una malla de servicios, puede implementar un conjunto de réplicas en una implementación de MongoDB en varios clústeres de Kubernetes sin ella.

Dependiendo de su entorno, haga lo siguiente:

• Si puede utilizar una malla de servicio, instale Istio.

• Si no puede utilizar una malla de servicio:

  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. Implemente un clúster multi-Kubernetes sin una malla de servicios.

Comprobar la conectividad entre clústeres

Siga los pasos de este procedimiento para verificar que los FQDNdel servicio 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

Revise los requisitos para implementar Ops Manager

Como parte del inicio rápido, implementa un recurso de Ops Manager en el clúster central.

Prepárese para conexiones cifradas con TLS

Si planea proteger su implementación de MongoDB en varios clústeres de Kubernetes mediante cifrado TLS, complete las siguientes tareas para habilitar la autenticación interna del clúster y generar certificados TLS para los clústeres miembro y el Agente 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 MongoDBMultiCluster en un entorno de GitOps.

Si usa un flujo de trabajo de GitOps, no puede usar el complemento kubectl de mongodb, que configura automáticamente el 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 miembros. En su lugar, debe configurar manualmente o crear su propia automatización para configurar el RBAC y los kubeconfig archivos según el procedimiento y los ejemplos de Configurar recursos para GitOps.

Las siguientes secciones de requisitos previos describen cómo instalar el complemento MongoDB de kubectl si no usa GitOps o configurar recursos para GitOps si lo hace.

Instala el plugin MongoDB kubectl

Utilice el complemento kubectl mongodb para:

• Configurar implementaciones de múltiples clústeres de Kubernetes

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

Para instalar el complemento 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 usa un flujo de trabajo de GitOps, no podrá usar el complemento kubectl de MongoDB para configurar automáticamente el control de acceso basado en roles (RBAC) ni el archivo kubeconfig que permite que el clúster de operadores 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 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"