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

O recurso de composição (composição) da CLI do Desenvolvedor do Azure (azd) permite que você componha progressivamente os recursos do Azure necessários para seu aplicativo sem 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 de visão geral doazd compose para obter mais informações conceituais sobre esse recurso.

Observação

O azd recurso de composição está atualmente em alfa e não deve ser usado em aplicativos de produção. As alterações nos recursos alfa nas versões subsequentes podem resultar em alterações significativas. Visite as páginas azd feature versioning and release strategy e feature stages para obter mais informações. Use o botão Comentários no canto superior direito para compartilhar comentários sobre o compose recurso e este 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 o código no diretório atual (para aplicativos direcionados aos Aplicativos de Contêiner do Azure para hospedagem)
• Crie um projeto mínimo

No momento, não há suporte para modelos inicializados por meio do fluxo Selecionar um modelo . O azd recurso de composição gerencia a infraestrutura para você e não é compatível com modelos que têm ativos de pasta existentes infra . Visite o artigo Gerar o código Bicep e a página de fluxos de trabalho de criação de modelo para obter mais informações.

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

1. Em uma janela de terminal, navegue até a raiz do seu azd modelo.

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 com suporte 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 o 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 as 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.

Explorar o arquivo azure.yaml

azure.yaml é o arquivo de configuração usado azd para gerenciar seu aplicativo. azdgerencia os serviços e recursos compostos através do azd add comando usando os nós and resources correspondentesservices. Considere o seguinte exemplo de um azure.yaml arquivo totalmente atualizado por meio azd addde:

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 um aplicativo Web .NET no diretório e os src 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 ele depende.
  • Um recurso do Banco de Dados do Azure para PostgreSQL chamado azdsql.
  • Um recurso do OpenAI do Azure chamado azdchat.

Próximas etapas

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