Visão geral do desenvolvimento de modelos da Azure Developer CLI (azd)

Os templates do Azure Developer CLI (azd) agrupam a configuração, infraestrutura e o código opcional da aplicação necessários para provisionar e implementar uma solução no Azure. Pode usar um modelo para uma aplicação, um projeto apenas de infraestrutura ou um ponto de partida reutilizável para projetos futuros.

Note

Antes de começar, leia os templates de CLI do Azure Developer para uma descrição completa da estrutura dos templates, ativos obrigatórios e opcionais, associações serviço-recurso e como azd os comandos utilizam cada ficheiro.

Fluxo de trabalho de desenvolvimento de templates

O seguinte fluxo de trabalho aplica-se quer crie um modelo ou inicialize um que já existe:

Diagrama do fluxo de trabalho de desenvolvimento de templates de CLI para desenvolvedores do Azure. À esquerda, uma caixa rotulada "Escolher um ponto de partida" contém duas opções: "Começar com um novo modelo" e "Começar a partir de um modelo existente." Ambas as opções levam a "Explorar e editar os ficheiros do modelo." A partir daí, um caminho opcional segue para "Expandir o modelo", e o caminho principal prossegue para "Executar azd up." O passo "Expandir o modelo" também conduz a "executar azd up." Finalmente, executar "azd up" conduz a "Manter ou partilhar o modelo".

• Escolha um ponto de partida:Comece com um novo modelo com a integração do GitHub Copilot, outro assistente de programação de IA ou autoria direta. Alternativamente, comece com um modelo existente da Microsoft, da sua organização ou da comunidade de programadores.
• Explore e edite os ficheiros: Revise como azure.yamlos ficheiros do Bicep ou Terraform, o código da aplicação e a configuração de suporte funcionam em conjunto. Consulte Explorar e editar ficheiros modelo.
• Expandir e evoluir conforme necessário: Adicionar, substituir, remover ou redesenhar componentes da aplicação e da infraestrutura. Siga as instruções em Expandir um modelo para obter um exemplo completo que adiciona um recurso do Azure e o liga a uma aplicação.
• Provisionamento e implementação: Execute azd up para provisionar a infraestrutura e implementar quaisquer serviços da aplicação. Para mais informações, consulte Explorar o azd up fluxo de trabalho.
• Manter ou partilhar: Continue a editar o modelo à medida que o seu projeto evolui. Se planeias partilhá-lo, testa-o primeiro num diretório limpo e num novo azd ambiente.

Note

Ao longo deste fluxo de trabalho, pode criar, editar ou substituir ficheiros de modelo sozinho ou com a ajuda de um assistente de programação com IA. O resultado é o mesmo conjunto de recursos padrão, editáveis azd.

Blocos de construção do modelo

Cada azd modelo suporta uma solução diferente, mas a maioria combina os mesmos tipos de ativos:

• Configuração do Project: O azure.yaml ficheiro identifica o project, serviços implantáveis, diretórios de código-fonte, alvos de alojamento e ganchos ou fluxos de trabalho opcionais.
• Infraestrutura como código: Ficheiros Bicep ou Terraform definem os recursos do Azure, atribuições de funções, redes e definições da aplicação que a solução exige.
• Fonte da aplicação: Um modelo pode incluir uma ou mais aplicações implantáveis, ou pode conter apenas infraestrutura.
• Configuração do ambiente: Os parâmetros transmitem valores específicos do ambiente para as implementações, e as saídas da infraestrutura tornam-se valores no ambiente ativo azd .

Um modelo para uma aplicação pode usar a seguinte estrutura de pastas:

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

A estrutura exata varia consoante o projeto. O código-fonte da aplicação, módulos de infraestrutura e ficheiros de pipeline são opcionais e azure.yaml identificam os caminhos que azd utilizam. Estes ativos trabalham em conjunto ao longo de todo o ciclo de vida do desenvolvimento do modelo.

Passos seguintes

Comece com um novo modelo

Pedir ajuda

Para informações sobre como registar um bug, pedir ajuda ou propor uma nova funcionalidade para a Azure Developer CLI, por favor visite a página troubleshooting and support.