/ /

/ /

Gerente de Operaciones

API

Tutorials

Actualizar la configuración de automatización de un proyecto

Un proyecto La configuración de automatización determina el estado objetivo de sus procesos y agentes MongoDB. El agente MongoDB crea la implementación según los objetivos especificados.

Para actualizar la configuración:

Recuperar la configuración actual.
Puede usar el punto final /groups/{PROJECT-ID}/automationConfig para obtener la configuración completa, o usar el punto final /groups/{PROJECT-ID}/automationConfig/noSecrets para obtener la configuración con información confidencial redactada, como contraseñas o valores de clave.
Realice cambios en una copia de la configuración actual, cambiando sólo aquellos elementos que desee modificar.
Reemplace toda la configuración usando PUT, con la configuración actualizada en el cuerpo de la solicitud.PUTDebe usar. No PATCH use.
Cuando envías actualizaciones, Ops Manager realiza modificaciones internas en los datos y luego guarda la nueva versión de tu configuración.

Nota

Algunos parámetros no se pueden actualizar a través del punto final automationConfig. Para obtener más información, consulte:

Para realizar actualizaciones al Agente MongoDB que no hostnamesean, debe hacerlo a través de un punto final diferente.

Importante

Una configuración de automatización puede contener información confidencial, como contraseñas o valores de clave. Para actualizar la configuración de automatización de un proyecto sin actualizar ningún campo que contenga información confidencial, utilice el punto de conexión /groups/{PROJECT-ID}/automationConfig/noSecrets.

Requisitos previos

Debes tener acceso a la API. Para obtener más información, consulte Configurar el acceso a la API.

Variables para recursos de la API de configuración de automatización

Los recursos de la API utilizan una o más de estas variables. Reemplaza estas variables con tus valores deseados antes de llamar a estos recursos API.

Nombre	Tipo	Descripción
`PUBLIC-KEY`	string	Su clave API pública para sus credenciales de API.
`PRIVATE-KEY`	string	Su clave API privada para sus credenciales de API.
`<OpsManagerHost>:<Port>`	string	URL de su instancia de Ops Manager.
`GROUP-ID`	string	Identificador único de su proyecto desde la configuración de su proyecto.
`CLUSTER-ID`	string	Identificador único de su clúster.

Procedimiento

Recupere y valide la configuración de automatización de Ops Manager.

Utilice el recurso automationConfig para recuperar la configuración. Ejecute el siguiente comando, reemplazando los marcadores de posición con las variables de los recursos de la API de Automation Config.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \
     --output currentAutomationConfig.json

Validar el archivo de configuración de automatización descargado.
Compare el version campo de con currentAutomationConfig.json el del archivo de copia de seguridad de configuración de automatización. mms-cluster-config-backup.json version El valor es el último elemento en ambos documentos JSON. Puede encontrar este archivo en cualquier host que ejecute el Agente de MongoDB en:
- Linux y macOS: /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json
- Windows: %SystemDrive%\MMSAutomation\versions\mms-cluster-config-backup.json
Si los valores version coinciden, está trabajando con la versión actual del archivo de configuración de automatización.

Edite el archivo de configuración de automatización descargado.

Abra currentAutomationConfig.json en su editor de texto preferido.

Para obtener más información sobre las opciones de configuración de automatización, consulte Configuración de automatización.

Si está actualizando el Agente MongoDB, consulte Actualizar versiones del agente antes de continuar con este procedimiento.

Envíe la configuración de automatización actualizada.

Utilice el recurso automationConfig para enviar la configuración de automatización actualizada.

Emita el siguiente comando con la ruta al documento de configuración actualizado y reemplace los marcadores de posición con las variables para los recursos de API de configuración de automatización.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Content-Type: application/json" \
     --request PUT "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \
     --data @currentAutomationConfig.json

Tras una actualización exitosa de la configuración, la API devuelve el código de estado HTTP 200 OK para indicar que la solicitud se realizó correctamente.

Confirmar la actualización exitosa de la configuración de automatización.

Recupere la configuración de automatización de Ops Manager y confirme que contenga los cambios. Para recuperarla, ejecute el siguiente comando, reemplazando los marcadores de posición con las variables de los recursos de la API de configuración de automatización.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true"

Verifique el estado de la implementación para garantizar que se alcance el estado objetivo.

Utilice el recurso automationStatus para recuperar el estado de la implementación. Ejecute el siguiente comando, reemplazando los marcadores de posición con las variables de los recursos de la API de configuración de automatización.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationStatus?pretty=true"

Confirme que los valores de todos los lastGoalVersionAchieved campos de la processes matriz coincidan con los del goalVersion campo. Para obtener información sobre el estado de la implementación, consulte Obtener el estado de automatización del último plan.

Volver

Implementar clúster

Rotar archivo de claves