Introdução ao recurso de redação do Azure Developer CLI

O recurso de composição do Azure Developer CLI (azd) permite que você escreva progressivamente os recursos do Azure necessários para seu aplicativo sem escrever manualmente o código Bicep. O Compose também usa a AVM (Módulos Verificados do Azure) quando possível, fornecendo práticas recomendadas usando blocos de construção para o Azure.

O que é o recurso de composição?

O recurso de redação azd introduz uma nova maneira de começar com azd. Antes do recurso de composição, os desenvolvedores tinham duas opções principais para configurar os recursos do Azure para provisionar e implantar um aplicativo:

• Comece com um modelo predefinido, que define recursos e serviços a serem provisionados e implantados no Azure e, em seguida, personalize. Procure modelos na galeria de modelos de IA ou na galeria da comunidade.
• Comece a partir de uma base de código existente seguindo as instruções no fluxo de inicialização simplificado.

Qualquer personalização adicional exigia que o usuário modificasse manualmente os arquivos Bicep até a introdução do recurso de redação.

Compatibilidade do projeto com o Compose

O azd recurso de composição foi projetado para projetos que ainda não usam a infraestrutura como código para gerenciar recursos do Azure. Como resultado, o compose não dá suporte aos seguintes cenários:

• Projetos que já têm uma infra pasta para a criação de recursos do Azure (como modelos existentes).
• Projetos do .NET Aspire, que usam o arquivo de host do aplicativo Aspire para gerenciar recursos.

Simplificar a criação de recursos com Compose

O recurso de composição do azd apresenta uma terceira opção para adicionar recursos do Azure aos seus aplicativos. Os desenvolvedores usam o comando azd add para instruir azd a compor novos recursos do Azure e atualizar configurações de modelo usando fluxos de trabalho com prompts mínimos. Esse recurso é útil para desenvolvedores que desejam evitar escrever o Bicep ou usar um modelo existente.

Execute o azd add comando para iniciar o fluxo de trabalho de composição e adicionar um novo recurso:

azd add

Esse comando inicia um fluxo de trabalho baseado em prompt que permite selecionar um novo recurso a ser criado para seu aplicativo:

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

Quando terminar de adicionar recursos com azd add, execute azd up ou azd provision crie os recursos no Azure. O azd gerencia a criação de recursos internamente até você gerar arquivos Bicep para os recursos para personalização adicional.

Visite o artigo Crie um modelo mínimo usando o recurso de composição para obter um passo a passo completo desse recurso.

Serviços compatíveis com o recurso de redação

O azd compose recurso dá suporte à adição de recursos para os seguintes serviços do Azure:

• IA
  • Modelos dos Serviços de IA do Azure e do Azure AI Foundry
  • Azure OpenAI com autenticação de ID do Microsoft Entra
  • Pesquisa de IA do Azure 
• Base de dados
  • Azure Cosmos DB
  • Azure Cosmos DB for MongoDB
  • Azure Cosmos DB for PostgreSQL
  • Cache do Azure para Redis
  • Banco de Dados do Azure para MySQL
• Serviço de Host
  • Aplicativos de Contêiner do Azure
  • Serviço de Aplicativo do Azure
• Cofre de chaves
  • Azure Key Vault
• Mensagens
  • Barramento de Serviço do Azure
  • Hubs de Eventos do Azure
• Conta de Armazenamento
  • Armazenamento de Blobs do Azure

Suporte ao idioma

• Serviço de Aplicativo:
  • Python
  • TypeScript
  • JavaScript

Próximas etapas

Compor o início rápido