Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Gestionar el ciclo de vida de un proceso

Puedes usar la API de Ops Manager para apagar, iniciar, reiniciar y resincronizar un proceso de MongoDB. Estas operaciones son útiles durante pruebas de resiliencia para simular inactividad o para reinicios de mantenimiento planificados. También puedes resincronizar un miembro que se haya retrasado demasiado tras un apagado prolongado.

Cuando envías una solicitud, Ops Manager indica inmediatamente al Agente de Automatización que se ejecuta en ese host que apague, inicie, reinicie o resincronice el proceso de MongoDB. El agente aplica el cambio en su siguiente check-in con Ops Manager. Si el proceso es el principal actual, el agente primero lo reduce para que otro miembro pueda hacerse cargo y luego lo detiene o reinicia.

  • Cada operación es asíncrona. Una respuesta 200 OK significa que Ops Manager publicó el cambio, no que el proceso se haya detenido, iniciado, reiniciado o resincronizado. La respuesta no incluye ID de trabajo. Para seguir el cambio hasta su finalización, consulta el recurso de estado de automatización . Si el agente no puede aplicar el cambio, el plan aparece como fallido allí y el agente sigue intentándolo de nuevo.

  • Cada endpoint acepta un parámetro opcional de consulta dryRun=true . Úsalo para previsualizar un cambio antes de aplicarlo. Ops Manager ejecuta todas las mismas comprobaciones y devuelve el documento de proceso tal como sería tras el cambio, pero no envía nada al agente y no cambia nada en tu implementación. Por ejemplo, tras un apagado, el documento devuelto contiene "disabled": true. Revísalo y luego envía la misma solicitud sin dryRun=true aplicar el cambio.

  • Tu despliegue debe ejecutar el gestor de operaciones 8.0.28 o 9.0.2 o posterior.

  • La automatización debe estar habilitada para el proyecto y el Agente de Automatización del host objetivo debe estar en ejecución.

  • Si tienes un borrador de configuración de automatización no publicado en el proyecto, Ops Manager rechaza todas las solicitudes, incluida una prueba en seco. Publica o descarta el borrador antes de continuar.

  • Debes tener el Project Automation Admin rol.

  • Estos endpoints no soportan proyectos gestionados externamente ni despliegues de Kubernetes Operator (MCK).

Advertencia

Estos endpoints no proporcionan protección de quórum. Apagar demasiados miembros de un conjunto réplica lo deja sin un elemento principal. Apaga los miembros uno a uno y espera a que cada uno se detenga antes de continuar.

Este procedimiento detiene de forma decente un proceso en ejecución.

1

Encuentra el hostname:port del proceso en la interfaz de Ops Manager o en el endpoint de2v .0 Get All Hosts .

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

Elimina dryRun=true de la solicitud. Ops Manager devuelve 200 OK con el documento de proceso, ahora con "disabled": true.

4

Consulta el recurso de estado de automatización hasta que la lastGoalVersionAchieved del proceso sea igual a la goalVersiondel plan.

La siguiente tabla describe cómo Ops Manager gestiona las solicitudes de cierre en escenarios específicos.

Scenario
Comportamiento

El objetivo es el principal actual

El agente baja la posición antes de detenerla.

El objetivo ya está cerrado

Sin cambios en el proceso. El agente no toma ninguna medida, pero Ops Manager sigue publicando la configuración y registrando el evento.

El objetivo está en modo manual

Ops Manager rechaza la solicitud con 400. No puedes cerrar un proceso en modo manual mediante automatización.

Este procedimiento inicia un proceso que previamente estaba cerrado.

1

Encuentra el hostname:port del proceso en la interfaz de Ops Manager o en el endpoint de2v .0 Get All Hosts .

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

Elimina dryRun=true de la solicitud. Ops Manager devuelve 200 OK con el documento de proceso, ahora con "disabled": false.

4

Consulta el recurso de estado de automatización hasta que el plan se complete. Luego confirma que el replicaStateName del miembro en el 2v .0 Get One Host by ID endpoint devuelve a SECONDARY o PRIMARY.

La siguiente tabla describe cómo Ops Manager gestiona las solicitudes de inicio en escenarios específicos.

Scenario
Comportamiento

Target ya está funcionando

Sin cambios en el proceso. El agente no toma ninguna medida, pero Ops Manager sigue publicando la configuración y registrando el evento.

El oplog se relajó mientras el proceso estaba en marcha

El miembro inicia y permanece en RECOVERING y no se resincroniza automáticamente. En su lugar, resincroniza el proceso.

Este procedimiento reinicia de forma ordenada un proceso en ejecución. Si el objetivo es el principal actual, el agente lo reduce antes de reiniciarlo.

1

Encuentra el hostname:port del proceso en la interfaz de Ops Manager o en el endpoint de2v .0 Get All Hosts .

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

Elimina dryRun=true de la solicitud. Ops Manager devuelve 200 OK con el documento de proceso, ahora con lastRestart configurado.

4

Consulta el recurso de estado de automatización hasta que el plan se complete.

La siguiente tabla describe cómo Ops Manager gestiona las solicitudes de reinicio en escenarios específicos.

Scenario
Comportamiento

El objetivo está cerrado

Ops Manager rechaza la solicitud con 400 PROCESS_DISABLED_CANNOT_RESTART. Inicie el proceso en su lugar.

El agente del host objetivo nunca ha informado al Gestor de Operaciones

El Gestor de Operaciones rechaza la solicitud con 409 PROCESS_AGENT_NOT_REPORTING.

Este procedimiento desencadena una sincronización inicial en un miembro de un conjunto de réplica. Úsalo para recuperar un miembro atascado en RECOVERING porque quedó por detrás de la ventana de oplog.

1

Encuentra el hostname:port del proceso en la interfaz de Ops Manager o en el endpoint de2v .0 Get All Hosts .

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

Elimina dryRun=true de la solicitud. Ops Manager devuelve 200 OK con el documento de proceso, ahora con lastResync configurado.

4

Consulta el recurso de estado de automatización hasta que el plan se complete. Luego consulta v2.0 Obtén un host por ID hasta que replicaStateName esté SECONDARY. La sincronización inicial puede tardar mucho en conjuntos de datos grandes.

La siguiente tabla describe cómo Ops Manager gestiona las solicitudes de resincronización en escenarios específicos.

Scenario
Comportamiento

El objetivo es un mongos, un independiente o un árbitro

Ops Manager rechaza la solicitud con 400 PROCESS_RESYNC_NOT_SUPPORTED. Solo puedes resincronizar miembros del conjunto de réplicas que contengan datos.

Otro miembro del conjunto de réplicas ya tiene una resincronización pendiente

Ops Manager rechaza la solicitud con 409 PROCESS_RESYNC_IN_PROGRESS, incluyendo las pruebas en seco. Espere a que el despliegue alcance el estado objetivo y luego vuelva a intentarlo.

El objetivo es el primario actual

Ops Manager devuelve 200 OK, pero el Agente de Automatización no resincroniza un primario. El plan permanece pendiente con el mensaje A resync was requested on a primary. This requires manual intervention. El miembro sigue ejecutándose como primario.

El agente del host objetivo nunca ha informado al Gestor de Operaciones

El Gestor de Operaciones rechaza la solicitud con 409 PROCESS_AGENT_NOT_REPORTING.

Cada solicitud exitosa, no ejecutiva en seco, añade un evento al feed de actividad del proyecto, junto con el evento habitual publicado por configuración de automatización. El feed de actividad atribuye las solicitudes realizadas con la API a la API Pública.

Operación
Tipo de evento
Lo que te dice

Apagado

AUTOMATION_PROCESS_SHUTDOWN_REQUESTED

Se realizó una solicitud de cierre para este proceso. Compruebe este evento si un miembro se desconectó inesperadamente.

Inicio

AUTOMATION_PROCESS_STARTUP_REQUESTED

Se solicitó iniciar un proceso detenido.

Reiniciar

AUTOMATION_PROCESS_RESTART_REQUESTED

Se realizó una solicitud de reinicio para este proceso. Compruebe este evento si un miembro se retiró brevemente o se produjo una elección.

Resincronizar

AUTOMATION_PROCESS_RESYNC_REQUESTED

Se realizó una solicitud de resincronización para este proceso. Compruebe este evento si un miembro entró en STARTUP2 o RECOVERING y está recopiando datos.

La siguiente tabla describe errores y síntomas comunes cuando utilizas los endpoints del ciclo de vida del proceso.

Síntoma
Causa probable
Resolución

409 AUTOMATION_CONFIG_DRAFT_ALREADY_EXISTS

Tienes un borrador de configuración de automatización no publicado en el proyecto.

Publica o descarta el borrador y luego vuelve a intentarlo.

409 AUTOMATION_CONFIG_CONCURRENT_MODIFICATION

Alguien publicó un cambio entre la lectura de Ops Manager y la publicación de la configuración.

Intenta de nuevo la solicitud.

409 GROUP_IN_RESTORATION_MODE

El proyecto se está reconciliando tras una restauración.

Espera a que termine la reconciliación y luego vuelve a intentarlo.

409 PROCESS_AGENT_NOT_REPORTING

El agente del anfitrión objetivo nunca ha reportado al Gerente de Operaciones.

Confirme que el agente está instalado, en funcionamiento y puede contactar con Ops Manager, luego vuelve a intentarlo.

403 PROCESS_EXTERNALLY_MANAGED

Los procesos del proyecto son gestionados por un sistema externo.

Estos endpoints no se aplican a proyectos gestionados externamente.

404 PROCESS_NOT_FOUND

hostname:port no coincide con un proceso en la configuración de automatización del proyecto.

Confirma el valor con v2.0 Get All Hosts y luego vuelve a intentarlo.

400 PROCESS_DISABLED_CANNOT_RESTART

El proceso queda cerrado.

Llama al endpoint de inicio en su lugar.

409 PROCESS_RESYNC_IN_PROGRESS

Ya se solicitó una resincronización para este conjunto de réplicas y el despliegue aún no ha alcanzado el estado objetivo. Una resincronización que se queda atascada, por ejemplo una solicitada en un sistema principal, sigue bloqueando nuevas solicitudes.

Consulta el recurso de estado de automatización hasta que el plan se complete y, a continuación, vuelve a intentarlo.

400 PROCESS_RESYNC_NOT_SUPPORTED

El objetivo es un mongos, un standalone o un árbitro, que no tienen datos que sincronizar.

En su lugar, resincroniza un miembro de réplica con datos en su lugar.

400 INVALID_QUERY_PARAMETER

dryRun no es true ni false, incluyendo un valor vacío. Por ejemplo, dryRun=tru o dryRun=.

Fije el valor o omita el parámetro.

Tras la resincronización, el estado de la automatización muestra que se requiere intervención manual

La resincronización se solicitó en un primario.

Baja la primaria para desbloquear la resincronización.

El plan sigue fallando en estado de automatización

El agente no puede aplicar el cambio, por ejemplo, porque el host es inaccesible.

Revisa el error del proceso en la respuesta de estado de la automatización y corrige la causa. El agente luego intenta.

El socio permanece en RECOVERING tras el inicio

El oplog se relajó mientras el proceso estaba en marcha, así que el miembro no pudo ponerse al día.

Resincroniza el proceso y luego comprueba replicaStateName en el host hasta que esté SECONDARY.