Nos complace anunciar el lanzamiento de Couchbase Cloud versión 1.6que introduce características que agilizan la administración de cuentas, mejoran la migración de datos y simplifican la forma de trabajar con Couchbase Cloud.
En este post voy a proporcionar una visión general de las nuevas características, que incluyen una API pública, una capacidad de importación de datos mejorada, una experiencia de registro/inscripción más sencilla y una cobertura regional de AWS ampliada. Debido a su importancia en la lista de nuevas características, dedicaré la mayor parte de este artículo a la nueva e impresionante API.
API de Couchbase Cloud
En API de Couchbase Cloud es una característica importante y poderosa que abre nuevas puertas para automatizar operaciones en tu cuenta de Couchbase Cloud. Te permite interactuar programáticamente con el Plano de Control de Couchbase Cloud para realizar una variedad de funciones administrativas usando APIs RESTful seguras.
Las API permiten crear y eliminar clústeres, buckets y usuarios de bases de datos, así como listar nubes, gestionar proyectos y mucho más. Usando las APIs, puedes crear aplicaciones que automaticen tareas manuales repetitivas, como la creación de nuevos clústeres y usuarios para nuevas aplicaciones, y puedes usarlo para integrar la funcionalidad de Control Plane en otras aplicaciones, o usarlo para construir aplicaciones que proporcionen información en tiempo real de tu ecosistema de bases de datos Couchbase Cloud.
La API de Couchbase Cloud permite a los clientes integrarse con Couchbase Cloud para realizar operaciones en su cuenta, como:
-
- Alta y baja de usuarios
- Gestión del ciclo de vida de un clúster
- Obtención de información de seguimiento de un clúster
La primera iteración de la API pública se centra en el ciclo de vida de un clúster y la funcionalidad asociada. A alto nivel, la API puede realizar las siguientes funciones:
Para agrupaciones
-
- Listar, crear y eliminar clusters, buckets, usuarios
- Gestionar el acceso con Allow List
Para proyectos
-
- Listar, crear y eliminar proyectos
Para las nubes
-
- Enumerar las nubes y obtener información detallada sobre ellas
Puntos finales de la API
La siguiente tabla enumera los puntos finales y métodos de la API pública que puede utilizar en sus aplicaciones:
baseURL = "https://cloudapi.cloud.couchbase.com"
| API | Métodos | Descripción |
| {baseURL}/v2/status | GET | Devuelve el estado de las API públicas |
| {baseURL}/v2/clouds | GET | Devuelve una lista paginada de información resumida sobre cada nube |
| {baseURL}/v2/clouds/{id} | GET | Devuelve información detallada sobre una nube |
| {baseURL}/v2/proyectos | GET, POST | Devuelve una lista paginada de información resumida sobre cada proyecto ( GET ) o para crear un proyecto ( POST ) |
| {baseURL}/v2/proyectos/{id} | GET, DELETE | Devuelve información detallada sobre un proyecto ( GET ) o lo elimina ( DELETE ) |
| {baseURL}/v2/clusters | GET, POST | Devuelve una lista paginada de información resumida sobre cada cluster ( GET ) o para crear un cluster ( POST ) |
| {baseURL}/v2/clusters/{id} | GET, DELETE | Devuelve información detallada sobre un proyecto ( GET ) o lo elimina ( DELETE ) |
| {baseURL}/v2/clusters/{id}/buckets | OBTENER, PUBLICAR, ELIMINAR | Devuelve información detallada sobre un cubo ( GET ), crea un cubo ( POST ) o lo elimina ( DELETE ) |
| {baseURL}/v2/clusters/{id}/allowlist | OBTENER, PUBLICAR, ELIMINAR | Devuelve información detallada sobre una lista de permitidos ( GET ), crea una lista de permitidos ( POST ) o la elimina ( DELETE ) |
Flujo de información de la API
La API de Couchbase Cloud es segura, usando encriptación TLS para las comunicaciones. También requiere una clave de acceso y una clave secreta para la autenticación y autorización.
El siguiente diagrama ilustra el flujo básico de información cuando se utiliza la API:
Flujo de información de la API de Couchbase Cloud
- Las llamadas REST seguras se realizan desde la aplicación de operaciones del cliente a los puntos finales del servicio de API pública de Couchbase Cloud.
- El Servicio API pasa cada llamada al Plano de Control de Couchbase Cloud, que a su vez pasa la llamada al Plano de Datos en la cuenta del cliente.
- Las operaciones se realizan en el Plano de Datos y las respuestas se envían de vuelta a través del Plano de Control al Servicio API, y luego a la aplicación de operaciones del cliente.
Uso básico y llamada a un punto final
El uso de la API es sencillo y consta de 3 pasos:
- Generar claves API
- Crear Clave de Acceso y Clave Secreta usando el Plano de Control de Couchbase Cloud
- Autentificar
- Generar la cabecera utilizando Authorization y Couchbase-Timestamp
- Llamar a la API
- Incluya la cabecera de autenticación y ejecute la llamada REST
En Referencia de la API pública ofrece información detallada sobre todos los puntos finales disponibles, incluidos los parámetros y las respuestas. Esta guía de referencia es un recurso esencial para conocer los entresijos de la API.
Encontrará documentación sobre cómo generar las claves y el encabezado de la API aquíEchemos un vistazo rápido a cómo llamar a un punto final de la API.
Supongamos que estás usando Couchbase Cloud para alimentar una variedad de aplicaciones a través de múltiples nubes y proveedores de nube, por ejemplo AWS y Azure. Para mantener operaciones eficientes sería importante entender el estado actual de tu ecosistema de nube, cuál es el estado de cada nube en un momento dado. Como parte de una aplicación de operaciones, puedes incluir esta información llamando a la función Nubes punto final.
Llamada al Nubes devuelve una lista paginada de todas las nubes de su cuenta, con información como el nombre, el estado, el proveedor de la nube y la región. Puede llamar al endpoint de la siguiente manera: GET /v2/clouds
El endpoint Clouds devuelve ListCloudsResponse con los campos de datos CloudSummary:
API de Couchbase CloudResumen
He aquí un sencillo ejemplo de llamada a la función Nubes utilizando Python, donde la variable get_clouds_from_api llama al endpoint, luego toma cada campo de nombre de nube, proveedor, región e id devuelto en los datos de ListCloudsResponse y los construye en una fila para mostrarlos en una tabla:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
def get_clouds_from_api(): clouds_api_response = cbc_api_get(/v2/clouds) lista_nube = [] si clouds_api_response['responseStatus'] es no Ninguno: lista_de_nubes = clouds_api_response[contenido de la respuesta] # ¿Tenemos una lista? si lista_de_nubes es no Ninguno: para nube en lista_de_nubes[datos]: # Crea una fila para mostrarla en una tabla lista_nube.añadir([nube[nombre],nube[proveedor] , nube[región], nube[id]]) devolver(lista_nube) |
Para ver este código en acción, y probar una variedad de otras aplicaciones de ejemplo prediseñadas que hacen cosas como crear y eliminar clusters, listar usuarios, crear proyectos, etc., aproveche la función Ejemplos de API de Couchbase CloudAdemás, incluye un completo conjunto de aplicaciones operativas que le ayudarán a aprender a utilizar la API y a poner en marcha el desarrollo de sus propias aplicaciones. Las instrucciones para empezar a utilizar las muestras de la API se encuentran aquí.
El uso de la API es tan sencillo como potente, ya que permite llamar mediante programación al plano de control de Couchbase Cloud para automatizar tareas manuales repetitivas. Por ejemplo, utilizando la API, los clientes que aprovechan Couchbase Cloud para alimentar múltiples aplicaciones de ciclo de vida corto - como sandboxes de desarrollo donde se crean nuevos clústeres y los clústeres antiguos se desmantelan con frecuencia - pueden agilizar el proceso mediante la creación de una utilidad que aprovisiona clústeres, los gestiona y luego los destruye cuando ya no son necesarios.
La utilidad podría listar resúmenes para nubes, proyectos, clusters, y obtener datos detallados para cada uno en tiempo real, ayudando a la organización a gestionar su ecosistema Couchbase Cloud de forma más eficiente y efectiva. Este es sólo un ejemplo de las muchas formas en que se puede utilizar la API, ¡estamos entusiasmados con la nueva función y esperamos que los clientes le den un gran uso!
Importación de datos mejorada
Couchbase Cloud 1.6 también introduce una funcionalidad de importación mejorada que le permite migrar datos a Couchbase Cloud más fácilmente y de nuevas formas. Usando la nueva interfaz de Herramientas de Importación, ahora puedes importar archivos JSON (líneas, lista y archivo) y CSV a Couchbase Cloud desde una máquina local usando tu navegador o manualmente usando un comando cURL proporcionado por la API.
Importación de Couchbase Cloud
Un aspecto importante de la nueva función es que las claves de cada documento extraído de una fila CSV o de un archivo plano de lista JSON pueden generarse automáticamente (UUID), o especificarse utilizando una expresión de nombre de clave generada que siga la misma sintaxis utilizada por la función cbimport (que impulsa la nueva función).
Clave personalizada en la importación
La posibilidad de generar claves personalizadas es una mejora bienvenida que simplificará y agilizará los esfuerzos de migración de datos para los clientes de Couchbase Cloud.
Al crear una importación, puede elegir entre varias opciones de configuración, como Omitir documentos, Limitar documentos, Ignorar campos, Inferir tipos de campo (sólo CSV) y Omitir campos vacíos (sólo CSV). Otras funciones mejoradas son las acciones asíncronas o concurrentes, el seguimiento de la actividad, las notificaciones por correo electrónico para importaciones de larga duración, la reimportación, etc.
La nueva función Importar se convierte en otra forma en la que los clientes pueden migrar datos a Couchbase Cloud, junto con Backup/Restore y XDCR.
Otras novedades
Experiencia de registro simplificada
Se han realizado mejoras en el flujo de registro de Couchbase Cloud para guiar mejor a los nuevos clientes a través del proceso y conseguir que se registren de la forma más rápida y sencilla posible. Para registrarse en Couchbase Cloud, visite Registrarse en Couchbase Cloud.
Ampliación de la cobertura regional de AWS
Couchbase Cloud sigue aumentando su número de regiones compatibles en todo el mundo y ahora está disponible en la región de Oriente Medio (Bahréin) de AWS. Para obtener una lista completa de las regiones de AWS compatibles, consulte Requisitos del proveedor de la nube para AWS.
Mi colega Prasad Doddi escribió un profundo blog cubriendo la nueva característica de Couchbase Cloud Import que incluye un gran tutorial de la nueva interfaz de Import Tools. ¡Recomiendo encarecidamente su lectura!
Las últimas funciones de Couchbase Cloud confirman nuestro compromiso de hacer que el servicio sea lo más potente y fácil de usar posible para los clientes.
Si no ha aprovechado la Prueba gratuita de Couchbase Cloud Sin embargo, ¡ahora es el momento de comprobar por ti mismo lo fácil que es empezar!