Criar uma visão geral dos modelos da CLI do Desenvolvedor do Azure

A CLI do Desenvolvedor Azure (azd) utiliza templates para provisionar e implantar recursos de aplicativo na nuvem. Os desenvolvedores podem adicionar suporte para azd comandos e recursos convertendo seus aplicativos em modelos. Este artigo fornece uma visão geral contextual das diferentes opções para criar azd modelos. Depois de entender os conceitos deste artigo, visite os seguintes recursos para obter guias de implementação mais detalhados:

• Use um modelo existente para seu aplicativo.
• Criar um modelo com base no código do aplicativo
• Treinamento – criar e implantar azd modelos

Conceitos de criação de modelo

A criação de um azd modelo requer a adição de ativos de configuração e infraestrutura específicos à sua base de código existente ou a inicialização de um novo aplicativo a partir de um modelo existente desses mesmos ativos. Ambos os fluxos de trabalho são explicados em seções posteriores. Todos os azd modelos compartilham uma estrutura de arquivo semelhante baseada em azd convenções. O diagrama a seguir fornece uma visão geral rápida do processo para criar um azd modelo:

Cada azd modelo requer os seguintes recursos mínimos:

• Uma pasta infra que contém a infraestrutura como arquivos de código (Bicep ou Terraform).
• Um azure.yaml arquivo de configuração que mapeia seus serviços de aplicativo para os recursos de infraestrutura provisionados.

Outros diretórios opcionais também são frequentemente incluídos, como uma .github pasta com ativos para criar um pipeline de CI/CD. Visite o documento de visão geral do modelo para obter mais informações sobre modelos.

Considere o seguinte repositório de aplicativos de exemplo:

Depois de converter este aplicativo de exemplo em um azd modelo, o mesmo repositório de aplicativos contém o seguinte:

Os recursos originais do aplicativo não foram alterados, mas novos ativos foram adicionados dos quais azd depende para comandos como azd up:

• Foi adicionada uma pasta infra que inclui arquivos Bicep para criar recursos Azure.
• Um arquivo de configuração azure.yaml foi adicionado para mapear o código do aplicativo no diretório src aos recursos de provisionamento Azure.
• Uma .azure pasta foi criada para conter azd variáveis de ambiente.
• Uma pasta .github (opcional) foi adicionada para dar suporte a pipelines de CI/CD por meio de ações de GitHub.

Fluxos de trabalho de criação de modelo

O comando azd init é usado para inicializar um modelo azd para provisionar e implantar os recursos do aplicativo no Azure. O comando solicita que você escolha entre dois fluxos de trabalho diferentes para inicializar um modelo descrito nas seções a seguir : use o código no diretório atual e use um modelo existente.

Execute o azd init comando na raiz do diretório que você deseja converter em um azd template:

azd init

Usar código no diretório atual

Essa opção instrui azd a analisar o código em seu diretório para identificar quais tecnologias ele usa, como a linguagem de programação, a estrutura e o sistema de banco de dados. azd gera automaticamente recursos de modelos para você, como o arquivo de definição de serviço azure.yaml e a pasta infra com arquivos de infraestrutura-como-código. Os ativos gerados são um ponto de partida para modificações adicionais. Use essa abordagem se você planeja usar serviços comuns do Azure compatíveis com os recursos de scaffolding de azd.

Visite o tutorial Comece com o código do seu aplicativo para criar um modelo para obter detalhes sobre como implementar essa abordagem e mais informações sobre quais recursos do Azure dão suporte à detecção e scaffolding automáticos.

Selecionar um modelo

Selecione essa opção para usar um modelo existente que define muitos de seus recursos de Azure e metas de arquitetura como ponto de partida. azd solicitará que você selecione um modelo inicial ou outro modelo na galeria do awesome-azd . Quando você seleciona um modelo, os ativos desse modelo são adicionados ao diretório de projeto existente para usar como ponto de partida. Alguns modelos incluem um código de aplicativo de exemplo que você pode substituir por seu próprio, enquanto alguns (chamados de "modelos iniciais") são apenas infraestrutura.

Use o comando azd init para baixar um template existente para um diretório vazio e usá-lo como ponto de partida para seu próprio aplicativo. Se o modelo incluir o código-fonte do aplicativo, você poderá criar com base nesse código ou substituir o diretório do código-fonte pelo seu próprio.

Visite o tutorial Iniciar com um modelo existente para obter detalhes sobre como implementar essa abordagem.

Consulte também

• Use um modelo existente para seu aplicativo.
• Criar um modelo com base no código do aplicativo

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.

Próximas Etapas