Migrar en vivo (Push) un clúster supervisado por Cloud Manager a Atlas

En Atlas, diríjase a Migration Hub de su proyecto.

1. Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.

2. Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.

3. En la barra lateral, haz clic en Migration en la sección Services.

El centro de migración muestra.

Inicie el proceso de migración.

1. Haga clic en Migrate from a Self-Managed MongoDB Database.

   Nota

   La etiqueta de la interfaz de usuario menciona Ops Manager; sin embargo, para este procedimiento, solo puedes migrar a clústeres que ejecuten MongoDB 6.0 o una versión posterior que Cloud Manager supervise.

2. Haga clic en I'm Ready to Start.

Atlas muestra un asistente de migración en vivo con instrucciones sobre cómo proceder con el proceso. El proceso transfiere los datos del clúster de origen al nuevo clúster de destino. Después de completar los pasos del asistente, se puede dirigir la aplicación al nuevo clúster.

Enlaza con Atlas.

1. Haz clic en Generate Link-Token. Atlas muestra la página para generar un link-token.

2. Haz clic en Next para ver una página que contiene el link-token generado.

3. Copia el link-token y almacénalo en una ubicación segura. Atlas nunca muestra el contenido del link-token. Atlas tampoco muestra el link-token después de generarlo. No lo compartas públicamente.

   Nota

   Utiliza un link-token único para migrar en vivo todos los proyectos en una sola organización de Cloud Manager a Atlas.

4. Haga clic en Done.

Pega el link-token en Cloud Manager.

1. Acceda a la organización en Cloud Manager:

   Abre Cloud Manager y navega hasta la organización a la que pertenece el clúster de proyecto que estás migrando en vivo a Atlas.

2. Haz clic en Settings en el panel de navegación izquierdo.

3. En la sección Live Migration: Connect to Atlas, haz clic en Connect to Atlas. Se abre el cuadro de diálogo Connect to Atlas.

4. Pega el link-token que has generado en el paso anterior del asistente de Migración en vivo y haz clic en Connect to Atlas. Cloud Manager establece la conexión con Atlas. Usa el botón Refresh para enviar una actualización a Atlas, si es necesario.

Crea el clúster de Atlas de destino.

Si aún no lo ha hecho, cree un clúster de destino en Atlas.Consulte Acceso requerido.

Inicia la migración desde el clúster de destino.

1. Haga clic en Select Target Cluster from Projects.

2. Ir al proyecto del clúster de Atlas de destino y localizar el clúster de destino.

3. Haga clic y seleccione Migrate Data to this Cluster en la lista desplegable para iniciar la migración. Se abre la página Migrate Data to This Cluster.

4. Haga clic en Migrate from a Self-Managed MongoDB Database.

   Nota

   La etiqueta de la interfaz de usuario menciona Ops Manager; sin embargo, para este procedimiento, solo puede migrar a clústeres de Atlas que ejecuten MongoDB 6.0 o una versión posterior que Cloud Manager supervise.

   Rellene los campos de la siguiente manera:

   • Seleccione el proyecto fuente en Cloud Manager, si no está ya seleccionado.

   • Selecciona el clúster de origen en el desplegable.

   • Si está migrando un set de réplicas a un clúster:

     • Si desea particionar colecciones, haga clic en la marca de verificación en Include sharding parameters y pegue la configuración JSON de particionado en el cuadro de texto utilizando el ejemplo de particionado. Guarde esta configuración en un archivo externo, en caso de que necesite consultarla más adelante.

       El archivo JSON de configuración de fragmentación define el array shardingEntries, que especifica las colecciones que se fragmentarán y las claves que se utilizarán para la fragmentación. MongoDB fragmenta únicamente las colecciones que se incluyan en este array. Para obtener más información, consulte la sección Fragmentación.

       Si omites especificar la configuración de particionado, podrás particionar las colecciones en el clúster de destino después de migrar el clúster a Atlas.

     • Además de la configuración de particionado, debe existir un índice compatible para las claves de particionado especificadas en el clúster de destino que esté en servicio.

       Haz clic en la marca de verificación en Create supporting indexes para que MongoDB cree automáticamente los índices de soporte de clave de partición en el clúster de destino en Atlas.

   • Selecciona un host de migración para gestionar la migración.

   • Si no estás utilizando un nodo privado, revisa la lista de acceso a direcciones IP y comprueba que la dirección IP externa del host de migración esté incluida en esta lista. Si no está añadido, añádelo ahora:

     • Haga clic Set Network Access for Host

     • Haga clic + Add IP Address

     • Regrese al asistente de migración en vivo. Selecciona el clúster de origen del menú desplegable y elige Migrate data to this cluster en .

   • Selecciona el clúster de origen del menú desplegable.

   • Si el clúster de origen aplica la autenticación, introduce un nombre de usuario y una contraseña en los cuadros de texto proporcionados.

     Consulta Seguridad del clúster de origen para obtener orientación sobre los permisos de usuario necesarios para la migración en vivo de Atlas.

   • Si suspende el clúster de origen de la automatización en Cloud Manager, pero continúa supervisándolo con el Agente de supervisión, se mostrarán Username y Password. Si su implementación requiere autenticación de usuario, proporcione el nombre de usuario y la contraseña en estos campos. El usuario de la base de datos cuyas credenciales proporcione debe tener al menos el rol de copia de seguridad en la base de datos de administración y debe autenticarse mediante SCRAM-SHA-1 y SCRAM-SHA-256.

   • Si el clúster de origen utiliza TLS, active o desactive el botón Is encryption in transit enabled?.

   • Si el clúster de origen utiliza TLS con una Autoridad de Certificación (CA) raíz personalizada, copie la ruta al archivo de CA desde su host de migración y péguela en el cuadro de texto proporcionado. El archivo debe estar presente en el host de migración para garantizar que este pueda leer el certificado. Atlas verifica que el certificado esté presente y sea legible.

   • Si el clúster de destino tiene datos que se quieren preservar, se debe mantener la opción de Clear any existing data on your destination cluster desmarcada. El servicio de migración en vivo revisa una muestra de documentos durante la validación y avisa si encuentra namespaces duplicados. Si se desean borrar los datos existentes, se debe marcar esta opción y luego ingresar el nombre del clúster de destino.

   • Elige una conexión para conectarte al clúster. El Standard connection siempre se muestra como disponible en la interfaz de usuario. Sin embargo, otras opciones de conexión se activar solo si has configurado previamente una conexión de emparejamiento de VPC o un nodo privado para tus clústeres. Si Atlas detecta que no tienes conexiones VPC ni nodos privados configurados, estas opciones aparecen atenuadas.

     • Si no estás usando el emparejamiento VPC o nodos privados, haz clic en Standard connection y continúa con la etapa Validation de este paso.

     • Si configuró una conexión de emparejamiento de VPC entre el host de migración y el conjunto de réplicas de Atlas, la opción VPC Peering estará activa. Haga clic en VPC Peering para conectarse mediante el emparejamiento de VPC para la migración en vivo. Si la opción VPC Peering aparece atenuada, configure una conexión de emparejamiento de VPC antes de iniciar este procedimiento. Para obtener más información, consulte Compatibilidad con el emparejamiento de VPC y los puntos finales privados.

     • Si configuró un punto de conexión privado entre el host de migración y el clúster de Atlas, la opción Private Endpoint estará activa. Haga clic en Private Endpoint para conectarse con un punto de conexión privado y, a continuación, seleccione un punto de conexión privado configurado previamente en el menú desplegable. Solo son válidos los puntos de conexión privados que se encuentren en estado AVAILABLE. Si la opción Private Endpoint aparece atenuada, configure un punto de conexión privado antes de iniciar este procedimiento. Para obtener más información, consulte Compatibilidad con el emparejamiento de VPC y los puntos de conexión privados.

       Nota

       Para las migraciones en vivo push, los nodos privados son compatibles solo con los clústeres implementados en un único proveedor de nube y una sola región.

   • Haz clic en Validate. El proceso de validación verifica que el host de migración sea accesible y realiza las siguientes comprobaciones para garantizar que se pueda iniciar la migración en vivo a Atlas.

     Para aprovechar las siguientes comprobaciones de validación, actualice el agente de MongoDB en Cloud Manager a la última versión. Las siguientes comprobaciones de validación se ejecutan durante la migración en vivo:

     • El host de migración puede conectarse al clúster de destino.

     • Si el clúster de origen utiliza TLS con una Autoridad de Certificación Raíz (CA) personalizada, el host de migración puede acceder al clúster de origen mediante TLS.

     • Las credenciales de usuario de base de datos son válidas. Esta comprobación de validación solo se ejecuta si suspendes el clúster de origen de la automatización en Cloud Manager, pero sigue supervisando el clúster de origen con el Agente de supervisión.

     • El proceso de migración verifica que el clúster de destino tenga suficiente espacio en disco según el tamaño de almacenamiento de los datos comprimidos. Para obtener más información sobre los tamaños de datos y almacenamiento, consulte dbStats.

   • Si la validación falla, compruebe el host de migración, la validez de sus direcciones IP externas o bloque CIDR, y el token de enlace. Compruebe también las credenciales de usuario de la base de datos, sus certificados TLS y la cantidad de espacio de almacenamiento en disco en el clúster de destino.

   • Si la validación tiene éxito, haz clic en Next.

Inicie la migración.

1. Revisa el informe que enumera la organización de origen, el proyecto y el clúster, y el host de migración que utilizará el proceso de migración en vivo.

2. Haga clic en Start the Migration.

   Una vez que comience el proceso de migración, la interfaz de usuario de Atlas muestra la pantalla del recorrido Migrating Data para el clúster de Atlas de destino. La pantalla de guía se actualiza a medida que el clúster de destino avanza en el proceso de migración. El proceso de migración incluye:

   • Aplicar nuevas escrituras a los datos del clúster de origen en los datos del clúster de destino.

   • Copiar los datos del clúster de origen al clúster de destino.

   • Cómo finalizar la migración en el clúster de destino.

   Durante la fase final del proceso de migración, se muestra un valor de tiempo de retardo que representa el retraso actual entre los clústeres de origen y destino.

   Cuando el temporizador de retardo está casi en cero y se ha completado el proceso de migración, Atlas activa el botón Cutover to your destination cluster e indicará que los clústeres de origen y destino están sincronizados. Proceder al siguiente paso.

Realiza el cambio definitivo.

El cambio definitivo es un proceso de tres pasos que dirige las lecturas y las escrituras de la aplicación fuera del clúster de origen hacia el clúster de destino.

Cuando Atlas detecta que los clústeres de origen y destino están casi sincronizados, inicia un temporizador extensible de 120 horas (5 días) para comenzar la etapa de corte del procedimiento de migración en vivo. Después de que pase el período de 120 horas, Atlas deja de sincronizarse con el clúster de origen.

En esta etapa del proceso de migración, puedes proceder al cambio definitivo o ampliar el periodo de sincronización y luego proceder al cambio.

• Si haces clic en I'm ready to cutover, Atlas inicia el proceso de cambio definitivo.

• Si haces clic Extend Sync, y si la sincronización extendida se completa correctamente, Atlas confirma que los clústeres de origen y destino están sincronizados. Continúa con el proceso de cambio. Si el tiempo de sincronización expira, puedes volver a intentar la migración.

  Si su migración está a punto de expirar, Atlas le envía un email similar al siguiente ejemplo:

  A migration to your Atlas cluster will expire in <number> hours!
  Navigate to your destination cluster to start the cutover process. If
  you don't take any action within <number> hours, the migration will be
  cancelled and you will need to start again. You can also extend the
  migration process if you need more time.

1. Se debe hacer clic en I'm ready to cutover. Se debe proceder rápidamente con el proceso de cambio definitivo en tres pasos para asegurar un tiempo de inactividad mínimo para la aplicación.

2. Haz clic en Proceed to cutover. El proceso de cambio definitivo en tres pasos comienza:

   1. Se deben detener las escrituras en el clúster de origen. Se debe hacer clic en I confirm that I've stopped writes to my source cluster. Se debe hacer clic en Finalize migration para continuar.

   2. Espera unos minutos mientras Atlas finaliza la migración. Atlas realiza estas acciones para completar el proceso:

      • Elimina las subredes del servidor de migración en vivo de MongoDB de la lista de acceso IP en el clúster de destino.

      • Remueve el usuario de base de datos que utilizó la migración en vivo para importar datos al clúster de destino.

      Si el proceso de transición ha estado en curso durante al menos 12 horas, Atlas le envía un email sugiriéndole que verifique el proceso de migración o que se ponga en contacto con el soporte técnico.

   3. Si la migración tiene éxito, se muestra la página You have successfully migrated to Atlas. Atlas muestra el estado de los cambios sincronizados, el tiempo de inactividad de la aplicación, la duración del proceso de migración, la cantidad de datos iniciales copiados y el número de colecciones copiadas.

      • Verifique que sus datos se transfieran al clúster de destino comparando el número de documentos y realizando comparaciones de hash. Para obtener más información, consulte Mongosync: Verificar la transferencia de datos.

      • Se debe hacer clic en Connect to your new cluster. Atlas redirecciona a la página Connect to Atlas, donde se puede elegir un método de conexión.

      • Después de la conexión al clúster, se debe reanudar la escritura en el clúster de destino.