Este tutorial describe cómo utilizar 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 utilizara 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 de tu proyecto. Para los grupos existentes, el ID de tu grupo/proyecto permanece igual. Esta página utiliza el término más conocido "grupo" para referirse a las descripciones. El punto final se mantiene como se indica en el documento.
Considerations
El 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 | Su clave API privada para sus credenciales de API. |
| string | URL de su instancia de Ops Manager. |
| string | Identificador único de su proyecto desde la configuración de su proyecto. |
| string | Identificador único de su clúster. |
Requisito previo
Debe tener credenciales para acceder a Ops Manager como usuario con el Global Owner rol.
Procedimiento
Recupere 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 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.
Compare el
versioncampo de concurrentAutomationConfig.jsonel del archivo de copia de seguridad de configuración de automatización.mms-cluster-config-backup.jsonversionEl 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.jsonWindows:
%SystemDrive%\MMSAutomation\versions\mms-cluster-config-backup.json
Si los valores
versioncoinciden, está trabajando con la versión actual del archivo de configuración de automatización.
Abra el documento de configuración para editarlo.
A medida que edite el documento de configuración en los próximos pasos, consulte 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.
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 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 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 ello, ejecute el siguiente comando, reemplazando los marcadores de posición con las variables de recursos de la 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.
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.