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
Creado por Battulga Purevragchaa (AWS), Mark Gamble y Saurabh Shanbhag (AWS)
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++
Este patrón describe los pasos y las prácticas recomendadas para migrar un entorno de Couchbase Server
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
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
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 . 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 |
|
|
Administrador de sistemas; administrador de TI |
|
|
Limitaciones
Este patrón se utiliza para migrar datos, índices e índices de búsqueda de texto completo de Couchbase
desde Couchbase Server a Couchbase Capella en AWS. El patrón no se aplica a la migración de Couchbase Eventing Service ni a Couchbase Analytics . 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
en la documentación de Couchbase.
Versiones de producto
Arquitectura
Pila de tecnología de origen
Couchbase Server
Pila de tecnología de destino
Couchbase Capella
Arquitectura de destino

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.
Se han creado clústeres.
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.
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
.
Herramientas
La replicación cruzada de centros de datos (XDCR) de Couchbase
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
. Para obtener más información, consulte la épica sobre cómo migrar datos de Community Edition. Couchbase Shell
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
es una utilidad de Couchbase para exportar datos del clúster de Couchbase. Incluido en las herramientas CLI de Couchbase Server .
Epics
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
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 | Administrador de Couchbase |
Registre la distribución del servicio Couchbase en el clúster de Couchbase Server autogestionado. |
| 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 |
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Elija una plantilla. |
| 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 | 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) importanteSi está utilizando 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 | 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) notaUn usuario de la organización necesita que se le asignen credenciales de rol organizacional si quiere acceder a los datos del bucket en un clúster en particular, 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 Confirme que Couchbase Shell esté instalado probando una conexión a su clúster autogestionado | Administrador de Couchbase, administrador de sistemas |
Permitir direcciones IP. |
Para obtener más información sobre las direcciones IP permitidas, consulte Configurar las direcciones IP permitidas | Administrador de Couchbase, administrador de sistemas |
Configuración de los certificados. |
| 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, 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 | 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 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
| Administrador de Couchbase |
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 | Administrador de Couchbase, administrador de sistemas |
Si utiliza Couchbase Server Enterprise Edition, configure Couchbase XDCR. |
| Administrador de Couchbase |
Iniciar Couchbase XDCR. |
| Administrador de Couchbase |
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Migración de los índices de clústeres autogestionados a Couchbase Capella. | importanteRecomendamos 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.
| Administrador de Couchbase, administrador de sistemas |
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Migre las definiciones del índice. | importanteRecomendamos 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.
| Administrador de Couchbase, administrador de sistemas |
Crear las definiciones del índice. |
| Administrador de Couchbase, administrador de sistemas |
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Migre los índices de búsqueda de texto completo de clústeres autogestionados a Couchbase Capella. |
| Administrador de Couchbase |
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 Puede ver un ejemplo en el siguiente comando:
Tenga en cuenta que | Administrador de Couchbase |
Importar datos a Couchbase Capella. |
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) | Administrador de Couchbase |
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Comprobación de la migración de datos. |
| 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. |
| Administrador de Couchbase |
Verificar los resultados de la búsqueda de texto completo (aplicable si migró los índices FTS). |
| Administrador de Couchbase |
Recursos relacionados
Preparativos para la migración
Migración de datos e índices
Couchbase, Capella y soporte SLAs
Acuerdos de nivel de servicio de Couchbase Capella
() SLAs
Información adicional
El siguiente código es un ejemplo de archivo de configuración para Couchbase Shelll
Version = 1
[[clusters]]
identifier = "On-Prem-Cluster"
hostnames = ["<SELF_MANAGED_COUCHBASE_CLUSTER>"]
default-bucket = "travel-sample"
username = "<SELF_MANAGED_ADMIN>"
password = "<SELF_MANAGED_ADMIN_PWD>"
tls-cert-path = "/<ABSOLUTE_PATH_TO_SELF_MANAGED_ROOT_CERT>"
data-timeout = "2500ms"
connect-timeout = "7500ms"
query-timeout = "75s"
[[clusters]]
identifier = "Capella-Cluster"
hostnames = ["<COUCHBASE_CAPELLA_ENDPOINT>"]
default-bucket = "travel-sample"
username = "<CAPELLA_DATABASE_USER>"
password = "<CAPELLA_DATABASE_USER_PWD>"
tls-cert-path = "/<ABSOLUTE_PATH_TO_COUCHBASE_CAPELLA_ROOT_CERT>"
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.
<SELF_MANAGED_COUCHBASE_CLUSTER> | Use las direcciones IP para su clúster de Couchbase Server autogestionado. |
<SELF_MANAGED_ADMIN> | Use el usuario administrador para su clúster de Couchbase Server autogestionado. |
<ABSOLUTE_PATH_TO_SELF_MANAGED_ROOT_CERT> | Use la ruta absoluta al archivo de certificado raíz guardado para su clúster de Couchbase Server autogestionado. |
<COUCHBASE_CAPELLA_ENDPOINT> | Use el punto de conexión de su clúster de Couchbase Capella. |
<CAPELLA_DATABASE_USER> | Use el usuario de la base de datos para su clúster de Couchbase Capella. |
<CAPELLA_DATABASE_USER_PWD> | Use la contraseña de usuario de la base de datos para su clúster de Couchbase Capella. |
<ABSOLUTE_PATH_TO_COUCHBASE_CAPELLA_ROOT_CERT> | Use la ruta absoluta al archivo de certificado raíz guardado para su clúster de Couchbase Capella. |