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

En Atlas, vaya a Migration Hub para 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.

Se muestra el Centro de migración.

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, crea un clúster de destino en Atlas. Consulta 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 se desea particionar colecciones, se debe hacer clic en la marca de verificación en Include sharding parameters y se debe pegar la configuración JSON de particionado en el cuadro de texto usando el ejemplo de particionado. Se debe guardar esta configuración en un archivo externo, en caso de que se desee consultarla más adelante.

       La configuración de particionado JSON define el arreglo shardingEntries, que especifica las colecciones a particionar y las claves que se usarán para el particionado. MongoDB particiona únicamente las colecciones que incluyas en este arreglo. Para aprender más, consulta Particionado.

       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 se suspende el clúster de origen de la automatización en Cloud Manager, pero se continúa supervisando el clúster de origen con el agente de supervisión, se mostrará Username y Password. Si la implementación requiere autenticación de usuario, se debe proporcionar el nombre de usuario y la contraseña en estos campos. El usuario de base de datos cuyas credenciales se proporcionen debe tener al menos el rol de copia de seguridad en la base de datos admin y debe estar autenticado utilizando tanto SCRAM-SHA-1 como SCRAM-SHA-256.

   • Si el clúster de origen utiliza TLS/SSL, activa o desactiva el botón Is encryption in transit enabled?.

   • Si el clúster de origen utiliza TLS/SSL con una Autoridad de Certificación Raíz (CA) personalizada, copia la ruta al archivo CA desde el host de migración y pega esta ruta en el cuadro de texto proporcionado. El archivo debe estar presente en el host de migración para asegurar que el host de migración pueda leer el certificado. Atlas comprueba 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 has configurado una conexión de emparejamiento de VPC entre el host de migración y el set de réplicas de Atlas, la opción VPC Peering está activa. Haz clic en VPC Peering para conectarte mediante el emparejamiento de VPC para la migración en vivo. Si la opción VPC Peering está atenuada, configura una conexión de emparejamiento de VPC antes de comenzar este procedimiento. Para aprender más, consulta Soporte para emparejamiento de VPC y nodos privados.

     • Si configuraste un nodo privado entre el host de migración y el clúster de Atlas, la opción Private Endpoint está activa. Haz clic en Private Endpoint para conectarte con un nodo privado y, a continuación, selecciona un nodo privado previamente configurado en el menú desplegable. Solo los nodos privados que están en el estado AVAILABLE son válidos. Si la opción Private Endpoint está desactivada, configura un nodo privado antes de iniciar este procedimiento. Para aprender más, consulta Soporte para el emparejamiento de VPC y los nodos 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, actualiza el MongoDB Agent 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/SSL con una Autoridad de Certificación Raíz (CA) personalizada, el host de migración puede acceder al clúster de origen utilizando TLS/SSL.

     • 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 valida que el clúster de destino dispone de 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, consulta dbStats.

   • Si la validación falla, verifica el host de migración, la validez de tus direcciones IP externas o el bloque CIDR, y el link-token. También comprueba las credenciales del usuario de base de datos, tus certificados TLS/SSL y la cantidad 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.

      • Verifica que tus 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, consulta Mongosync: Verificar 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.