Pré-requisitos de implantação de vários clusters

Revise as arquiteturas de hardware suportadas

Consulte as arquiteturas de hardware suportadas.

Clone os drivers MongoDB para repositório do operador Kubernetes

Clone o repositório do MongoDB Controladores para o Operador Kubernetes:

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

Definir variáveis de ambiente

Defina as variáveis de ambiente com nomes de cluster onde você distribui os clusters, como neste exemplo:

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 o Go e o Helm

Instale as seguintes ferramentas:

1. Instale o Go 1v.17 ou posterior.

2. Instale o Helm.

Entender as funções e vinculações de funções do Kubernetes

Para usar um sistema do MongoDB de cluster multi-Kubernetes, você deve ter um conjunto específico de Kubernetes Roles, ClusterRoles, RoleBindings, ClusterRoleBindings e ServiceAccounts, que você pode configurar de qualquer uma das seguintes maneiras:

• Siga o Início Rápido de Multi-Kubernetes-Cluster, que informa como usar o plugin doMongoDB para criar automaticamente os objetos necessários e aplicá-los aos clusters apropriados dentro de sua implantação do MongoDB de clusters multi-Kubernetes.

• Usar elmo para configurar as roles necessárias do Kubernetes e as contas de serviço para cada cluster de membros:

  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

• Crie manualmente arquivos de objeto .yaml do Kubernetes e adicione as funções e contas de serviço necessárias do Kubernetes ao seu sistema do MongoDB de vários clusters Kubernetes com o comando kubectl apply . Isso pode ser necessário para determinados fluxos de trabalho altamente automatizados. O MongoDB fornece arquivos de configuração de amostra.

  Para recursos personalizados com escopo para um subconjunto de namespaces:

  • Roles, vinculações de role e contas de serviço para seu cluster de operadores

  • Roles, vinculações de role e contas de serviço para seus clusters de membros

  Para recursos personalizados com escopo para um namespace em todo o cluster:

  • ClusterRoles, ClusterRoleBindings e ServiceAccounts para seu cluster de operadores

  • ClusterRoles, ClusterRoleBindings e ServiceAccounts para o seu cluster de membros

  Cada arquivo define vários recursos. Para suportar sua implantação, você deve substituir os valores de espaço reservado nos seguintes campos:

  • subjects.namespace em cada recurso RoleBinding ou ClusterRoleBinding

  • metadata.namespace em cada recurso ServiceAccount

  Após modificar as definições, aplique-as executando o seguinte comando para cada arquivo:

  kubectl apply -f <fileName>

Definir o escopo do sistema

By default, the multi-cluster Kubernetes Operator is scoped to the namespace in which you install it. The Kubernetes Operator reconciles the MongoDBMultiCluster resource deployed in the same namespace as the Kubernetes Operator.

Quando você executa o plug-in kubectl do MongoDB como parte do início rápido de vários clusters e não modifica as configurações kubectl mongodb do plug-in, o plug-in:

• Cria um ConfigMap padrão denominado mongodb-kubernetes-operator-member-list que contém todos os clusters de membros do sistema MongoDB do cluster multi-Kubernetes. Este nome está codificado e você não pode alterá-lo. Consulte Problemas conhecidos.

• Cria ServiceAccounts, Roles, ClusterRoles, RoleBindings e ClusterRoleBindings no cluster do operador e em cada cluster de membros.

• Aplica as permissões corretas para contas de serviço.

• Usa as configurações anteriores para criar sua implantação do MongoDB de clusters multikubernetes.

Depois que o Operador Kubernetes cria a implantação do MongoDB de cluster multi-Kubernetes, o Operador Kubernetes começa a observar MongoDB recursos no namespace mongodb.

Para configurar o Operador Kubernetes com as permissões corretas para implantar em um subconjunto ou em todos os namespaces, execute o comando a seguir e especifique os namespaces que você deseja que o Operador Kubernetes observe.

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"

Ao instalar a implementação do MongoDB de cluster multi-Kubernetes em vários ou em todos os namespaces, você pode configurar o Kubernetes Operator para:

• Assista a recursos em vários namespaces

• Assista a recursos em todos os namespaces

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="*"

Planejar a conectividade externa: Você deve usar uma malha de serviços?

Uma Service Mesh permite a comunicação entre clusters entre os membros do conjunto de réplicas distribuídos em diferentes clusters Kubernetes. O uso de uma interface de serviço simplifica muito a criação de sistemas MongoDB de vários clusters Kubernetes e é a maneira recomendada de implantar o MongoDB em vários clusters Kubernetes. No entanto, se sua organização de T.I. não usar uma Service Mesh, você poderá implantar um conjunto de réplicas em um MongoDB deployment de vários Kubernetes sem ele.

Dependendo do seu ambiente, faça o seguinte:

• Se você puder usar uma interface de serviço, instale o Istio.

• Se você não puder usar uma malha de serviço:

  1. Revise a seção Como o operador do Kubernetes estabelece conectividade?

  2. Habilite a conectividade externa por meio de domínios externos e zonas de DNS.

  3. Implemente um cluster multi-Kubernetes sem uma tela de serviço.

Verificar a conectividade entre clusters

Siga as etapas deste procedimento para verificar se os FQDNs de serviço podem ser acessados nos clusters do Kubernetes.

Neste exemplo, você implanta um aplicação de amostra definido em sample-service.yaml em dois clusters 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 os requisitos para implantar o Ops Manager

Como parte do Quick Start, você implementa um recurso do MongoDB Ops Manager no cluster central.

Prepare-se para conexões criptografadas por TLS

Se você planeja proteger seu sistema MongoDB de cluster multi-Kubernetes usando criptografia TLS , conclua as tarefas a seguir para habilitar a autenticação interna do cluster e gerar certificados TLS para clusters de membros e o MongoDB Agent:

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

Escolha GitOps ou o plug-in kuberctl MongoDB

Você pode optar por criar e manter os arquivos de recursos necessários para o sistema de recursos do MongoDBMultiCluster em um ambiente GitOps.

If you use a GitOps workflow, you can't use the kubectl mongodb plugin, which automatically configures role-based access control (RBAC) and creates the kubeconfig file that allows the operator cluster to communicate with its member clusters. Instead, you must manually configure or build your own automation for configuring the RBAC and kubeconfig files based on the procedure and examples in Configure Resources for GitOps.

As seções de pré-requisito a seguir descrevem como instalar o plug- kubectl do MongoDB plugin se você não usar o GitOps ou configurar recursos para o GitOps se usar.

Instalar o plug-in kuberctl do MongoDB

Use o plug-in kubectl mongodb para:

• Configurar sistemas de vários clusters Kubernetes

• Executar recuperação de desastres automática e manual

Para instalar o plug-in 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

Se você usar um fluxo de trabalho GitOps, não poderá usar o plugin-in kubectl mongodb para configurar automaticamente o RBAC (controle de acesso baseado em roles) ou o arquivo kubeconfig que permite ao cluster de operadores se comunicar com seus clusters de membros. Em vez disso, você deve configurar e aplicar manualmente os seguintes arquivos de recursos ou construir sua própria automação com base nas informações abaixo.

Para configurar o RBAC e o kubeconfig para GitOps:

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