Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Retornar um banco de dados de aplicativo externo ao MongoDB Ops Manager

Você pode retornar um banco de dados de aplicativo externo ao gerenciamento interno pelo recurso do MongoDB Ops Manager. O recurso do MongoDB Ops Manager recupera o StatefulSet do banco de dados de aplicativo existente, e então você exclui o recurso do MongoDB que o gerenciou. O operador Kubernetes não move nem recria seus dados e não reinicia os pods do MongoDB Ops Manager.

O recurso do MongoDB Ops Manager começa com um banco de dados de aplicativo externo: um recurso do MongoDB com spec.role definido como AppDB, chamado <primary-om-name>-db, que possui o StatefulSet do banco de dados de aplicativo. A migração prossegue da seguinte forma:

  1. Você remove spec.externalApplicationDatabaseRef do recurso do MongoDB Ops Manager e adiciona spec.applicationDatabase.

  2. O Kubernetes operador solicita ao recurso MongoDB que libere o StatefulSet. O recurso MongoDB relata a fase Pending enquanto aguarda que o recurso MongoDB Ops Manager o recupere.

  3. O operador Kubernetes recupera o StatefulSet e o gerencia como um banco de dados de aplicativo interno. Como a string de conexão não muda, os pods do Ops Manager não reiniciam.

  4. Você exclui o recurso do MongoDB, que não possui mais nada.

Aviso

Exclua o recurso MongoDB somente depois que o recurso MongoDB Ops Manager gerenciar o banco de dados de aplicativo interno novamente. Se você excluir o recurso MongoDB enquanto ele ainda for proprietário do StatefulSet, o Kubernetes coletará o lixo do banco de dados de aplicativo. Em recuperação desse estado requer a recriação do banco de dados de aplicativo a partir das Persistent Volume Claims retidas, o que causa tempo de inatividade e rotaciona as credenciais do banco de dados de aplicativo.

Antes de começar, conclua as seguintes tarefas:

  • Instale o operador Kubernetes e kubectl. Para aprender mais, consulte Instalar com Kubernetes.

  • Confirme se o recurso primário do MongoDB Ops Manager usa um banco de dados de aplicativo externo: ele define spec.externalApplicationDatabaseRef para um recurso MongoDB chamado <primary-om-name>-db, ele não define spec.applicationDatabase, e seu status.applicationDatabase.phase relata Disabled.

  • Confirme que o recurso MongoDB está na fase Running e possui o StatefulSet do banco de dados de aplicativo.

Revisar as seguintes considerações antes de migrar:

  • Defina spec.applicationDatabase.version para a versão que o banco de dados de aplicativo já executa. Reutilizar a mesma versão mantém os mesmos binários e dados intactos. Uma versão diferente inicia uma atualização do banco de dados de aplicativo ao mesmo tempo que a transferência.

  • O operador do Kubernetes não exclui o projeto do MongoDB Ops Manager que ele criou para o banco de dados de aplicativo externo. Remover esse projeto torna as métricas históricas do banco de dados de aplicativo ilegíveis, portanto, a limpeza é uma decisão sua.

1
export K8S_CTX="<your-kube-context>"export MDB_NS="mongodb" export PRIMARY_OM_NAME="primary-om"export APPDB_NAME="${PRIMARY_OM_NAME}-db"export APPDB_VERSION="8.0.5-ent"
2
  1. Confirme se o recurso do MongoDB Ops Manager faz referência ao banco de dados de aplicativo externo e relata seu banco de dados de aplicativo como Disabled:

    kubectl get om "${PRIMARY_OM_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" \ -o jsonpath='ref={.spec.externalApplicationDatabaseRef.name} appdb={.status.applicationDatabase.phase}{"\n"}'
  2. Confirme que o recurso MongoDB possui o StatefulSet do banco de dados de aplicativo:

    kubectl get statefulset "${APPDB_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" \ -o jsonpath='{range .metadata.ownerReferences[*]}{.kind}/{.name}{"\n"}{end}'

    O comando retorna MongoDB/${APPDB_NAME}.

3

Este patch remove spec.externalApplicationDatabaseRef e adiciona spec.applicationDatabase.

kubectl patch om "${PRIMARY_OM_NAME}" \ --context "${K8S_CTX}" -n "${MDB_NS}" \ --type merge \ -p "{\"spec\":{\"externalApplicationDatabaseRef\":null,\"applicationDatabase\":{\"members\":3,\"version\":\"${APPDB_VERSION}\"}}}"
4
  1. Confirme se o recurso MongoDB libera o StatefulSet. O recurso relata a fase Pending com uma mensagem de que está em migração reversa para o recurso MongoDB Ops Manager:

    kubectl wait --for=jsonpath='{.status.phase}'=Pending \ mdb/"${APPDB_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" --timeout=300s kubectl get mdb "${APPDB_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" \ -o jsonpath='{.status.message}{"\n"}'
  2. Aguarde o recurso do MongoDB Ops Manager gerenciar o banco de dados de aplicativo interno novamente:

    kubectl wait --for=jsonpath='{.status.applicationDatabase.phase}'=Running \ om/"${PRIMARY_OM_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" --timeout=1200s kubectl wait --for=jsonpath='{.status.opsManager.phase}'=Running \ om/"${PRIMARY_OM_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" --timeout=1800s
5

Conclua esta etapa somente após a etapa anterior relatar applicationDatabase.phase=Running.

kubectl delete mdb "${APPDB_NAME}" \ --context "${K8S_CTX}" -n "${MDB_NS}" --wait=true --timeout=300s
6
  1. Confirme que o recurso do MongoDB Ops Manager possui o StatefulSet do banco de dados de aplicativo:

    kubectl get statefulset "${APPDB_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" \ -o jsonpath='{range .metadata.ownerReferences[*]}{.kind}/{.name}{"\n"}{end}'

    O comando retorna MongoDBOpsManager/${PRIMARY_OM_NAME}.

  2. Confirme se o recurso do MongoDB Ops Manager relata seu banco de dados de aplicativo como Running e que o recurso do MongoDB não existe mais:

    kubectl get om "${PRIMARY_OM_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" \ -o jsonpath='{.status.applicationDatabase.phase}{"\n"}' kubectl get mdb --context "${K8S_CTX}" -n "${MDB_NS}"
  3. Confirme que os pods do MongoDB Ops Manager não foram reiniciados verificando sua idade e contagens de reinicialização:

    kubectl get pods --context "${K8S_CTX}" -n "${MDB_NS}"

Se o recurso do MongoDB permanecer na fase Running e ainda possuir o StatefulSet, o recurso do MongoDB Ops Manager não solicitou a liberação. Confirme se o seu conjunto de patches spec.externalApplicationDatabaseRef para null e adicionou spec.applicationDatabase.

Defina spec.applicationDatabase.version para a versão que o banco de dados de aplicativo já executa para que o StatefulSet recuperado mantenha os mesmos binários.

Se você excluir o recurso MongoDB enquanto ele ainda possui o StatefulSet, o Kubernetes coleta o lixo do StatefulSet e os segredos que ele compartilha com o recurso MongoDB Ops Manager. Para recuperar, recrie o banco de dados de aplicativo a partir das Reivindicações de Volume Persistente retidas. Esse caminho causa tempo de inatividade e rotaciona as credenciais do banco de dados de aplicativo. Para saber mais, consulte Recuperação de desastres para o MongoDB Ops Manager e Recursos do AppDB.

Para usar um banco de dados de aplicativo externo novamente, consulte Migrar um banco de dados de aplicativo para uma implantação externa.