{"id":16496,"date":"2024-10-25T11:03:09","date_gmt":"2024-10-25T18:03:09","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=16496"},"modified":"2025-06-13T22:04:18","modified_gmt":"2025-06-14T05:04:18","slug":"migrate-mongodb-atlas-to-couchbase","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/migrate-mongodb-atlas-to-couchbase\/","title":{"rendered":"C\u00f3mo migrar aplicaciones MongoDB Device Sync (Realm) a Couchbase Capella App Services"},"content":{"rendered":"

La comunidad de promotores ha expresado su preocupaci\u00f3n por <\/span>Anuncio de eliminaci\u00f3n de MongoDB Atlas<\/span><\/a> de sus capacidades edge y m\u00f3viles. En una <\/span>Correo electr\u00f3nico:<\/span><\/a>...exploramos por qu\u00e9 Couchbase Mobile es una fuerte alternativa para soportar tus requerimientos de sincronizaci\u00f3n de datos offline-first.<\/span><\/p>\n

En este post, vamos a ofrecer una visi\u00f3n t\u00e9cnica de lo que es una migraci\u00f3n t\u00edpica de MongoDB Atlas Device Sync a Couchbase. Aunque nos centraremos en <\/span>Capella<\/span><\/a>Si bien la soluci\u00f3n DBaaS es totalmente gestionada, los conceptos tratados se aplicar\u00e1n igualmente a las implantaciones autogestionadas de <\/span>Servidor Couchbase<\/span><\/a> y <\/span>Couchbase M\u00f3vil<\/span><\/a>.<\/span><\/p>\n

Consideraciones sobre la migraci\u00f3n<\/h2>\n

Al planificar la migraci\u00f3n de su aplicaci\u00f3n MongoDB Device Sync (Realm) a Capella App Services, es importante adoptar un enfoque hol\u00edstico, teniendo en cuenta tanto los componentes del lado del servidor en la nube como los aspectos de la aplicaci\u00f3n m\u00f3vil.<\/span><\/p>\n

NOTA<\/b>: <\/span>Los puntos enumerados a continuaci\u00f3n no pretenden ser prescriptivos, sino que representan consideraciones comunes.<\/b> Cada aplicaci\u00f3n es \u00fanica, por lo que el proceso de migraci\u00f3n debe personalizarse para satisfacer los requisitos espec\u00edficos de la aplicaci\u00f3n.\u00a0<\/b><\/p>\n

Puede empezar por <\/span>Nivel gratuito de Couchbase Capella<\/span><\/a>que incluye Capella App Services, nuestra soluci\u00f3n alojada de sincronizaci\u00f3n de datos. Una vez que haya validado su migraci\u00f3n y est\u00e9 listo para el despliegue de producci\u00f3n, puede actualizar a una de las siguientes opciones <\/span>nuestros niveles de pago<\/span><\/a>.<\/span><\/p>\n

\"\"<\/p>\n

1. Modelizaci\u00f3n de datos<\/h3>\n

Tanto MongoDB como Couchbase son bases de datos documentales y almacenan datos en formato JSON. Sin embargo, MongoDB representa documentos JSON en formato codificado binario llamado BSON utilizando<\/span> especificaci\u00f3n JSON ampliada<\/span><\/a>. As\u00ed que aunque Couchbase puede trabajar con documentos en formato JSON extendido como ver\u00e1s m\u00e1s adelante, ser\u00e1 m\u00e1s sencillo trabajar con documentos JSON normales.\u00a0<\/span><\/p>\n

Aproveche esta oportunidad para determinar el modelo de datos adecuado para su aplicaci\u00f3n migrada y c\u00f3mo puede organizarlo con <\/span>cubos<\/span><\/a>, <\/span>\u00e1mbitos y colecciones<\/span><\/a>. Por ejemplo, puedes decidir omitir o renombrar propiedades, lo que es bastante trivial de hacer con Couchbase <\/span>Funciones del Servicio de Eventos<\/span><\/a>.\u00a0<\/span><\/p>\n

2. Configurar el cluster Capella<\/h3>\n

Despliegue <\/span>su cl\u00faster Capella<\/span><\/a> y configurarlo seg\u00fan las necesidades de su aplicaci\u00f3n. La configuraci\u00f3n incluir\u00eda, como m\u00ednimo, la instalaci\u00f3n de los servicios pertinentes, como la consulta, la b\u00fasqueda, etc., la configuraci\u00f3n de las credenciales de acceso al cl\u00faster y la creaci\u00f3n de una base de datos. <\/span>configuraci\u00f3n de una lista de direcciones IP permitidas<\/span><\/a>. La configuraci\u00f3n de una direcci\u00f3n IP permitida suele ser necesaria \u00fanicamente con fines de prueba o evaluaci\u00f3n. En un entorno de producci\u00f3n, es probable que configure el acceso al cl\u00faster a trav\u00e9s de redes privadas, tales como <\/span>VPC Peering<\/span><\/a> o <\/span>Enlaces privados<\/span><\/a>.\u00a0<\/span><\/p>\n

3. Migraci\u00f3n de datos<\/h3>\n

Para migrar datos de un cl\u00faster MongoDB Atlas a un cl\u00faster Capella, tiene varias opciones. Tu elecci\u00f3n depender\u00e1 de si vas a realizar una migraci\u00f3n de datos \u00fanica y offline o si vas a optar por una migraci\u00f3n de datos online m\u00e1s compleja. La migraci\u00f3n de datos en l\u00ednea suele requerir la sincronizaci\u00f3n bidireccional de datos entre los cl\u00fasteres MongoDB Atlas y Couchbase Capella, especialmente si ambos est\u00e1n sirviendo activamente aplicaciones durante la transici\u00f3n.<\/span><\/p>\n

He aqu\u00ed algunas opciones habituales:<\/span><\/p>\n

Utilizar utilidades de exportaci\u00f3n\/importaci\u00f3n - <\/strong>Exportar<\/span><\/a> sus colecciones de MongoDB e imp\u00f3rtelas en Capella utilizando la funci\u00f3n <\/span>cbimport<\/span><\/a> herramienta. Si sus datos est\u00e1n en formato JSON extendido, tendr\u00e1 que realizar la transformaci\u00f3n de datos utilizando <\/span>Funciones del servicio de eventos<\/span><\/a> durante el proceso de importaci\u00f3n. Incluso si los datos est\u00e1n en JSON, puede que necesite ejecutar una transformaci\u00f3n de datos si su modelo de datos de destino no es id\u00e9ntico al de origen. Este enfoque es ideal para una migraci\u00f3n de datos \u00fanica.<\/span><\/p>\n

Utilizar herramientas empresariales de migraci\u00f3n de datos - <\/strong>Aproveche herramientas empresariales como <\/span>GlueSync de MOLO7 para Couchbase<\/span><\/a> para migrar datos. Una herramienta como GlueSync ofrece un soporte s\u00f3lido y escalable para las migraciones de datos, incluidas las migraciones en caliente y en fr\u00edo. Eche un vistazo a <\/span>v\u00eddeo<\/span><\/a> para una visi\u00f3n general de sus capacidades y de c\u00f3mo puede ayudar en la migraci\u00f3n.<\/span><\/p>\n

Herramientas de c\u00f3digo abierto - <\/strong>Puede probar nuestra utilidad Couchbase de c\u00f3digo abierto respaldada por la comunidad, <\/span>cbmigrate<\/span><\/a>para migrar los datos. Esto funciona bien para migraciones de datos sencillas. La herramienta est\u00e1 integrada en extensiones populares de Couchbase IDE para <\/span>VSCode<\/span><\/a> y <\/span>JetBrains<\/span><\/a>. As\u00ed que si eres un desarrollador que est\u00e1 construyendo aplicaciones utilizando estos IDEs, entonces deber\u00edas considerar esta opci\u00f3n.\u00a0<\/span><\/p>\n

Una vez migrados los datos, es posible que tenga que <\/span>crear \u00edndices adecuados <\/span><\/a>en su cluster Capella.<\/span><\/p>\n

4. Configurar Capella App Services<\/h3>\n

Servicios de aplicaciones<\/span><\/a> es el servicio backend gestionado responsable de la sincronizaci\u00f3n de datos offline-first. Despu\u00e9s de configurar el cl\u00faster, tendr\u00e1 que desplegar App Services para conectarlo al cl\u00faster configurado. La configuraci\u00f3n de App Services variar\u00e1 significativamente en funci\u00f3n de los requisitos espec\u00edficos de su aplicaci\u00f3n.<\/span><\/p>\n

T\u00f3mese su tiempo para evaluar los requisitos de su aplicaci\u00f3n y asegurarse de que est\u00e1 configurada correctamente.\u00a0<\/span><\/p>\n

No existe ninguna herramienta de migraci\u00f3n autom\u00e1tica para este paso. Pero lo tenemos cubierto. Consulte la <\/span>gu\u00eda de iniciaci\u00f3n sencilla<\/span><\/a>que cubre aspectos importantes de la configuraci\u00f3n utilizando un conjunto de datos de ejemplo. Esta gu\u00eda le ayudar\u00e1 a familiarizarse con los conceptos b\u00e1sicos y podr\u00e1 adaptarla a su aplicaci\u00f3n.<\/span><\/p>\n

\"\"<\/p>\n

Despliegue de puntos finales de aplicaciones\u00a0<\/span><\/h4>\n

En <\/span>Punto final de la aplicaci\u00f3n<\/span><\/a> es una representaci\u00f3n de su aplicaci\u00f3n dentro de Capella App Services. Representa el punto final con el que su aplicaci\u00f3n m\u00f3vil sincronizar\u00e1 los datos. Debe configurar al menos un App Endpoint en su cluster de App Services. Cada App Endpoint est\u00e1 asociado con un bucket, un \u00e1mbito y un subconjunto \u00fanico de colecciones dentro de ese \u00e1mbito.<\/span><\/p>\n

Configurar los puntos finales de la aplicaci\u00f3n\u00a0<\/span><\/h4>\n

Configurar el mecanismo de autenticaci\u00f3n - <\/b>Por defecto, todos los puntos finales de la aplicaci\u00f3n est\u00e1n protegidos mediante la autenticaci\u00f3n b\u00e1sica. Tiene la opci\u00f3n de configurar mecanismos avanzados de autenticaci\u00f3n<\/a>.<\/p>\n

Configurar usuarios (y funciones) de la aplicaci\u00f3n m\u00f3vil -\u00a0<\/b>Configurar uno o varios <\/span>usuarios de la aplicaci\u00f3n<\/span><\/a> y opcionalmente roles. Estos son los usuarios autenticados para sincronizar datos con App Services. En una aplicaci\u00f3n de producci\u00f3n, es probable que utilice <\/span>API REST de administraci\u00f3n<\/span><\/a> para configurar usuarios, o utilice las funciones de registro autom\u00e1tico de usuarios si ha configurado <\/span>Open ID Connect (OIDC) para autenticaci\u00f3n<\/span><\/a>.<\/span><\/p>\n

Configurar el control de acceso -\u00a0<\/b>Este es uno de los elementos m\u00e1s cruciales de la configuraci\u00f3n del App Endpoint. Aqu\u00ed se define el nivel de acceso del usuario (lectura\/escritura) especificando una funci\u00f3n JavaScript. El control de acceso es posible gracias a un concepto \u00fanico y potente conocido como \"<\/span>canales<\/span><\/a>.\" Por defecto, todos los documentos de una colecci\u00f3n se asocian a un canal que comparte el mismo nombre que la colecci\u00f3n. Como resultado, un usuario al que se le concede acceso a un canal con el nombre de la colecci\u00f3n obtiene autom\u00e1ticamente acceso de lectura a todos los documentos de esa colecci\u00f3n. Consulte nuestra <\/span>docs<\/span><\/a> para saber m\u00e1s sobre Control de acceso y Validaci\u00f3n.<\/span><\/p>\n

Una vez que haya configurado su App Endpoint, estar\u00e1 listo para <\/span>conectarse<\/span><\/a> y sincroniza los datos de tu aplicaci\u00f3n habilitada para Couchbase Lite.<\/span><\/p>\n

5. Migre su aplicaci\u00f3n Realm<\/h3>\n

Ahora que su backend est\u00e1 configurado, es hora de migrar su aplicaci\u00f3n Realm SDK a <\/span>Couchbase Lite<\/span><\/a>. Realm es una base de datos orientada a objetos, mientras que MongoDB es un almac\u00e9n de documentos JSON, que requiere transformar documentos BSON en objetos Realm. En cambio, Couchbase Lite es un almac\u00e9n de documentos JSON embebido con todas las funciones que elimina la necesidad de transformaci\u00f3n.<\/span><\/p>\n

Migrar tu aplicaci\u00f3n Realm implicar\u00e1 reescribir la capa de modelo de tu aplicaci\u00f3n (o Data Access Layer) para utilizar el SDK de Couchbase Lite en el lenguaje correspondiente.<\/span><\/p>\n

Consulte nuestro <\/span>gu\u00eda comparativa<\/span><\/a> que compara MongoDB Device Sync SDK con Couchbase Lite. Aqu\u00ed hay algunas gu\u00edas espec\u00edficas del idioma:<\/span><\/p>\n