Puedes usar la API de Ops Manager para cerrar, iniciar, reiniciar y resincronizar un proceso de MongoDB. Cada solicitud actualiza el proceso en la configuración de automatización y publica el cambio de inmediato. El Agente de Automatización del host de destino aplica el cambio en su siguiente check-in. 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.
Requisitos previos
Antes de utilizar los recursos del ciclo de vida del proceso, revise los siguientes requisitos.
Nota
Grupos y proyectos son términos sinónimos. Su {PROJECT-ID} es el mismo que su ID del grupo. Para los grupos existentes, el ID del grupo se mantiene igual. Esta página utiliza el término más familiar grupo cuando se refiere a descripciones. El endpoint permanece tal como se indica en el documento.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Para utilizar los recursos del ciclo de vida del proceso, debes ser usuario de Ops Manager con el rol Project Automation Admin.
Tu despliegue debe ejecutar Ops Manager 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, con un error de 409 AUTOMATION_CONFIG_DRAFT_ALREADY_EXISTS . Publique o descarte el borrador antes de continuar.
Toda validación también se aplica a pruebas en seco, por lo que una prueba exitosa predice que la petición real pasa las mismas comprobaciones. Una petición real puede fallar en un cambio simultáneo o en validación en modo manual.
Importante
Las operaciones del ciclo de vida del proceso no están soportadas para proyectos gestionados externamente ni para 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.
Extremos
La siguiente tabla enumera los puntos finales disponibles para el recurso Ciclo de Vida del Proceso.
Método | Endpoint | Descripción |
|---|---|---|
| Detiene con elegancia un proceso en marcha. | |
| Inicia un proceso que antes estaba cerrado. | |
| Reinicia con gracia un proceso en marcha. | |
| Desencadena una sincronización inicial en un miembro de un conjunto de réplica. |
Pista de auditoría
Cada solicitud exitosa que no sea un ensayo en seco añade un evento al feed de actividad del proyecto, junto con el evento publicado habitual de 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 |
|---|---|---|
| Se realizó una solicitud de cierre para este proceso. Compruebe este evento si un miembro se desconectó inesperadamente. | |
| Se solicitó iniciar un proceso detenido. | |
| Se realizó una solicitud de reinicio para este proceso. Compruebe este evento si un miembro se retiró brevemente o se produjo una elección. | |
| Se realizó una solicitud de resincronización para este proceso. Compruebe este evento si un miembro entró en |