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) permite componer progresivamente los recursos de Azure necesarios para tu aplicación sin redactar manualmente código Bicep. Compose también utiliza Módulos Verificados de Azure (AVM) siempre que sea posible, proporcionando prácticas recomendadas mediante el uso de bloques de construcción para Azure.

¿Qué es la características compose?

La función de redacción azd ofrece una nueva manera de comenzar con azd. 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 función de composición.

Compatibilidad del proyecto con Compose

La característica de redacción azd está diseñada para proyectos que aún no usan la infraestructura como código para administrar 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 azd add 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 gestiona la creación de recursos internamente hasta que generes los archivos Bicep para los recursos para una mayor personalización.

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
  • Azure Database for MySQL
• Servicio de alojamiento
  • Azure Container Apps (Aplicaciones de Contenedores de Azure)
  • Azure App Service
• bóveda de claves
  • Azure Key Vault
• Mensajería
  • Azure Service Bus
  • Azure Event Hubs
• Cuenta de almacenamiento
  • Azure Blob Storage

Compatibilidad con idiomas

• Servicio de Aplicaciones:
  • Python
  • TypeScript
  • JavaScript

Pasos siguientes

Inicio rápido de Compose