Use este procedimento para criar um novo conjunto de réplicas em um cluster Kubernetes de membros em uma implantação do MongoDB de cluster Kubernetes múltiplo.
Esse procedimento permite definir configurações diferentes para o recurso do conjunto de réplicas, como substituições para a configuração statefulSet. Como alternativa ao uso desse procedimento, você pode usar o Início Rápido de Multi-Kubernetes-Cluster, que cria uma implantação do MongoDB de cluster multi-Kubernetes com configurações padrão.
Antes de começar:
Saiba mais sobre sistemas de clusters multi-Kubernetes.
Revise a lista de serviços e ferramentas de vários clusters Kubernetes.
Instale o Operador Kubernetes em um sistema MongoDB de cluster multi-Kubernetes. Consulte Início Rápido do Multi-Kubernetes-Cluster.
Conclua os pré- requisitos.
Distribua um MongoDBMultiCluster recurso
Você pode usar os seguintes procedimentos nesta aba TLS-Encrypted Connections :
Implemente um recurso
MongoDBMultiClusterRenovar certificados TLS para um recurso
MongoDBMultiCluster
Esses procedimentos estabelecem conexões criptografadas por TLSentre hosts do MongoDB em um conjunto de réplicas e entre aplicativos clientes e deployments do MongoDB.
Antes de começar, você deve ter certificados válidos para criptografia TLS .
Distribua um MongoDBMultiCluster recurso
Crie o segredo para o certificado TLS do seu MongoDBMultiCluster recurso.
Execute o comando kubectl para criar um novo segredo que armazena o certificado de recurso MongoDBMultiCluster :
kubectl --context $MDB_CENTRAL_CLUSTER_FULL_NAME \ --namespace=<metadata.namespace> \ create secret tls <prefix>-<metadata.name>-cert \ --cert=<resource-tls-cert> \ --key=<resource-tls-key>Observação
É necessário prefixar os segredos com <prefix>-<metadata.name>.
Por exemplo, se você chamar sua implantação my-deployment e definir o prefixo como mdb, deverá nomear o segredo TLS para as comunicações TLS do cliente como mdb-my-deployment-cert. Além disso, você deve nomear o segredo TLS para autenticação interna do cluster (se ativado) como mdb-my-deployment-clusterfile.
Crie o ConfigMap para vincular sua CA com seu MongoDBMultiCluster recurso.
Execute o comando kubectl para vincular a CA ao seu recurso MongoDBMultiCluster. Especifique o arquivo de certificado CA que você deve sempre nomear ca-pem para o recurso MongoDBMultiCluster:
kubectl --context $MDB_CENTRAL_CLUSTER_FULL_NAME \ --namespace=<metadata.namespace> \ create configmap custom-ca -from-file=ca-pem=<your-custom-ca-file>Configure o kubectl para usar o namespace do cluster central.
Se ainda não tiver feito isso, execute os seguintes comandos para executar todos os comandos kubectl no cluster central no namespace padrão.
kubectl config use-context $MDB_CENTRAL_CLUSTER_FULL_NAMEkubectl config set-context $(kubectl config current-context) \ --namespace=mongodbCopie e cole o recurso de amostra.
Copie o arquivo YAML do conjunto de réplicas de amostra e cole-o em um novo arquivo de texto.
Altere as configurações do arquivo para corresponder à configuração do conjunto de réplicas desejada.
# This example provides statefulSet overrides per cluster.
apiVersion: mongodb.com/v1kind: MongoDBMultiClustermetadata: name: multi-replica-setspec: version: 8.0.0 type: ReplicaSet duplicateServiceObjects: false credentials: my-credentials opsManager: configMapRef: name: my-project clusterSpecList: - clusterName: cluster1.example.com members: 2 statefulSet: spec: template: spec: containers: # Example of custom sidecar containers. Remove it before using the file in production. - name: sidecar1 image: busybox command: [ "sleep" ] args: [ "infinity" ] # Use the following settings to override the default storage size of the "data" Persistent Volume. volumeClaimTemplates: - metadata: name: data spec: resources: requests: storage: 1Gi - clusterName: cluster2.example.com members: 1 statefulSet: spec: template: spec: containers: # Example of custom sidecar containers. Remove it before using the file in production. - name: sidecar2 image: busybox command: [ "sleep" ] args: [ "infinity" ] volumeClaimTemplates: - metadata: name: data spec: resources: requests: storage: 1Gi - clusterName: cluster3.example.com members: 1 statefulSet: spec: template: spec: containers: # Example of custom sidecar containers. Remove it before using the file in production. - name: sidecar3 image: busybox command: [ "sleep" ] args: [ "infinity" ] volumeClaimTemplates: - metadata: name: data spec: resources: requests: storage: 1Gi
Altere as configurações para seus valores preferidos.
Chave | Tipo | Descrição | Exemplo |
|---|---|---|---|
string | Etiqueta para o recurso Os nomes de recursos devem ter 44 caracteres ou menos. Consulte também |
| |
string | Versão do MongoDB que este recurso O formato deve ser IMPORTANTE: Certifique-se de escolher uma versão compatível do MongoDB Server. Versões compatíveis diferem dependendo da imagem base que o recurso do banco de banco de dados MongoDB utiliza. Para saber mais sobre a versão MongoDB, consulte Versões do MongoDB no Manual MongoDB. |
| |
| string | Nome do ConfigMap com a configuração de conexão do Ops Manager. A configuração Esse valor deve existir no mesmo namespace que o recurso que você deseja criar. IMPORTANTE: o operador Kubernetes rastreia quaisquer alterações no ConfigMap e reconcilia o estado do recurso |
|
| string | Nome do cluster no recurso |
|
| inteiro | O número de nós neste cluster. |
|
| collection | Opcional. Fornece a configuração para a substituição do StatefulSet para cada um dos StatefulSets do cluster em um sistema MongoDB de cluster multi-Kubernetes. Se especificado em um nível de cluster individual em | Veja o exemplo. |
| collection | Opcional. Se especificado, fornece uma substituição por cluster para o tamanho de armazenamento padrão do volumeClaimtemplates, para o volume persistente que armazena os dados. | Veja o exemplo. |
string | Nome do secret que você criou como credenciais de autenticação da API do Ops Manager para o Kubernetes Operator se comunicar com o Ops Manager. No Ops Manager, o secret do Kubernetes que contém as credenciais precisa existir no mesmo namespace que o recurso que você deseja criar. IMPORTANTE: o operador do Kubernetes rastreia quaisquer alterações no Secret e reconcilia o estado do recurso |
| |
string | Tipo de recurso |
|
Adicione quaisquer configurações aceitas adicionais para uma MongoDBMultiCluster implantação de recurso do.
Você também pode adicionar quaisquer configurações opcionais à especificação do objeto. Consulte Especificação de recursos multi-Kubernetes-Cluster.
Inicie o seu sistema de conjunto de réplicas.
Em qualquer diretório, invoque o seguinte comando do Kubernetes para criar seu conjunto de réplicas:
kubectl apply -f <replica-set-conf>.yamlMonitore o status de sua implantação do MongoDB em cluster multi-Kubernetes.
Para verificar o status do seu recurso MongoDBMultiCluster, use o seguinte comando no cluster central:
kubectl get mdbmc <resource-name> -o yaml -wCom o sinalizador -w (inspeção) definido, quando a configuração muda, o resultado é atualizado imediatamente até que a fase de status atinja o estado Running . Para saber mais sobre os status de distribuição de recursos, consulte Solucionar problemas do operador Kubernetes.
Renovar certificados TLS para um MongoDBMultiCluster recurso
Renove periodicamente seus certificados TLS usando o procedimento a seguir.
Renove o segredo para um recurso MongoDBMultiCluster.
Execute este comando kubectl para renovar um segredo existente que armazena os certificados para o recurso MongoDBMultiCluster:
kubectl --context $MDB_CENTRAL_CLUSTER_FULL_NAME \--namespace=<metadata.namespace> \create secret tls <prefix>-<metadata.name>-cert \--cert=<resource-tls-cert> \--key=<resource-tls-key> \--dry-run=client \-o yaml |kubectl apply -f -Este procedimento não criptografa conexões entre hosts MongoDB em um conjunto de réplicas e entre aplicativos cliente e MongoDB .
Distribua um MongoDBMultiCluster recurso
Configure o kubectl para usar o namespace do cluster central.
Se ainda não tiver feito isso, execute os seguintes comandos para executar todos os comandos kubectl no cluster central no namespace padrão.
kubectl config use-context $MDB_CENTRAL_CLUSTER_FULL_NAMEkubectl config set-context $(kubectl config current-context) \ --namespace=mongodbCopie e cole o recurso de amostra.
Copie o arquivo YAML do conjunto de réplicas de amostra e cole-o em um novo arquivo de texto.
Altere as configurações do arquivo para corresponder à configuração do conjunto de réplicas desejada.
# This example provides statefulSet overrides per cluster.
apiVersion: mongodb.com/v1kind: MongoDBMultiClustermetadata: name: multi-replica-setspec: version: 8.0.0 type: ReplicaSet duplicateServiceObjects: false credentials: my-credentials opsManager: configMapRef: name: my-project clusterSpecList: - clusterName: cluster1.example.com members: 2 statefulSet: spec: template: spec: containers: # Example of custom sidecar containers. Remove it before using the file in production. - name: sidecar1 image: busybox command: [ "sleep" ] args: [ "infinity" ] # Use the following settings to override the default storage size of the "data" Persistent Volume. volumeClaimTemplates: - metadata: name: data spec: resources: requests: storage: 1Gi - clusterName: cluster2.example.com members: 1 statefulSet: spec: template: spec: containers: # Example of custom sidecar containers. Remove it before using the file in production. - name: sidecar2 image: busybox command: [ "sleep" ] args: [ "infinity" ] volumeClaimTemplates: - metadata: name: data spec: resources: requests: storage: 1Gi - clusterName: cluster3.example.com members: 1 statefulSet: spec: template: spec: containers: # Example of custom sidecar containers. Remove it before using the file in production. - name: sidecar3 image: busybox command: [ "sleep" ] args: [ "infinity" ] volumeClaimTemplates: - metadata: name: data spec: resources: requests: storage: 1Gi
Altere as configurações para seus valores preferidos.
Chave | Tipo | Descrição | Exemplo |
|---|---|---|---|
string | Etiqueta para o recurso Os nomes de recursos devem ter 44 caracteres ou menos. Consulte também |
| |
string | Versão do MongoDB que este recurso O formato deve ser IMPORTANTE: Certifique-se de escolher uma versão compatível do MongoDB Server. Versões compatíveis diferem dependendo da imagem base que o recurso do banco de banco de dados MongoDB utiliza. Para saber mais sobre a versão MongoDB, consulte Versões do MongoDB no Manual MongoDB. |
| |
| string | Nome do ConfigMap com a configuração de conexão do Ops Manager. A configuração Esse valor deve existir no mesmo namespace que o recurso que você deseja criar. IMPORTANTE: o operador Kubernetes rastreia quaisquer alterações no ConfigMap e reconcilia o estado do recurso |
|
| string | Nome do cluster no recurso |
|
| inteiro | O número de nós neste cluster. |
|
| collection | Opcional. Fornece a configuração para a substituição do StatefulSet para cada um dos StatefulSets do cluster em um sistema MongoDB de cluster multi-Kubernetes. Se especificado em um nível de cluster individual em | Veja o exemplo. |
| collection | Opcional. Se especificado, fornece uma substituição por cluster para o tamanho de armazenamento padrão do volumeClaimtemplates, para o volume persistente que armazena os dados. | Veja o exemplo. |
string | Nome do secret que você criou como credenciais de autenticação da API do Ops Manager para o Kubernetes Operator se comunicar com o Ops Manager. No Ops Manager, o secret do Kubernetes que contém as credenciais precisa existir no mesmo namespace que o recurso que você deseja criar. IMPORTANTE: o operador do Kubernetes rastreia quaisquer alterações no Secret e reconcilia o estado do recurso |
| |
string | Tipo de recurso |
|
Adicione quaisquer configurações aceitas adicionais para uma MongoDBMultiCluster implantação de recurso do.
Você também pode adicionar quaisquer configurações opcionais à especificação do objeto. Consulte Especificação de recursos multi-Kubernetes-Cluster.
Inicie o seu sistema de conjunto de réplicas.
Em qualquer diretório, invoque o seguinte comando do Kubernetes para criar seu conjunto de réplicas:
kubectl apply -f <replica-set-conf>.yamlMonitore o status de sua implantação do MongoDB em cluster multi-Kubernetes.
Para verificar o status do seu recurso MongoDBMultiCluster, use o seguinte comando no cluster central:
kubectl get mdbmc <resource-name> -o yaml -wCom o sinalizador -w (inspeção) definido, quando a configuração muda, o resultado é atualizado imediatamente até que a fase de status atinja o estado Running . Para saber mais sobre os status de distribuição de recursos, consulte Solucionar problemas do operador Kubernetes.