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

Os modelos da Azure Developer CLI (azd) reúnem a configuração, a infraestrutura e o código do aplicativo, quando necessário, para provisionar e implantar uma solução no Azure. Você pode usar um modelo para um aplicativo, um projeto somente de infraestrutura ou um ponto de partida reutilizável para projetos futuros.

Note

Antes de começar, leia modelos da CLI do Desenvolvedor do Azure para obter uma descrição completa da estrutura dos modelos, dos ativos obrigatórios e opcionais, das associações entre serviços e recursos e de como os comandos azd usam cada arquivo.

Fluxo de trabalho de desenvolvimento de modelo

O fluxo de trabalho a seguir se aplica se você cria um modelo ou inicializa um que já existe:

Diagrama do fluxo de trabalho de desenvolvimento de modelo azd, desde escolher um ponto de partida até executar o azd up e manter o modelo.

  • Escolha um ponto de partida:Comece com um novo modelo com a integração GitHub Copilot, outro assistente de codificação de IA ou criação direta. Como alternativa, comece com um modelo existente de Microsoft, sua organização ou a comunidade de desenvolvedores.
  • Explore e edite os arquivos: Veja como os arquivos azure.yaml do Bicep ou do Terraform, o código do aplicativo e a configuração de suporte funcionam em conjunto. Consulte Explorar e editar arquivos de modelo.
  • Estenda e evolua conforme necessário: Adicione, substitua, remova ou reprojete componentes de aplicativo e infraestrutura. Consulte Estender um modelo para ver um exemplo completo que adiciona um recurso do Azure e o conecta a um aplicativo.
  • Provisionar e implantar: Execute azd up para provisionar a infraestrutura e implantar todos os serviços de aplicativo. Para obter mais informações, consulte Explorar o azd up fluxo de trabalho.
  • Manter ou compartilhar: Continue editando o modelo conforme o projeto evolui. Se você pretende compartilhá-lo, teste-o em um diretório limpo e primeiro em um ambiente novo azd.

Note

Ao longo desse fluxo de trabalho, você pode criar, editar ou substituir arquivos de modelo por conta própria ou com a ajuda de um assistente de codificação de IA. O resultado é o mesmo conjunto de ativos padrão e editáveis azd .

Blocos de construção de modelo

Cada azd modelo dá suporte a uma solução diferente, mas a maioria dos modelos combina os mesmos tipos de ativos:

  • Configuração do projeto: O azure.yaml arquivo identifica o projeto, os serviços implantáveis, os diretórios de origem, os destinos de hospedagem e os ganchos ou fluxos de trabalho opcionais.
  • Infraestrutura como código: arquivos Bicep ou Terraform definem os recursos Azure, atribuições de função, rede e configurações de aplicativo necessárias para a solução.
  • Fonte do aplicativo: Um modelo pode incluir um ou mais aplicativos implantáveis ou pode conter apenas infraestrutura.
  • Configuração do ambiente: Os parâmetros passam valores específicos do ambiente para implantações e as saídas de infraestrutura se tornam valores no ambiente ativo azd .

Um modelo para um aplicativo 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 de acordo com o projeto. O código-fonte do aplicativo, os módulos de infraestrutura e os arquivos de pipeline são opcionais, e azure.yaml identifica os caminhos que azd usa. Esses ativos funcionam juntos durante todo o ciclo de vida de desenvolvimento de modelos.

Próximas Etapas 

Começar com um novo modelo

Solicitar ajuda

Para obter informações sobre como arquivar um bug, solicitar ajuda ou propor um novo recurso para a CLI do Desenvolvedor do Azure, visite a página troubleshooting e suporte.

  • Última atualização em