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.
Acerca de esta tarea
Cada operación es asíncrona. Una respuesta
200 OKsignifica 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 sindryRun=trueaplicar el cambio.
Antes de comenzar
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 Adminrol.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.
Cerrar un proceso
Este procedimiento detiene de forma decente un proceso en ejecución.
Encuentra el nombre de host y el puerto del proceso.
Encuentra el hostname:port del proceso en la interfaz de Ops Manager o en el endpoint de2v .0 Get All Hosts .
Consulta el endpoint de estado de automatización.
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 |
Iniciar un proceso
Este procedimiento inicia un proceso que previamente estaba cerrado.
Encuentra el nombre de host y el puerto del proceso.
Encuentra el hostname:port del proceso en la interfaz de Ops Manager o en el endpoint de2v .0 Get All Hosts .
Confirma que el miembro regresa a un estado saludable.
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 |
Reiniciar un 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.
Encuentra el nombre de host y el puerto del proceso.
Encuentra el hostname:port del proceso en la interfaz de Ops Manager o en el endpoint de2v .0 Get All Hosts .
Consulta el endpoint de estado de automatización.
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 |
El agente del host objetivo nunca ha informado al Gestor de Operaciones | El Gestor de Operaciones rechaza la solicitud con |
Resincronizar un proceso
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.
Encuentra el nombre de host y el puerto del proceso.
Encuentra el hostname:port del proceso en la interfaz de Ops Manager o en el endpoint de2v .0 Get All Hosts .
Confirma que el miembro ha completado la sincronización inicial.
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 | Ops Manager rechaza la solicitud con |
Otro miembro del conjunto de réplicas ya tiene una resincronización pendiente | Ops Manager rechaza la solicitud con |
El objetivo es el primario actual | Ops Manager devuelve |
El agente del host objetivo nunca ha informado al Gestor de Operaciones | El Gestor de Operaciones rechaza la solicitud con |
Pista de auditoría
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 |
| Se realizó una solicitud de cierre para este proceso. Compruebe este evento si un miembro se desconectó inesperadamente. |
Inicio |
| Se solicitó iniciar un proceso detenido. |
Reiniciar |
| 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 |
| Se realizó una solicitud de resincronización para este proceso. Compruebe este evento si un miembro entró en |
Solución de problemas
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 |
|---|---|---|
| Tienes un borrador de configuración de automatización no publicado en el proyecto. | Publica o descarta el borrador y luego vuelve a intentarlo. |
| Alguien publicó un cambio entre la lectura de Ops Manager y la publicación de la configuración. | Intenta de nuevo la solicitud. |
| El proyecto se está reconciliando tras una restauración. | Espera a que termine la reconciliación y luego vuelve a intentarlo. |
| 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. |
| Los procesos del proyecto son gestionados por un sistema externo. | Estos endpoints no se aplican a proyectos gestionados externamente. |
|
| Confirma el valor con v2.0 Get All Hosts y luego vuelve a intentarlo. |
| El proceso queda cerrado. | Llama al endpoint de inicio en su lugar. |
| 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. |
| El objetivo es un | En su lugar, resincroniza un miembro de réplica con datos en su lugar. |
|
| 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 | 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 |