Crie um modelo mínimo usando o recurso de composição da CLI do Desenvolvedor do Azure

A funcionalidade de composição da CLIazd do Desenvolvedor do Azure permite-lhe criar progressivamente os recursos do Azure necessários para a sua aplicação sem ter que escrever manualmente o código Bicep. Neste artigo, você aprenderá a trabalhar com o recurso de composição para criar um modelo mínimo. Visite o artigo visão geral da azdcomposição para obter mais informações conceituais sobre este recurso.

Observação

O azd recurso de composição está atualmente em alfa e não deve ser usado em aplicativos de produção. Alterações nos recursos alfa em versões subsequentes podem resultar em alterações de quebra. Visite as páginas versionamento e estratégia de lançamento de funcionalidades do azd e estágios de funcionalidades para obter mais informações. Use o botão Comentários no canto superior direito para compartilhar comentários sobre o recurso e este compose artigo.

Trabalhar com o recurso de composição

Acesse azd os recursos de composição por meio do azd add comando. O azd add comando funciona com modelos criados usando os seguintes azd init fluxos de trabalho:

• Usar código no diretório atual (para aplicações direcionadas ao Azure Container Apps para hospedagem)
• Criar um projeto mínimo

Atualmente, não há suporte para modelos inicializados por meio do fluxo Selecionar um modelo . O recurso de composição azd gere a infraestrutura para si e não é compatível com modelos que possuem ativos de pasta infra já existentes. Consulte o artigo Gerar o código Bicep e a página de fluxos de trabalho de criação de modelos para mais informações.

Conclua as seguintes etapas para adicionar novos recursos ao seu modelo sem escrever nenhum código:

1. Numa janela de terminal, navegue até à raiz do seu azd template.

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

   azd add
   

3. Selecione um dos recursos suportados para adicionar ao seu aplicativo. Para este exemplo, selecione Database.

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

4. Para o tipo de banco de dados, selecione PostgreSQL.

   ? Which type of database?  [Use arrows to move, type to filter]
     MongoDB
   > PostgreSQL
     Redis
   

5. Insira um nome para o novo recurso, como azddb.

   ? Input the name of the app database (PostgreSQL)
   

6. Se seu aplicativo contiver serviços, azd solicitará que você selecione o serviço que usa esse recurso.

   ? Select the service(s) that uses this resource
   > [✓]  webfrontend
   

7. azd gera uma visualização das alterações necessárias no azure.yaml arquivo. Pressione Enter para aceitar e aplicar as alterações.

   Previewing changes to azure.yaml:
   
   +  azddata:
   +      type: db.postgres
   
      webfrontend:
          type: host.containerapp
          uses:
              - azddb
   +          - azddata
          port: 80
   

8. Execute o azd up comando para provisionar quaisquer alterações feitas por meio do azd add comando. Neste exemplo, azd provisiona um banco de dados PostgreSQL no Azure.

9. Execute o azd add comando novamente para adicionar outros recursos, como um serviço OpenAI.

Explore o arquivo azure.yaml

azure.yaml é o arquivo de configuração que azd usa para gerenciar seu aplicativo. azd gera os serviços e recursos compostos através do comando azd add usando os nós services e resources correspondentes. Considere o seguinte exemplo de um azure.yaml ficheiro atualizado inteiramente através de azd add.

name: azdcomposesample
metadata:
  template: azd-init@1.11.0
services:
  webfrontend:
    project: src
    host: containerapp
    language: dotnet
resources:
  webfrontend:
    type: host.containerapp
    port: 80
    uses:
      - azdsql
      - azdchat
  azdsql:
    type: db.postgres
  azdchat:
    type: ai.openai.model
    model:
      name: gpt-4o
      version: "2024-08-06"

• O services nó declara:
  • Um mapeamento de implantação nomeado webfrontend entre uma aplicação Web .NET no diretório src e os Aplicativos de Contêiner do Azure.
• O resources nó declara:
  • Um aplicativo de contêiner do Azure e um mapeamento de dependência correspondente nomeado webfrontend entre o aplicativo de contêiner .NET hospedado e o banco de dados e o serviço de IA do qual ele depende. O uses nó mapeia o aplicativo para os outros recursos dos quais depende.
  • Um recurso do Banco de Dados do Azure para PostgreSQL chamado azdsql.
  • Um recurso do Azure OpenAI chamado azdchat.

Próximos passos

Gerar código Bicep usando o recurso de composição