Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Migración de Couchbase Server a Couchbase Capella en AWS
*Battulga Purevragchaa y Saurabh Shanbhag, Amazon Web Services*
*Mark Gamble, ninguno*
## Resumen
Couchbase Capella es una base de datos NoSQL como servicio (DBaaS) totalmente gestionada para aplicaciones de misión crítica (por ejemplo, perfiles de usuario o catálogos en línea y gestión de inventario). Couchbase Capella gestiona su carga de trabajo DBaa S en una cuenta de Amazon Web Services (AWS) gestionada por Couchbase. Capella facilita la ejecución y la administración de la replicación de múltiples clústeres, múltiples regiones de AWS, multinube y nube híbrida dentro de una sola interfaz.
Couchbase Capella le ayuda a escalar al instante sus aplicaciones de Couchbase Server, lo que le permite crear clústeres de varios nodos en cuestión de minutos. Couchbase Capella es compatible con todas las características de Couchbase Server, incluidas [SQL\+\+](https://www.couchbase.com/products/n1ql), [Full Text Search](https://www.couchbase.com/products/full-text-search), [Eventing Service](https://docs.couchbase.com/server/current/eventing/eventing-overview.html) y [Analytics Service](https://www.couchbase.com/products/analytics). También elimina la necesidad de gestionar las instalaciones, las actualizaciones, las copias de seguridad y el mantenimiento general de las bases de datos.
Este patrón describe los pasos y las prácticas recomendadas para migrar un entorno de [Couchbase Server](https://www.couchbase.com/products/server) autogestionado a la nube de AWS. El patrón proporciona un proceso repetible para migrar datos e índices desde los clústeres de Couchbase Server, que se ejecutan en las instalaciones o en la nube, a Couchbase Capella. El uso de estos pasos le ayuda a evitar problemas durante la migración y acelera el proceso general de migración.
Este patrón proporciona las dos opciones de migración siguientes:
+ La **opción 1** es adecuada si tiene que migrar menos de 50 índices.
+ La **opción 2** es adecuada si tiene que migrar más de 50 índices.
También puede [configurar datos de muestra](https://docs.couchbase.com/server/current/manage/manage-settings/install-sample-buckets.html) en su Couchbase Server autogestionado para seguir la guía de migración.
Si elije la **opción de migración 2**, o si utiliza ámbitos o colecciones distintos del valor predeterminado, debe utilizar el archivo de configuración de ejemplo, que se encuentra en la sección *Información adicional*.
## Requisitos previos y limitaciones
**Requisitos previos **
+ Una cuenta de pago de Couchbase Capella existente. También puede crear una [cuenta de Couchbase Capella en AWS](https://aws.amazon.com/marketplace/pp/prodview-xrhx5zgue5c26) y utilizar la prueba gratuita de Couchbase Capella y, a continuación, actualizar a una cuenta de pago para configurar el clúster para la migración. Para empezar con la versión de prueba, siga las instrucciones de [Introducción a Couchbase Capella](https://docs.couchbase.com/cloud/get-started/create-account.html).
+ Un entorno de Couchbase Server autogestionado existente, ya sea en las instalaciones o implementado en un proveedor de servicios en la nube.
+ Para la opción de migración 2, Couchbase Shell y un archivo de configuración. Para crear el archivo de configuración, puede usar el archivo de ejemplo que se encuentra en la sección de *Información adicional*.
+ Familiaridad con la administración de Couchbase Server y Couchbase Capella.
+ Familiaridad con la apertura de puertos TCP y la ejecución de comandos en una interfaz de la línea de comandos (CLI).
El proceso de migración también requiere los roles y la experiencia que se describen en la siguiente tabla.
|
|
| Rol | Experiencia | Responsabilidades |
| --- |--- |--- |
| Administrador de Couchbase | Familiaridad con Couchbase Server y Couchbase CapellaEl conocimiento básico de la línea de comandos es útil pero no obligatorio | Couchbase Server y Capella: tareas específicas |
| Administrador de sistemas; administrador de TI | Familiaridad con el entorno y la administración del sistema Couchbase Server autogestionado | Abrir puertos y determinar las direcciones IP en los nodos de clústeres de Couchbase Server autogestionados |
**Limitaciones**
+ Este patrón se utiliza para migrar datos, índices e índices de [búsqueda de texto completo de Couchbase](https://docs.couchbase.com/server/current/fts/full-text-intro.html) desde Couchbase Server a Couchbase Capella en AWS. El patrón no se aplica a la migración de [Couchbase Eventing Service](https://docs.couchbase.com/server/current/eventing/eventing-overview.html) ni a [Couchbase Analytics](https://docs.couchbase.com/server/current/analytics/introduction.html).
+ Couchbase Capella se encuentra disponible en varias regiones de AWS. Para up-to-date obtener información sobre las regiones compatibles con Capella, consulte [Amazon Web Services](https://docs.couchbase.com/cloud/reference/aws.html) en la documentación de Couchbase.
**Versiones de producto**
+ [Couchbase Server (Community o Enterprise) Edition, versión 5.x o posterior](https://docs.couchbase.com/server/current/release-notes/relnotes.html)
## Arquitectura
**Pila de tecnología de origen**
+ Couchbase Server
**Pila de tecnología de destino**
+ Couchbase Capella
**Arquitectura de destino**
1. Para acceder a Couchbase Capella, utilice el **plano de control de Capella**. Puede utilizar el plano de control de Capella para hacer lo siguiente:
+ Controlar y supervisar su cuenta.
+ Gestionar clústeres y datos, índices, usuarios y grupos, permisos de acceso, supervisión y eventos.
1. Se han creado clústeres.
1. El **plano de datos de Capella** se encuentra en la cuenta de AWS gestionada por Couchbase. Tras crear un clúster nuevo, Couchbase Capella lo implementa en varias zonas de disponibilidad de la región de AWS seleccionada.
1. Puede desarrollar e implementar aplicaciones de Couchbase en una VPC de su cuenta de AWS. Normalmente, esta VPC accede al plano de datos de Capella a través del [emparejamiento de VPC](https://docs.couchbase.com/cloud/clouds/private-network.html).
## Tools (Herramientas)
+ La [replicación cruzada de centros de datos (XDCR) de Couchbase](https://docs.couchbase.com/cloud/current/clusters/xdcr/xdcr.html) ayuda a replicar los datos en clústeres ubicados en diferentes proveedores de nube y diferentes centros de datos. Se utiliza para migrar datos a Couchbase Capella desde clústeres de servidores Couchbase autogestionados.
**nota**
XDCR no se puede usar con Couchbase Server Community Edition para migrar a Couchbase Capella. En su lugar, puede utilizar [cbexport](https://docs.couchbase.com/server/current/tools/cbexport.html). Para obtener más información, consulte la épica sobre cómo *migrar datos de Community Edition*.
+ [Couchbase Shell](https://couchbase.sh/docs/) es un intérprete de comandos de línea para que Couchbase Server y Couchbase Capella accedan a clústeres de Couchbase locales y remotos. En este patrón, Couchbase Shell se usa para migrar índices.
+ [cbexport](https://docs.couchbase.com/server/current/tools/cbexport.html) es una utilidad de Couchbase para exportar datos del clúster de Couchbase. Incluido en las [herramientas CLI de Couchbase Server](https://docs.couchbase.com/server/current/cli/cli-intro.html).
## Epics
### Preparativos para la migración
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Evaluar el tamaño del clúster de Couchbase Server autogestionado. | Inicie sesión en la [consola web de Couchbase](https://docs.couchbase.com/server/current/manage/manage-ui/manage-ui.html) para Couchbase Server y evalúe los nodos y los buckets de su clúster autogestionado. [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) Utilizará las configuraciones de clúster de Couchbase Server autogestionadas como guía general para dimensionar y configurar el clúster de destino en Couchbase Capella. Si necesita ayuda con un ejercicio de dimensionamiento más detallado del Couchbase Capella, [póngase en contacto con Couchbase](https://www.couchbase.com/contact). | Administrador de Couchbase |
| Registre la distribución del servicio Couchbase en el clúster de Couchbase Server autogestionado. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase |
| Registre las direcciones IP de los nodos del clúster de Couchbase Server autogestionados. | (Ignore este paso si utiliza Community Edition). Registre la dirección IP de cada nodo del clúster. Se añadirán a la lista de permitidos de su clúster de Couchbase Capella más adelante. | Administrador de Couchbase, administrador de sistemas |
### Implemente y configure los recursos en Couchbase Capella
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Elija una plantilla. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase |
| Elija y configure los nodos. | Elija y configure los nodos para que se adapten a su entorno de clústeres de Couchbase Server autogestionado, incluida la cantidad de nodos, la distribución, el procesamiento o la RAM de los servicios y el almacenamiento. Couchbase Capella utiliza las prácticas recomendadas de [escalado multidimensional](https://docs.couchbase.com/cloud/clusters/scale-cluster.html#scale-a-cluster). Los servicios y los nodos solo se pueden elegir de acuerdo con las prácticas recomendadas de implementación. Esto puede significar que no puede igualar exactamente las configuraciones de su clúster de Couchbase Server autogestionado. | Administrador de Couchbase |
| Implementación del clúster. | El conocimiento básico de la línea de comandos es útil pero no obligatorio Para obtener instrucciones y pasos detallados, consulte [Create a cluster (Crear un clúster)](https://docs.couchbase.com/cloud/clusters/create-cluster.html) en la documentación de Couchbase.Si utiliza la versión de prueba gratuita de Couchbase Capella, debe convertirla en una cuenta de pago antes de comenzar la migración. Para convertir su cuenta, abra la sección **Billing (Facturación)** del plano de control de Couchbase Capella y, a continuación, seleccione **Add Activation ID (Añadir un ID de activación)**. El ID de activación se envía a su dirección de correo electrónico de contacto de facturación después de completar un acuerdo de compra con Couchbase Sales o después de realizar una compra a través de [AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-xrhx5zgue5c26). | Administrador de Couchbase |
| Crear un usuario con credenciales de base de datos. | Un usuario con credenciales de base de datos es específico de un clúster y consta de un nombre de usuario, una contraseña y un conjunto de privilegios de bucket. Este usuario es necesario para crear buckets y acceder a los datos del bucket. En el plano de control de Couchbase Capella, cree una credencial de base de datos para el nuevo clúster siguiendo las instrucciones de [Configure database credentials (Configurar las credenciales de la base de datos)](https://docs.couchbase.com/cloud/clusters/manage-database-users.html) de la documentación de Couchbase Capella.Un usuario de la organización necesita que se le asignen credenciales de rol organizativo si quiere acceder a los datos del bucket en un clúster concreto, ya sea de forma remota o a través de la interfaz de usuario de Couchbase Capella. Esto es independiente de las credenciales de la base de datos, que suelen utilizar las aplicaciones y las integraciones. La creación del usuario organizacional le permite crear y administrar los buckets de destino en su clúster de Couchbase Capella. | Administrador de Couchbase |
| Si utiliza la opción de migración 2, instale Couchbase Shell. | Puede instalar Couchbase Shell en cualquier sistema que tenga acceso de red tanto a su Couchbase Server autogestionado como a los clústeres de Couchbase Capella. Para obtener más información, consulte [Instalar la versión 1.0.0-beta.5 de Couchbase Shell](https://couchbase.sh/docs/#_installation) en la documentación de Couchbase Shell. Confirme que Couchbase Shell esté instalado [probando una conexión a su clúster autogestionado](https://couchbase.sh/docs/#_connecting_to_a_cluster) en un terminal de línea de comandos. | Administrador de Couchbase, administrador de sistemas |
| Permitir direcciones IP. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Para obtener más información sobre las direcciones IP permitidas, consulte [Configurar las direcciones IP permitidas](https://docs.couchbase.com/cloud/get-started/configure-cluster-access.html#allow-ip-address) en la documentación de Couchbase. | Administrador de Couchbase, administrador de sistemas |
| Configuración de los certificados. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase, administrador de sistemas |
| Crear el archivo de configuración para Couchbase Shell. | Cree un archivo dotfile de configuración en el directorio principal de la instalación de Couchbase Shell (por ejemplo, `//.cbsh/config`). Para obtener más información, consulte [Dotfiles de configuración](https://couchbase.sh/docs/#_the_config_dotfiles) en la documentación de Couchbase. Añada las propiedades de conexión de los clústeres de origen y destino al archivo de configuración. Puede usar el archivo de ejemplo de configuración que se encuentra en la sección de *Información adicional* y editar los ajustes de los clústeres. Guarde el archivo de configuración con los ajustes actualizados en la carpeta `.cbsh` (por ejemplo, `//.cbsh/config`). | Administrador de Couchbase, administrador de sistemas |
| Cree buckets de destino. | Para cada bucket de origen, cree un bucket de destino en su clúster de Couchbase Capella siguiendo las instrucciones de la documentación de Couchbase para [crear un bucket](https://docs.couchbase.com/cloud/clusters/data-service/manage-buckets.html#add-bucket). Las configuraciones de los buckets de destino deben coincidir con los nombres de los buckets, los ajustes de memoria y los ajustes de resolución de conflictos de los buckets de su clúster de Couchbase Server autogestionado. | Administrador de Couchbase |
| Crear ámbitos y colecciones. | Cada bucket contiene un ámbito y una colección predeterminados con el espacio de claves `_default._default`. Si utiliza otros espacios de clave para el ámbito y la colección, debe crear espacios de clave idénticos en el clúster de Capella de destino.[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)
| Administrador de Couchbase |
### Migración de los datos de Enterprise Edition
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Abrir los puertos TCP en los nodos del clúster autogestionado de Couchbase Server. | Asegúrese de que los puertos adecuados estén abiertos para la comunicación XDCR en los nodos del clúster de Couchbase Server autogestionado. Para obtener más información, consulte la [documentación sobre puertos de Couchbase Server](https://docs.couchbase.com/server/current/install/install-ports.html#ports-listed-by-communication-path). | Administrador de Couchbase, administrador de sistemas |
| Si utiliza Couchbase Server Enterprise Edition, configure Couchbase XDCR. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase |
| Iniciar Couchbase XDCR. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase |
### Migración de los índices mediante la opción 1
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Migración de los índices de clústeres autogestionados a Couchbase Capella. | Recomendamos este proceso si tiene que migrar menos de 50 índices. Si tiene que migrar más de 50 índices, le recomendamos que utilice la opción de migración 2.[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase, administrador de sistemas |
### Migración de los índices mediante la opción 2
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Migre las definiciones del índice. | Recomendamos este proceso si tiene que migrar más de 50 índices. Si tiene que migrar menos de 50 índices, le recomendamos que utilice la opción de migración 1.[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase, administrador de sistemas |
| Crear las definiciones del índice. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase, administrador de sistemas |
### Migración de índices de búsqueda de texto completo
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Migre los índices de búsqueda de texto completo de clústeres autogestionados a Couchbase Capella. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase |
### Migración de los datos de Couchbase Community Edition
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Exportar datos desde Couchbase Server Community Edition autogestionada. | El XDCR cifrado no está disponible en Couchbase Community Edition. Puede exportar los datos de Couchbase Community Edition y luego importarlos manualmente a Couchbase Capella. Para exportar datos del bucket de origen, utilice `cbexport` en la línea de comandos. Puede ver un ejemplo en el siguiente comando:
Tenga en cuenta que `cbkey`, `cbscope`, `cbcoll` y `cbexported_data.json` son etiquetas arbitrarias. Se hará referencia a ellas más adelante en el proceso, así que si decide asignarles un nombre diferente, anótelo. | Administrador de Couchbase |
| Importar datos a Couchbase Capella. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Para archivos grandes, Couchbase Capella admite la importación por línea de comandos mediante cURL. Puede explorar las opciones de importación con más detalle en [Import data (Importar datos)](https://docs.couchbase.com/cloud/clusters/data-service/import-data-documents.html) en la documentación de Couchbase Capella. | Administrador de Couchbase |
### Probar y verificar la migración
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Comprobación de la migración de datos. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase |
| Verificar la migración del índice. | En el plano de control de Couchbase Capella, en la lista desplegable **Tools (Herramientas)** del clúster de destino, seleccione **Indexes (Índices)**. Compruebe que los índices se hayan migrado y creado. | Administrador de Couchbase |
| Verificar los resultados de consulta. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase |
| Verificar los resultados de la búsqueda de texto completo (aplicable si migró los índices FTS). | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador de Couchbase |
## Recursos relacionados
**Preparativos para la migración**
+ [Comience con la prueba gratuita de Couchbase Capella](https://cloud.couchbase.com/sign-up)
+ [Requisitos de proveedor de servicios en la nube para Couchbase Capella](https://docs.couchbase.com/cloud/reference/aws.html)
+ [Pautas de tamaños de Couchbase Capella](https://docs.couchbase.com/cloud/clusters/sizing.html)
**Migración de datos e índices**
+ [Couchbase XDCR](https://docs.couchbase.com/cloud/clusters/xdcr/xdcr.html)
+ [Documentación de Couchbase Shell](https://couchbase.sh/docs/)
**Couchbase, Capella y su soporte SLAs **
+ Acuerdos de nivel de servicio de [Couchbase Capella](https://www.couchbase.com/capellasla) () SLAs
+ [Política de soporte del servicio Couchbase Capella](https://www.couchbase.com/support-policy/cloud)
## Información adicional
El siguiente código es un ejemplo de [archivo de configuración para Couchbase Shelll](https://couchbase.sh/docs/#_the_config_dotfiles).
```
Version = 1
[[clusters]]
identifier = "On-Prem-Cluster"
hostnames = [""]
default-bucket = "travel-sample"
username = ""
password = ""
tls-cert-path = "/"
data-timeout = "2500ms"
connect-timeout = "7500ms"
query-timeout = "75s"
[[clusters]]
identifier = "Capella-Cluster"
hostnames = [""]
default-bucket = "travel-sample"
username = ""
password = ""
tls-cert-path = "/"
data-timeout = "2500ms"
connect-timeout = "7500ms"
query-timeout = "75s"
```
Antes de guardar el archivo de configuración, utilice la siguiente tabla para asegurarse de haber agregado su propia información de clúster de origen y destino.
| | |
| --- |--- |
| | Use las direcciones IP para su clúster de Couchbase Server autogestionado. |
| | Use el usuario administrador para su clúster de Couchbase Server autogestionado. |
| | Use la ruta absoluta al archivo de certificado raíz guardado para su clúster de Couchbase Server autogestionado. |
| | Use el punto de conexión de su clúster de Couchbase Capella. |
| | Use el usuario de la base de datos para su clúster de Couchbase Capella. |
| | Use la contraseña de usuario de la base de datos para su clúster de Couchbase Capella. |
| | Use la ruta absoluta al archivo de certificado raíz guardado para su clúster de Couchbase Capella. |