Integración de Vercel con Azure Cosmos DB

SE APLICA A: NoSQL MongoDB

Vercel ofrece una plataforma fácil de usar y sólida para el desarrollo y la implementación de aplicaciones web. Esta nueva integración mejora la productividad, ya que los desarrolladores ahora pueden crear fácilmente aplicaciones de Vercel con una base de datos back-end ya configurada. Esta integración ayuda a los desarrolladores a transformar sus ideas creativas en realidad en tiempo real.

Introducción a la integración de Azure Cosmos DB con Vercel

Esta documentación está diseñada para los desarrolladores que buscan combinar eficazmente las sólidas funcionalidades de Azure Cosmos DB (un servicio de base de datos multimodelo distribuido globalmente) con la solución de hospedaje e implementación de alto rendimiento de Vercel.

Esta integración permite a los desarrolladores aplicar las ventajas de una base de datos NoSQL versátil y de alto rendimiento, al tiempo que se aprovecha la arquitectura y la plataforma de desarrollo sin servidor de Vercel.

Hay dos maneras de integrar Azure Cosmos DB.

• A través de Vercel Integrations Marketplace
• A través de la línea de comandos

Integración de Cosmos DB con Vercel mediante Integration Marketplace

Use esta guía si ya ha identificado los proyectos de Vercel o desea integrar un proyecto de vercel existente con

Requisitos previos

• Cuenta de Vercel con el proyecto de Vercel: Aprenda a crear un nuevo proyecto de Vercel

• Azure Cosmos DB: Inicio rápido: Creación de una cuenta de Azure Cosmos DB o Creación de una cuenta gratuita de Cosmos DB

• Conocimientos básicos sobre Next.js, React y TypeScript

Pasos para integrar Azure Cosmos DB con Vercel

1. Seleccione Proyectos de Vercel para la integración con Azure Cosmos DB. Una vez listos los requisitos previos, visite la página de integraciones de Cosmos DB en el marketplace de Vercel y seleccione Agregar integración

   

2. Elija Todos los proyectos o Proyectos específicos para la integración. En esta guía, vamos a elegir proyectos específicos. Seleccione Instalar para continuar.

   

3. Inicie sesión en su cuenta de Microsoft existente o, si no tiene una, cree una nueva cuenta como se muestra en el paso siguiente.

   

4. Haga clic en "Crear una" para crear una nueva cuenta de Microsoft.

Nota

La cuenta de Microsoft es diferente de una cuenta de Azure Cosmos DB. Vamos a crear una cuenta de Azure Cosmos DB en los pasos siguientes

5. Si desea usar una cuenta de Azure Cosmos DB existente, elija el directorio, la suscripción y la cuenta de Azure Cosmos DB (vaya al paso 9). Para crear una nueva cuenta de Azure Try Cosmos DB, haga clic en "Crear nueva cuenta".

   

6. Seleccione Tipo de API (actualmente solo se admiten NOSQL y MongoDB API) y haga clic en "Crear cuenta".

   

7. Después de crear correctamente la cuenta de Azure Cosmos DB, haga clic en "Continuar"

8. Haga clic en "Aceptar" en el elemento emergente para acceder a la cuenta Try Azure Cosmos DB (Probar cuenta de Azure Cosmos DB). (Obligatorio para completar la integración).

   

9. Seleccione Integrar y listo.

   

Integración de Cosmos DB con Vercel a través de la línea de comandos y npm

1. Ejecute create-next-app con npm, yarn o pnpm para arrancar el ejemplo:

   Bash

   npx create-next-app --example with-azure-cosmos with-azure-cosmos-app
   
   yarn create next-app --example with-azure-cosmos with-azure-cosmos-app
   
   pnpm create next-app --example with-azure-cosmos with-azure-cosmos-app
   

2. Modifique pages/index.tsx para agregar el código.

   Realice cambios en pages/index.tsx según sus necesidades. Puede consultar el código en lib/cosmosdb.ts para ver cómo se inicializa el cliente de JavaScript @azure/cosmos.

3. Inserte los cambios en un repositorio de GitHub.

Configurar las variables de entorno

• COSMOSDB_CONNECTION_STRING: necesita la cadena de conexión de Cosmos DB. Puede encontrarlos en Azure Portal en la sección claves.

• COSMOSDB_DATABASE_NAME: nombre de la base de datos que planea usar. Esto ya debería existir en la cuenta de Azure Cosmos DB.

• COSMOSDB_CONTAINER_NAME: nombre del contenedor que planea usar. Esto ya debería existir en la base de datos anterior.

Integración de Cosmos DB con Vercel mediante una plantilla de Marketplace

Tenemos una Next.js Starter de Azure Cosmos DB, que es una excelente plantilla lista para usar con una estructura guiada y una configuración, lo que le ahorra tiempo y esfuerzo en la configuración del proyecto inicial. Haga clic en Implementar para implementar en Vercel y Ver repositorio para ver el código fuente.

1. Elija el repositorio de GitHub, donde desea clonar el repositorio de inicio.

2. Seleccione la integración para configurar las claves de conexión de Cosmos DB; estos pasos se describen en detalle en la sección anterior.

   

3. Establezca las variables de entorno para el nombre de la base de datos y el nombre del contenedor y, por último, seleccione Implementar

   

4. Una vez finalizada correctamente, la página de finalización contendrá el vínculo a la aplicación implementada, o bien vaya al panel del proyecto de Vercel para obtener el vínculo de la aplicación. Ahora la aplicación se ha implementado correctamente en Vercel.

Pasos siguientes

• Para más información sobre Azure Cosmos DB, consulte Bienvenido a Azure Cosmos DB.
• Cree un nuevo proyecto de Vercel.
• Obtenga información sobre probar Cosmos DB y sus límites.