Visão geral de criar modelos da CLI do Azure Developer

A CLI do Desenvolvedor do Azure (azd) utiliza modelos para provisionar e implantar recursos do 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 neste artigo, visite os seguintes recursos para obter guias de implementação mais detalhados:

• Use um modelo existente para seu aplicativo.
• Criar um modelo a partir do código do seu aplicativo
• Treinamento - criar e implantar azd modelos

Nota

Este artigo pressupõe uma compreensão geral dos azd modelos. Visite o documento de visão geral do modelo para obter mais informações sobre modelos.

Conceitos de criação de modelos

A criação de um azd modelo requer a adição de ativos específicos de configuração e infraestrutura à sua base de código existente ou o início de um novo aplicativo a partir de um modelo existente, esses 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 infra pasta 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 aplicativo de exemplo:

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

Os recursos originais do aplicativo permanecem inalterados, mas novos ativos foram adicionados que azd dependem de comandos como azd up:

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

Fluxos de trabalho de criação de modelos

O azd init comando é usado para inicializar um azd modelo 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 - Usar código no diretório atual e Usar 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

Esta 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 ativos de modelo para você, como o azure.yaml arquivo de definição de serviço e a infra pasta 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 suportados por azd recursos de andaime.

Visite o Iniciar com o código do seu aplicativo para criar um tutorial de modelo para obter detalhes sobre como implementar essa abordagem e mais informações sobre quais recursos do Azure oferecem suporte à deteção automática e andaimes.

Selecionar um modelo

Selecione esta opção para usar um modelo existente que define muitos dos seus recursos e metas de arquitetura do Azure como ponto de partida. azd solicitará que você selecione um modelo inicial ou outro modelo da galeria 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 código de aplicativo de exemplo que você pode substituir pelo seu próprio, enquanto alguns (chamados de "modelos iniciais") são apenas infraestrutura.

Use o azd init comando para puxar um modelo 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 a partir desse código ou substituir o diretório do código-fonte pelo seu.

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 a partir do código do seu aplicativo

Pedir 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 de solução de problemas e suporte .

Próximos passos

FAQ sobre o Azure Developer CLI