{"id":13159,"date":"2022-04-29T08:13:05","date_gmt":"2022-04-29T15:13:05","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=13159"},"modified":"2025-06-13T20:45:49","modified_gmt":"2025-06-14T03:45:49","slug":"simplify-schema-migration-kubernetes-couchbase","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/simplify-schema-migration-kubernetes-couchbase\/","title":{"rendered":"Simplificaci\u00f3n de la migraci\u00f3n de esquemas en implementaciones de Couchbase nativas de la nube"},"content":{"rendered":"

El operador aut\u00f3nomo Couchbase<\/b> es un operador de Kubernetes que proporciona integraci\u00f3n nativa en la nube con Kubernetes de c\u00f3digo abierto y Red Hat Openshift. Permite a un usuario utilizar la funcionalidad declarativa de Kubernetes para definir lo que ser\u00e1 el cl\u00faster de Couchbase Server y gestionar los atributos de ese cl\u00faster. Esta funcionalidad declarativa es \u00fatil ya que permite almacenar las definiciones del entorno en el control de c\u00f3digo fuente.<\/span><\/p>\n

El objetivo del operador es gestionar completamente uno o m\u00e1s despliegues de Couchbase Server. Gestiona el ciclo de vida del cluster (aprovisionamiento, escalado, actualizaci\u00f3n, auto-recuperaci\u00f3n) y la configuraci\u00f3n (vol\u00famenes persistentes, grupos de servidores, XDCR, TLS, RBAC, backup\/restore). El operador es una potente herramienta en la gesti\u00f3n de un entorno Couchbase a gran escala y es muy recomendable que leas el documento <\/span>Documentaci\u00f3n del operador de Couchbase<\/span><\/a>.<\/span><\/p>\n

\"Cloud-native<\/p>\n

Guardar y restaurar: C\u00f3mo migrar una topolog\u00eda no gestionada<\/span><\/h2>\n

A\u00f1adimos el <\/span>Guardar y<\/span><\/i> Restaurar <\/span><\/i>Caracter\u00edstica en Couchbase Autonomous Operator v2.3. Esta caracter\u00edstica permite a los usuarios migrar un <\/span>no gestionado<\/span><\/i> Couchbase Cluster y convertirlo en un <\/span>gestionado <\/span><\/i>cluster. Esta funcionalidad permite sondear un cluster Couchbase creado por el operador aut\u00f3nomo con topolog\u00eda de datos no gestionada y recuperar un archivo YAML de topolog\u00eda de datos que coincida con la topolog\u00eda de datos actual de ese cluster Couchbase. Un usuario puede tomar este archivo YAML de despliegue y aplicarlo al cluster existente para bloquear la topolog\u00eda o aplicarlo a un nuevo entorno de cluster para migrar el entorno.\u00a0<\/span><\/p>\n

Los casos de uso de esta funci\u00f3n son numerosos. Aun as\u00ed, en el que nos centraremos en este post es la migraci\u00f3n de un entorno desde una topolog\u00eda de datos gestionada manualmente en un entorno R\/D r\u00e1pido\/\u00e1gil a un entorno de producci\u00f3n m\u00e1s estable.<\/span><\/p>\n

Tanto si eres nuevo en Couchbase como un profesional experimentado, el nuevo <\/span>Guardar y restaurar<\/span><\/i> de Couchbase Autonomous Operator simplifica significativamente tu proceso CI\/CD. Ser capaz de pasar f\u00e1cilmente de un cl\u00faster no gestionado a un cl\u00faster gestionado te permite continuar con el desarrollo a un ritmo r\u00e1pido mientras mantienes el control de los entornos a lo largo del proceso.<\/span><\/p>\n

Demostraci\u00f3n de la migraci\u00f3n del esquema de un cl\u00faster Couchbase\u00a0\u00a0<\/span><\/h2>\n

Para demostrar esta funcionalidad, primero tenemos que crear un cl\u00faster de servidores Couchbase en Kubernetes en un estado no gestionado. Usaremos este <\/span>unmanaged.yaml<\/span><\/i> file:<\/span><\/p>\n

apiVersion: v1\r\ntipo: Secret\r\nmetadatos:\r\nname: cb-example-auth\r\ntype: Opaco\r\ndatos:\r\nnombre de usuario: QWRtaW5pc3RyYXRvcg==\r\ncontrase\u00f1a: cGFzc3dvcmQ=\r\n---\r\napiVersion: couchbase.com\/v2\r\ntipo: CouchbaseCluster\r\nmetadatos:\r\nname: cb-example-unmanaged\r\nspec:\r\nimagen: couchbase\/server:7.0.3\r\nseguridad:\r\n  adminSecret: cb-example-auth\r\n  rbac:\r\n    managed: false\r\ncubos:\r\n  managed: false\r\nservidores:\r\n  - tama\u00f1o: 3\r\n    nombre: all_services\r\n    servicios:\r\n      - datos\r\n      - \u00edndice\r\n      - consulta\r\n      - b\u00fasqueda\r\n      - eventos\r\n      - anal\u00edtica<\/pre>\n
Para crear este cl\u00faster, utilice el comando: Esto crea un cluster simple no gestionado con todos los servicios, pero desactiva la gesti\u00f3n de buckets y RBAC. Tambi\u00e9n incluye un secreto para acceder al cluster con un nombre de usuario de <\/span>Administrador<\/span><\/i> y una contrase\u00f1a de <\/span>contrase\u00f1a<\/span><\/i>.\u00a0<\/span><\/p>\n
kubectl create -f .\/unmanaged.yaml<\/pre>\n
Para acceder a este cluster, port-forward el puerto 8091 para que podamos acceder al servidor Couchbase Admin UI s\u00f3lo para el acceso r\u00e1pido de desarrollo. Si quieres acceder al puerto de administraci\u00f3n con regularidad, consulta la documentaci\u00f3n sobre la configuraci\u00f3n de un puerto balanceador de carga.\u00a0<\/span><\/p>\n
Para crear este reenv\u00edo de puertos, utilice el comando:\u00a0<\/span><\/p>\n
kubectl port-forward cb-example-0000 8091<\/pre>\n
Ahora podemos acceder a la interfaz web en el puerto 8091 utilizando las credenciales de administrador y, a continuaci\u00f3n, crear algunos buckets, \u00e1mbitos y colecciones. En este ejemplo, creamos un <\/span>BlogApp<\/span><\/i> cubo, con un margen para <\/span>es-US<\/span><\/i> y algunas colecciones dentro de ese \u00e1mbito.<\/span><\/p>\n
\"\"<\/p>\n
A continuaci\u00f3n, a\u00f1adimos el \u00e1mbito para <\/span>es-US<\/span><\/i>.<\/span><\/p>\n
\"Add<\/p>\n
Por \u00faltimo, a\u00f1adimos el <\/span>Blogs<\/span><\/i> colecciones.<\/span><\/p>\n
\"Add<\/p>\n
Ahora tenemos una estructura de \u00e1rbol con este aspecto:<\/span><\/p>\n
Cubo: BlogApp\r\n   \u00c1mbito: es-US\r\n      Colecci\u00f3n: Blogs\r\n      Colecci\u00f3n: Receta<\/pre>\n
Una vez que tenemos nuestra topolog\u00eda de datos, podemos generar un archivo YAML utilizando la funci\u00f3n <\/span>cao<\/span><\/i> binario con el comando:<\/span><\/p>\n
.\/cao save --couchbase-cluster cb-example-unmanaged --filename .\/topology.yaml<\/pre>\n
Esto mostrar\u00e1 nuestro <\/span>topology.yaml:<\/span><\/i><\/p>\n
---\r\napiVersion: couchbase.com\/v2\r\ntipo: CouchbaseBucket\r\nmetadatos:\r\n  creationTimestamp: null\r\n  name: bucket-629f6ab0-d3ad-442e-b8e8-33e71412fae8\r\nspec:\r\n  compressionMode: passive\r\n  conflictResolution: seqno\r\n  evictionPolicy: valueOnly\r\n  ioPriority: low\r\n  maxTTL: 0s\r\n  cuota de memoria 256Mi\r\n  duraci\u00f3n m\u00ednima: ninguna\r\n  nombre: BlogApp\r\n  r\u00e9plicas: 1\r\n  \u00e1mbitos:\r\n    managed: true\r\n    recursos:\r\n    - kind: CouchbaseScope\r\n      name: scope-48d41118-fafd-48fa-a128-a539ffdb5efa\r\n    - tipo: CouchbaseScope\r\n      name: scope-9807f3f5-f798-43f6-bab0-32c44fada0ef\r\n---\r\napiVersion: couchbase.com\/v2\r\ntipo: CouchbaseScope\r\nmetadatos:\r\n  creationTimestamp: null\r\n  name: scope-48d41118-fafd-48fa-a128-a539ffdb5efa\r\nspec:\r\n  collections:\r\n    managed: true\r\n    recursos:\r\n    - kind: CouchbaseCollection\r\n      name: collection-80bf5988-85ed-47b0-986b-44d52dca3389\r\n    - tipo: CouchbaseCollection\r\n      name: collection-6da06d0d-c07c-4847-b2b6-0c46f5fed67a\r\n  nombre: en-US\r\n---\r\napiVersion: couchbase.com\/v2\r\ntipo: CouchbaseCollection\r\nmetadatos:\r\n  creationTimestamp: null\r\n  name: collection-80bf5988-85ed-47b0-986b-44d52dca3389\r\nspec:\r\n  maxTTL: 0s\r\n  nombre: Recetas\r\n---\r\napiVersion: couchbase.com\/v2\r\ntipo: CouchbaseCollection\r\nmetadatos:\r\n  creationTimestamp: null\r\n  name: collection-6da06d0d-c07c-4847-b2b6-0c46f5fed67a\r\nspec:\r\n  maxTTL: 0s\r\n  nombre: Blogs\r\n---\r\napiVersion: couchbase.com\/v2\r\ntipo: CouchbaseScope\r\nmetadatos:\r\n  creationTimestamp: null\r\n  name: scope-9807f3f5-f798-43f6-bab0-32c44fada0ef\r\nspec:\r\n  collections:\r\n    managed: true\r\n    preserveDefaultCollection: true\r\n  defaultScope: true<\/pre>\n
Clonaci\u00f3n de una topolog\u00eda de cl\u00faster<\/h3>\n
Con el fichero de topolog\u00eda podemos ahora restaurarlo en otro cluster, clonando la estructura en un nuevo entorno. Para ello, cree un archivo managed.yaml<\/em> con este contenido:<\/p>\n
apiVersion: couchbase.com\/v2\r\ntipo: CouchbaseCluster\r\nmetadatos:\r\n  nombre: cb-example-managed\r\nspec:\r\n  imagen: couchbase\/server:7.0.3\r\n  seguridad:\r\n    adminSecret: cb-example-auth\r\n    rbac:\r\n      managed: false\r\n  cubos:\r\n    gestionado: true\r\n  servidores:\r\n    - tama\u00f1o: 3\r\n      nombre: all_services\r\n      servicios:\r\n        - datos\r\n        - \u00edndice\r\n        - consulta\r\n        - b\u00fasqueda\r\n        - eventos\r\n        - anal\u00edtica<\/pre>\n
A continuaci\u00f3n, creamos el cl\u00faster gestionado mediante: Esto es similar a nuestro <\/span>unmanaged.yaml<\/span><\/i>pero, en su lugar, los cubos son <\/span>gestionado <\/span><\/i>y reutilizamos nuestro secreto del cl\u00faster no gestionado.\u00a0<\/span><\/p>\n
kubectl create -f managed.yaml<\/pre>\n
Restauraci\u00f3n de la topolog\u00eda en el cl\u00faster gestionado<\/h3>\n
Una vez que el cl\u00faster se haya puesto en marcha, puede utilizar la funci\u00f3n <\/span>cao <\/span><\/i>binario para restaurar la topolog\u00eda YAML en el cl\u00faster gestionado reci\u00e9n creado:<\/span><\/p>\n
\"Restoring
\nPor \u00faltimo, para verificar, crearemos un simple port-forward al nuevo cluster gestionado y verificaremos la topolog\u00eda de datos. Utilice el siguiente comando para crear el port-forward y abra su navegador a <\/span>https:\/\/127.0.0.1:8091<\/span><\/a><\/em>.\u00a0\u00a0<\/span><\/p>\n
kubectl port-forward cb-example-managed-0000 8091<\/pre>\n
Deber\u00eda aparecer la topolog\u00eda de datos adecuada.<\/p>\n
\"Confirm<\/p>\n
Ahora que hemos migrado la topolog\u00eda de datos, es posible que queramos migrar los datos de un entorno a otro. Recomiendo utilizar <\/span>Replicaci\u00f3n entre centros de datos (XDCR) <\/span><\/i>para facilitar el movimiento de datos de un cluster a otro. Puede encontrar m\u00e1s informaci\u00f3n sobre la configuraci\u00f3n de XDCR en la p\u00e1gina <\/span>Documentaci\u00f3n del operador Couchbase<\/span><\/a>.<\/span><\/p>\n
Pr\u00f3ximos pasos y recursos<\/span><\/h2>\n
Algunas cosas a tener en cuenta:<\/span><\/p>\n