Configura recursos para la migración

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

En esta etapa, harás lo siguiente:

  1. Instala las herramientas de línea de comandos necesarias para ejecutar comandos en etapas 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 bucket de Cloud Storage para el almacenamiento de datos intermedio.

Configura los permisos de IAM

Tu cuenta requiere los roles de IAM adecuados en todos los servicios que se usan en el proceso de migración:

Instala herramientas de línea de comandos

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

Configuración específica de la fuente

MongoDB en Compute Engine

Por lo general, una base de datos de MongoDB que se ejecuta en VMs de Compute Engine en un clúster autoadministrado no se expone a la Internet pública. 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.

Haz lo siguiente:

  1. Configura la conectividad privada de Datastream siguiendo las instrucciones que se describen en Crea una configuración de conectividad privada.

  2. Ten en cuenta el parámetro Configuration ID de la configuración creada. La usarás en etapas posteriores para configurar las variables de entorno requeridas.

Azure Cosmos DB

Asegúrate de que la CLI de Azure esté instalada en tu computadora.

Amazon DocumentDB

No se puede acceder directamente a los clústeres de Amazon DocumentDB desde fuera de la red de VPC de Amazon. Para conectarte a un clúster de DocumentDB, deberás aprovisionar una instancia de EC2 dentro de la red de Amazon VPC y usar esa instancia como un host de bastión para un túnel SSH.

Visita la guía para desarrolladores 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, deberás obtener la clave SSH privada para la instancia de EC2, así como el paquete de certificados adecuado para la región en la que se implementa tu clúster. Visita la página de recursos de 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. Debes extraer un solo certificado para configurar una conexión de Datastream. Se recomienda que valides la conectividad de DocumentDB de forma manual para asegurarte de tener una clave SSH y un certificado de DocumentDB válidos del paquete regional. La guía para desarrolladores de DocumentDB proporciona ejemplos de líneas de comandos para establecer una conexión directa desde fuera de la VPC.

Configura 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 origen de MongoDB. Para obtener más información sobre cómo crear una base de datos, consulta Crea y administra bases de datos.

  2. Para los fines de 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 que se usará con el protocolo de autenticación SCRAM-SHA-256. Este nombre de usuario se puede borrar de forma segura después de que se complete la migración, o bien 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 del usuario en pasos posteriores.

Ajusta el tamaño de la ventana del oplog de la base de datos de origen

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

Es posible que el valor deba ajustarse aún más, según el patrón del tráfico y el volumen del tráfico máximo. Por ejemplo, si el tráfico de una semana se escribe en un período breve, es posible que Datastream no capture los cambios del oplog con la suficiente rapidez antes de que los cambios salgan de la ventana del oplog. En este caso, es posible que debas cambiar el tamaño de la ventana del oplog para que abarque 7 días de tráfico de escritura total.

Cree un bucket de Cloud Storage

Crea un bucket de Cloud Storage nuevo de la siguiente manera:

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

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

  3. Crea un bucket de Cloud Storage nuevo con el nombre y la región elegidos siguiendo las instrucciones que se proporcionan en la página Crea un bucket de la documentación de Cloud Storage.

¿Qué sigue?

Continúa con Configura las variables de entorno.