Introducción a la característica de redacción de la CLI para desarrolladores de Azure

La característica Azure Developer CLI (azd) composability (compose) te permite componer de manera progresiva los recursos de Azure necesarios para tu aplicación sin escribir manualmente código Bicep. Compose también utiliza Módulos Verificados de Azure (AVM) siempre que sea posible, proporcionando prácticas recomendadas mediante bloques de construcción para Azure.

¿Qué es la características compose?

La característica compose de ofrece una nueva manera de empezar a trabajar con . Antes de la característica de redacción, los desarrolladores tenían dos opciones principales para configurar los recursos de Azure para aprovisionar e implementar una aplicación:

• Comience con una plantilla prebuilt, que define los recursos y los servicios que se van a aprovisionar e implementar en Azure y, a continuación, personalizar. Examine las plantillas en la galería de plantillas de IA o en la galería de la comunidad.
• Comience a partir de un código base existente siguiendo las instrucciones del flujo de inicialización simplificada.

Cualquier personalización adicional requería que el usuario modificara manualmente los archivos Bicep, hasta la introducción de la funcionalidad de composición.

Compatibilidad del proyecto con Compose

La funcionalidad de composición azd está diseñada para proyectos que aún no utilizan la infraestructura como código para gestionar recursos de Azure. Como resultado, compose no admite los siguientes escenarios:

• Proyectos que ya tienen una carpeta infra para la creación de recursos de Azure (por ejemplo, plantillas existentes).
• .NET Aspire proyectos, que usan el archivo host de la aplicación Aspire para administrar recursos.

Simplificación de la creación de recursos con compose

La característica azd compose presenta una tercera opción para agregar Azure recursos a las aplicaciones. Los desarrolladores usan el comando azd add para indicar a azd crear nuevos recursos de Azure y actualizar configuraciones de plantilla mediante flujos de trabajo de solicitud mínimos. Esta característica es útil para los desarrolladores que desean evitar escribir Bicep o usar una plantilla existente.

Ejecute el comando para iniciar el flujo de trabajo de redacción y agregar un nuevo recurso:

azd add

Este comando comienza un flujo de trabajo basado en indicaciones que le permite seleccionar un nuevo recurso para crear para tu aplicación.

? What would you like to add?  [Use arrows to move, type to filter]
> AI
  Database
  Host service
  Key Vault
  Messaging
  Storage account
  ~Existing resource

Cuando haya terminado de agregar recursos con azd add, ejecute azd up o azd provision para crear los recursos en Azure. azd administra internamente la creación de recursos hasta que generes archivos Bicep para los recursos y así poder personalizarlos.

Visite el artículo Compilación de una plantilla mínima con la característica de redacción para ver un tutorial completo de esta característica.

Servicios admitidos por la característica compose

La característica azd compose admite la adición de recursos para los siguientes servicios de Azure:

• IA
  • Modelos de Herramientas Foundry y Microsoft Foundry
  • Azure OpenAI con autenticación de Microsoft Entra ID
  • Azure AI Search
• Base de datos
  • Azure Cosmos DB
  • Azure Cosmos DB para MongoDB
  • Azure Cosmos DB para PostgreSQL
  • Azure Cache for Redis
  • Base de Datos Azure para MySQL
• Servicio de alojamiento
  • Azure Container Apps
  • Azure App Service
• Key Vault
  • Azure Key Vault
• Mensajería
  • Azure Service Bus
  • Azure Event Hubs
• Cuenta de almacenamiento
  • Azure Blob Storage (Almacenamiento de objetos Blob de Azure)

Compatibilidad con idiomas

• Servicio de Aplicaciones:
  • Python
  • TypeScript
  • JavaScript

Pasos siguientes

Guía rápida de inicio de Compose