Configurar recursos para la migración

En esta página se describe la parte de preparación del proceso de migración, en la que se configuran los recursos para la migración.

En esta fase, debes hacer lo siguiente:

  1. Instala las herramientas de línea de comandos necesarias para ejecutar comandos en fases posteriores del proceso de migración.
  2. Configura la base de datos de Firestore con compatibilidad con MongoDB.
  3. (Opcional) Ajusta la configuración del registro de operaciones (oplog) en tu fuente compatible con MongoDB.
  4. Crea un segmento de Cloud Storage para almacenar datos intermedios.

Configurar permisos de gestión de identidades y accesos

Su cuenta requiere los roles de gestión de identidades y accesos adecuados en todos los servicios utilizados en el proceso de migración:

Instalar herramientas de línea de comandos

El procedimiento de migración usa la CLI de gcloud para configurar y activar los pasos de la migración. Si es necesario, instala gcloud CLI siguiendo las instrucciones de la página Instalar gcloud CLI.

Configuración específica de la fuente

MongoDB en Compute Engine

Una base de datos de MongoDB que se ejecuta en máquinas virtuales de Compute Engine en un clúster autogestionado no suele estar expuesta a la red pública de Internet. El procedimiento de migración usará Private Service Connect en Datastream para conectar la canalización de Datastream a tu base de datos de origen.

Sigue estos pasos:

  1. Para configurar la conectividad privada de Datastream, sigue las instrucciones que se indican en el artículo Crear una configuración de conectividad privada.

  2. Anota el parámetro Configuration ID de la configuración creada. Lo usarás en fases posteriores para configurar las variables de entorno necesarias.

Azure Cosmos DB

Asegúrate de que la CLI de Azure está instalada en tu ordenador.

Amazon DocumentDB

No se puede acceder directamente a los clústeres de Amazon DocumentDB desde fuera de la red de Amazon VPC. Para conectarte a un clúster de DocumentDB, tendrás que aprovisionar una instancia de EC2 en la red de Amazon VPC y usarla como host bastion para un túnel SSH.

Consulta la guía para desarrolladores sobre cómo conectarse a un clúster de Amazon DocumentDB desde fuera de una VPC de Amazon para obtener instrucciones sobre cómo configurar una instancia de EC2 para la conectividad externa a DocumentDB.

Para establecer una conexión con el clúster de DocumentDB, tendrás que obtener la clave SSH privada de la instancia EC2, así como el paquete de certificados adecuado para la región en la que se haya implementado el clúster. Visita la página de recursos Paquetes de certificados por región de AWS para descargar el paquete adecuado en formato PEM.

Ten en cuenta que el paquete de certificados contiene varios certificados. Tienes que extraer un solo certificado para configurar una conexión de Datastream. Te recomendamos que valides la conectividad de DocumentDB manualmente para asegurarte de que tienes una clave SSH y un certificado de DocumentDB válidos del paquete regional. En la guía para desarrolladores de DocumentDB se proporcionan ejemplos de líneas de comandos para establecer una conexión directa desde fuera de la VPC.

Configurar una base de datos de destino de Firestore con compatibilidad con MongoDB

  1. Asegúrate de que tu proyecto tenga una base de datos de Firestore con compatibilidad con MongoDB a la que migrarás los datos de tu base de datos de MongoDB de origen. Para obtener más información sobre cómo crear una base de datos, consulta Crear y gestionar bases de datos.

  2. Para llevar a cabo esta migración, te recomendamos que crees un nombre de usuario y una contraseña para la base de datos de Firestore con compatibilidad con MongoDB y que los uses con el protocolo de autenticación SCRAM-SHA-256. Este nombre de usuario se puede eliminar de forma segura una vez que se haya completado la migración. También puedes seguir usando estas credenciales para conectar tus clientes de MongoDB a tu nueva base de datos de Firestore con compatibilidad con MongoDB.

Usarás el nombre de esta base de datos de Firestore con compatibilidad con MongoDB y las credenciales de usuario en pasos posteriores.

Ajustar el tamaño de la ventana oplog de la base de datos de origen

Te recomendamos que ajustes la ventana oplog de tu base de datos de origen de MongoDB a 3 días de tráfico de escritura total en esta base de datos. Si la tasa de tráfico de escritura supera la tasa a la que Datastream puede consumir los cambios de tu base de datos, este ajuste evitará la pérdida de datos.

Es posible que tengas que ajustar aún más el valor en función del patrón del tráfico y del volumen de tráfico máximo. Por ejemplo, si se escribe el tráfico de una semana en un breve periodo, es posible que Datastream no capture los cambios del oplog lo suficientemente rápido antes de que los cambios queden fuera de la ventana del oplog. En este caso, es posible que tengas que cambiar el tamaño de la ventana oplog a 7 días de tráfico de escritura total.

Crea un segmento de Cloud Storage

Crea un segmento de Cloud Storage de la siguiente forma:

  1. Elige una región de Cloud Storage en la que se ejecutará la pipeline de migración. Te recomendamos que uses la región en la que se encuentre tu base de datos de destino de Firestore con compatibilidad con MongoDB.

  2. Elige el nombre de este segmento. Ejemplo: mongo-migration-bucket Usarás este nombre en pasos posteriores.

  3. Crea un segmento de Cloud Storage con el nombre y la región que elijas siguiendo las instrucciones de la página Crear un segmento de la documentación de Cloud Storage.

Siguientes pasos

Vaya a Configurar variables de entorno.