Inicio rápido: Uso de Data API Builder con Azure Cosmos DB para NoSQL y Azure Static Web Apps

Artículo
04/30/2024

En este inicio rápido, implementará una plantilla de Azure Developer CLI (AZD). La plantilla implementa una aplicación web estática de Azure que hospeda el generador de Data API mediante su característica conexione de base de datos. La plantilla también incluye una aplicación de ejemplo que puede usar como punto de partida para las soluciones.

Requisitos previos

Suscripción de Azure. Si no tiene una suscripción de Azure, cree una cuenta de evaluación gratuita.
.NET 8
CLI de desarrollo de Azure

Sugerencia

Como alternativa, abra este inicio rápido en GitHub Codespaces con todos los requisitos previos del desarrollador ya instalados. Simplemente traiga su propia suscripción de Azure. Las cuentas de GitHub incluyen un derecho de almacenamiento y horas básicas sin costo alguno. Para más información, consulte el artículo sobre el almacenamiento incluido y las horas principales de las cuentas de GitHub.

Implementación de la plantilla

En primer lugar, implemente todos los servicios necesarios mediante la plantilla AZD.

Abra un terminal en el directorio raíz del proyecto.
Autentíquese en el Azure Developer CLI mediante azd auth login. Siga los pasos especificados por la herramienta para autenticarse en la CLI mediante sus credenciales de Azure preferidas.
```
azd auth login
```
Use azd init para inicializar el proyecto.
```
azd init --template dab-azure-cosmos-db-nosql-quickstart
```
Importante

Si se ejecuta en GitHub Codespaces, puede omitir el --template argumento de forma segura, ya que el código ya se ha clonado en el entorno.
Durante la inicialización, configure un nombre de entorno único.

Sugerencia

El nombre del entorno también se usará como nombre del grupo de recursos de destino. Para este inicio rápido, considere la posibilidad de usar msdocs-swa-dab.
Implemente la solución Azure Static Web Apps mediante azd up. Las plantillas de Bicep implementan una cuenta de Azure Cosmos DB para NoSQL junto con los servicios de almacenamiento, identidad y host compatibles. Se implementa una aplicación web de ejemplo en el host web.
```
azd up
```
Durante el proceso de aprovisionamiento, seleccione la suscripción y la ubicación deseada. Espere a que se complete el proceso de aprovisionamiento. El proceso puede tardar aproximadamente cinco minutos.
Una vez hecho el aprovisionamiento de los recursos de Azure, la plantilla genera un mensaje SUCCESS junto con la duración de la ejecución.
```
SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
```

Configuración de la conexión de base de datos

Ahora, use la característica conexione de base de datos de Azure Static Web Apps para crear una conexión entre la aplicación web estática implementada y la base de datos implementada. Esta característica usa Data API Builder sin problemas para crear una conexión a una cuenta de Azure Cosmos DB para NoSQL en ejecución mediante las credenciales que especifique.

Vaya al recurso Azure Static Web App en el Azure Portal.

Configure la aplicación web estática para agregar una conexión de base de datos a la cuenta de Azure Cosmos DB para NoSQL mediante esta configuración. A continuación, seleccione Vincular.

	Valor
Tipo de base de datos	`Azure Cosmos DB for NoSQL`
Suscripción	Seleccione la suscripción que usó para la implementación de AZD.
Grupos de recursos	Seleccione el grupo de recursos (entorno) que usó para la implementación de AZD.
Nombre del recurso	Seleccione el único recurso de Azure Cosmos DB para NoSQL con un prefijo de `nosql-`*
Nombre de la base de datos	`cosmicworks`
Tipo de autenticación	`User-assigned managed identity`
Identidad administrada asignada por el usuario	Seleccione el único recurso de identidad administrada con un prefijo de `ua-id-`

Captura de pantalla de la página de conexión de base de datos de una aplicación web estática en la Azure Portal.

Ahora, seleccione la opción Examinar en la página de recursos para observar la ejecución de la aplicación web.

Limpieza

Cuando ya no necesite la aplicación o los recursos de ejemplo, quite la implementación correspondiente y todos los recursos.

Quite la implementación de la suscripción de Azure.
```
azd down
```
Elimine el codespace en ejecución para maximizar los derechos de almacenamiento y núcleo si usa GitHub Codespaces.

Paso siguiente

Puntos de conexión de GraphQL

Compartir a través de