Este tutorial describe cómo usar el API para migrar una implementación de MongoDB a una nueva versión. Estos pasos asumen que ya tiene una implementación que utiliza una 4.0.6 versión de MongoDB, como sería el caso si utilizas el tutorial para implementar un clúster a través de la API.
Nota
Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} es el mismo que el ID del grupo. Para los grupos existentes, el ID del grupo permanece igual. Esta página utiliza el término grupo, más familiar, cuando se refiere a descripciones. El endpoint sigue siendo el declarado en el documento.
Considerations
La La API es compatible con la mayoría de las configuraciones y parámetros de MongoDB para las versiones 2.6 y posteriores. Para obtener más información, consulte Configuración y compatibilidad con automatización de MongoDB.
Advertencia
Actualizaciones de MongoDB 5.0 a 6.0
Cuando actualiza un clúster fragmentado de MongoDB 5.0 a 6.0, debe utilizar el procedimiento en la
Actualice un clúster 6.0 fragmentado a la página del Manual de MongoDB para actualizar la tabla de enrutamiento en caché para mongos cada.
Variables para que los recursos de la API actualicen la versión de MongoDB
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 |
|---|---|---|
| string | Su clave API pública para sus credenciales de API. |
| string | Tu llave privada de API para tus credenciales de API. |
| string | URL de su instancia de Ops Manager. |
| string | Identificador único de tu proyecto desde la configuración del proyecto. |
| string | Identificador único de tu clúster. |
Requisito previo
Debe tener credenciales para acceder a Ops Manager como usuario con el rol Global Owner.
Procedimiento
Recupere la configuración de automatización de Ops Manager.
Utilice el recurso automationConfig para recuperar la configuración. Emite el siguiente comando, sustituyendo los marcadores de posición por las Variables para los Recursos de API para actualizar la versión de MongoDB.
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.
Compara el campo
versiondelcurrentAutomationConfig.jsoncon el del archivo de copia de seguridad de Configuración de Automatización,mms-cluster-config-backup.json. El valorversiones el último elemento en ambos documentos JSON . Puedes encontrar este archivo en cualquier host que ejecute el MongoDB Agent en:Linux y macOS:
/var/lib/mongodb-mms-automation/mms-cluster-config-backup.jsonWindows:
%SystemDrive%\MMSAutomation\versions\mms-cluster-config-backup.json
Si los valores
versioncoinciden, estás trabajando con la versión actual del archivo de configuración de Automatización.
Abra el documento de configuración para editarlo.
Mientras editas el documento de configuración en los siguientes pasos, consulta la descripción de una configuración de automatización para obtener descripciones detalladas de las configuraciones.
Envíe la configuración de automatización actualizada.
Utiliza el recurso automationConfig para enviar la configuración de automatización actualizada.
Ejecute el siguiente comando con la ruta al documento de configuración actualizado y sustituya los espacios reservados por las Variables de Recursos de API para Actualizar la Versión de MongoDB.
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 la actualización exitosa de la configuración, la API devuelve el código de estado HTTP 200 OK para indicar que la solicitud se ha realizado correctamente.
Confirmar la actualización exitosa de la configuración de automatización.
Recupera la configuración de automatización desde Ops Manager y confirma que contenga los cambios. Para recuperar la configuración, ejecuta el siguiente comando, reemplazando los marcadores de posición con las Variables de Recursos de API para Actualizar la Versión de MongoDB.
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.
Usa el recurso automationStatus para recuperar el estado de implementación. Ejecuta el siguiente comando, reemplazando los marcadores de posición con las Variables para los Recursos de API para Actualizar la Versión de MongoDB.
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationStatus?pretty=true"
Confirma que los valores de todos los campos lastGoalVersionAchieved en el arreglo processes coincidan con el campo goalVersion. Para conocer el estado de la implementación, consulta Obtener el estado de automatización del último plan.