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.

Gerenciar o ciclo de vida de um processo

Você pode usar a API do Ops Manager para desligar, iniciar, reiniciar e ressincronizar um processo do MongoDB. Essas operações são úteis durante testes de resiliência para simular períodos de inatividade ou para reinicializações planejadas para manutenção. Você também pode ressincronizar um membro que ficou muito atrasado após uma longa inatividade.

Ao enviar uma solicitação, o Ops Manager instrui imediatamente o Agente de Automação em execução nesse host a desligar, iniciar, reiniciar ou ressincronizar o processo do MongoDB. O agente aplica a alteração em sua próxima comunicação com o Ops Manager. Se o processo for o primário atual, o agente primeiro o desativa para que outro membro possa assumir o controle e, em seguida, o interrompe ou reinicia.

  • Each operation is asynchronous. A 200 OK response means Ops Manager published the change, not that the process has stopped, started, restarted, or resynced. The response includes no job ID. To follow the change to completion, poll the automation status resource. If the agent can't apply the change, the plan shows as failed there and the agent keeps retrying.

  • Every endpoint accepts an optional dryRun=true query parameter. Use it to preview a change before you apply it. Ops Manager runs all the same checks and returns the process document as it would look after the change, but sends nothing to the agent and changes nothing in your deployment. For example, after a shutdown the returned document contains "disabled": true. Review it, then send the same request without dryRun=true to apply the change.

  • Your deployment must run Ops Manager 8.0.28 or 9.0.2 or later.

  • A automação deve estar habilitada para o projeto e o Agente de Automação do host de destino deve estar em execução.

  • Se você tiver um rascunho de configuração de automação não publicado no projeto, o Ops Manager rejeitará todas as solicitações, incluindo uma simulação. Publique ou descarte o rascunho antes de continuar.

  • You must have the Project Automation Admin role.

  • Esses endpoints não são compatíveis com projetos gerenciados externamente nem com implantações do Kubernetes Operator (MCK).

Aviso

Esses endpoints não oferecem proteção de quorum. Desativar muitos membros de um conjunto de réplicas o deixa sem um primário. Desative os membros um de cada vez e aguarde a conclusão de cada um antes de prosseguir.

Este procedimento interrompe um processo em execução de forma controlada.

1

Find the hostname:port of the process in the Ops Manager UI or with the v2.0 Get All Hosts endpoint.

2
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/process/{HOST-PORT}:shutdown?pretty=true&dryRun=true"
3

Remove dryRun=true from the request. Ops Manager returns 200 OK with the process document, now with "disabled": true.

4

Poll the automation status resource until the process's lastGoalVersionAchieved equals the plan's goalVersion.

A tabela a seguir descreve como o Ops Manager lida com solicitações de desligamento em cenários específicos.

Cenário
Comportamento

A Target é a principal atual

O agente diminui a velocidade antes de desligá-lo.

A Target já fechou.

Nenhuma alteração no processo. O agente não executa nenhuma ação, mas o Ops Manager ainda publica a configuração e registra o evento.

O alvo está em modo manual.

Ops Manager rejects the request with 400. You cannot shut down a manual-mode process through automation.

Este procedimento inicia um processo que havia sido previamente encerrado.

1

Find the hostname:port of the process in the Ops Manager UI or with the v2.0 Get All Hosts endpoint.

2
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/process/{HOST-PORT}:startup?pretty=true&dryRun=true"
3

Remove dryRun=true from the request. Ops Manager returns 200 OK with the process document, now with "disabled": false.

4

Poll the automation status resource until the plan completes. Then confirm that the member's replicaStateName on the v2.0 Get One Host by ID endpoint returns to SECONDARY or PRIMARY.

A tabela a seguir descreve como o Ops Manager lida com solicitações de inicialização em cenários específicos.

Cenário
Comportamento

O alvo já está em execução.

Nenhuma alteração no processo. O agente não executa nenhuma ação, mas o Ops Manager ainda publica a configuração e registra o evento.

O oplog foi reiniciado enquanto o processo estava inativo.

The member starts and stays in RECOVERING and doesn't resync automatically. Resync the process instead.

Este procedimento reinicia um processo em execução de forma controlada. Se o alvo for o processo primário atual, o agente o desativa antes de reiniciá-lo.

1

Find the hostname:port of the process in the Ops Manager UI or with the v2.0 Get All Hosts endpoint.

2
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/process/{HOST-PORT}:restart?pretty=true&dryRun=true"
3

Remove dryRun=true from the request. Ops Manager returns 200 OK with the process document, now with lastRestart set.

4

Monitore o status do recurso de automação até que o plano seja concluído.

A tabela a seguir descreve como o Ops Manager lida com solicitações de reinicialização em cenários específicos.

Cenário
Comportamento

A Target está fechada.

Ops Manager rejects the request with 400 PROCESS_DISABLED_CANNOT_RESTART. Start the process instead.

O agente do host de destino nunca se reportou ao Gerente de Operações.

Ops Manager rejects the request with 409 PROCESS_AGENT_NOT_REPORTING.

This procedure triggers an initial sync on a replica set member. Use it to recover a member stuck in RECOVERING because it fell behind the oplog window.

1

Find the hostname:port of the process in the Ops Manager UI or with the v2.0 Get All Hosts endpoint.

2
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/process/{HOST-PORT}:resync?pretty=true&dryRun=true"
3

Remove dryRun=true from the request. Ops Manager returns 200 OK with the process document, now with lastResync set.

4

Poll the automation status resource until the plan completes. Then poll v2.0 Get One Host by ID until replicaStateName is SECONDARY. The initial sync can take a long time on large data sets.

A tabela a seguir descreve como o Ops Manager lida com solicitações de ressincronização em cenários específicos.

Cenário
Comportamento

The target is a mongos, a standalone, or an arbiter

Ops Manager rejects the request with 400 PROCESS_RESYNC_NOT_SUPPORTED. You can resync only data-bearing replica set members.

Outro membro do conjunto de réplicas já tem uma resincronização pendente.

Ops Manager rejects the request with 409 PROCESS_RESYNC_IN_PROGRESS, including dry runs. Wait for the deployment to reach goal state, then retry.

O alvo é o atual primário

Ops Manager returns 200 OK, but the Automation Agent doesn't resync a primary. The plan stays pending with the message A resync was requested on a primary. This requires manual intervention. The member keeps running as primary.

O agente do host de destino nunca se reportou ao Gerente de Operações.

Ops Manager rejects the request with 409 PROCESS_AGENT_NOT_REPORTING.

Cada solicitação bem-sucedida, que não seja um teste, adiciona um evento ao feed de atividades do projeto, além do evento de publicação da configuração de automação usual. O feed de atividades atribui as solicitações feitas com a API à API Pública.

(operação)
Tipo de evento
O que ele diz a você

Desligar

AUTOMATION_PROCESS_SHUTDOWN_REQUESTED

Foi feita uma solicitação de encerramento para este processo. Verifique este evento se um membro ficou offline inesperadamente.

Iniciar

AUTOMATION_PROCESS_STARTUP_REQUESTED

Foi feita uma solicitação para iniciar um processo que havia sido interrompido.

Reiniciar

AUTOMATION_PROCESS_RESTART_REQUESTED

Foi feita uma solicitação de reinicialização para este processo. Verifique este evento se um membro se ausentou brevemente ou se ocorreu uma eleição.

Ressincronizar

AUTOMATION_PROCESS_RESYNC_REQUESTED

A resync request was made for this process. Check this event if a member went into STARTUP2 or RECOVERING and is re-copying data.

A tabela a seguir descreve os erros e sintomas comuns que ocorrem ao usar os endpoints do ciclo de vida do processo.

Problema
Provável Causa
de conflitos

409 AUTOMATION_CONFIG_DRAFT_ALREADY_EXISTS

Você tem um rascunho de configuração de automação não publicado no projeto.

Publique ou descarte o rascunho e tente novamente.

409 AUTOMATION_CONFIG_CONCURRENT_MODIFICATION

Alguém publicou uma alteração entre o Ops Manager lendo e publicando a configuração.

Tente novamente.

409 GROUP_IN_RESTORATION_MODE

O projeto está se reconciliando após uma restauração.

Aguarde a conclusão da reconciliação e tente novamente.

409 PROCESS_AGENT_NOT_REPORTING

O agente do host de destino nunca se reportou ao Gerente de Operações.

Confirme se o agente está instalado, em execução e consegue se conectar ao Ops Manager. Em seguida, tente novamente.

403 PROCESS_EXTERNALLY_MANAGED

Os processos do projeto são gerenciados por um sistema externo.

Esses endpoints não se aplicam a projetos gerenciados externamente.

404 PROCESS_NOT_FOUND

hostname:port Não corresponde a nenhum processo na configuração de automação do projeto.

Confirm the value with v2.0 Get All Hosts, then retry.

400 PROCESS_DISABLED_CANNOT_RESTART

O processo foi encerrado.

Em vez disso, chame o endpoint de inicialização.

409 PROCESS_RESYNC_IN_PROGRESS

Uma resincronização para este conjunto de réplicas já foi solicitada e a implantação ainda não atingiu o estado desejado. Uma resincronização travada, por exemplo, uma solicitada em um servidor primário, continua bloqueando novas solicitações.

Monitore o status do recurso de automação até que o plano seja concluído e, em seguida, tente novamente.

400 PROCESS_RESYNC_NOT_SUPPORTED

The target is a mongos, a standalone, or an arbiter, which have no data to sync.

Em vez disso, resincronize um membro do conjunto de réplicas que contenha dados.

400 INVALID_QUERY_PARAMETER

dryRun isn't true or false, including an empty value. For example, dryRun=tru or dryRun=.

Corrija o valor ou omita o parâmetro.

Após a ressincronização, o status da automação indica que é necessária intervenção manual.

A resincronização foi solicitada em um servidor primário.

Reduza a prioridade do processo primário para desbloquear a ressincronização.

O plano continua falhando no status de automação.

O agente não consegue aplicar a alteração, por exemplo, porque o host está inacessível.

Analise o erro do processo na resposta de status da automação e corrija a causa. O agente tentará novamente.

Member stays in RECOVERING after startup

O oplog foi sobrescrito enquanto o processo estava inativo, então o membro não conseguiu recuperar o atraso.

Resync the process, then check replicaStateName on the host until it is SECONDARY.