Visão geral dos modelos de CLI para Desenvolvedores do Azure

A CLI Azure Developer (azd) utiliza templates para provisionar e implementar recursos da aplicação na cloud. Os programadores podem adicionar suporte para azd comandos e funcionalidades convertendo as suas aplicações em templates. Este artigo fornece uma visão geral contextual das diferentes opções para modelos de construção azd . Depois de compreender os conceitos deste artigo, visite os seguintes recursos para guias de implementação mais detalhados:

• Use um modelo existente para a sua aplicação.
• Crie um modelo a partir do código da sua aplicação
• Formação - construir e implementar azd modelos

Conceitos de criação de modelos

Criar um modelo azd requer adicionar ativos específicos de configuração e infraestrutura à sua base de código existente, ou iniciar uma nova aplicação a partir de um modelo existente com os mesmos recursos. Ambos os fluxos de trabalho são explicados nas secções seguintes. Todos os azd templates partilham uma estrutura de ficheiros semelhante baseada em azd convenções. O diagrama seguinte apresenta 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 ficheiros de código (Bicep ou Terraform).
• Um ficheiro de configuração que mapeia os serviços da sua aplicação para os recursos de infraestrutura provisionados.

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

Considere o seguinte repositório de aplicações de exemplo:

Após converter esta aplicação de exemplo para um azd modelo, o mesmo repositório contém o seguinte:

Os recursos originais da aplicação mantiveram-se inalterados, mas foram adicionados novos elementos dos quais azd depende para comandos como: azd up

• Foi adicionada uma pasta infra que inclui ficheiros Bicep para criar recursos Azure.
• Foi adicionado um ficheiro de configuração azure.yaml para mapear o código da aplicação no diretório src para provisionar recursos do Azure.
• Foi criada uma .azure pasta para armazenar azd variáveis de ambiente.
• Foi adicionada uma pasta .github (opcional) para suportar pipelines CI/CD através de ações GitHub.

Fluxos de trabalho de criação de modelos

O comando azd init é usado para inicializar um modelo azd para provisionar e implementar os recursos da aplicação no Azure. O comando indica que deve escolher entre dois diferentes fluxos de trabalho para inicializar um modelo que está delineado nas seções seguintes - Use código no diretório atual e Use um modelo existente.

Execute o azd init comando na raiz do diretório que pretende converter para um azd template:

azd init

Usar código no diretório atual

Esta opção instrui azd a analisar o código no seu diretório para identificar que tecnologias utiliza, como a linguagem de programação, o framework e o sistema de base de dados. azd gera automaticamente ativos de modelo para si, como o ficheiro de definição de serviço azure.yaml e a pasta infra com ficheiros de infraestrutura como código. Os ativos gerados são um ponto de partida para modificações adicionais. Use esta abordagem se planeia utilizar serviços de Azure comuns suportados por funcionalidades de andaimes azd.

Visite o tutorial Comece com o código da aplicação para criar um modelo para obter detalhes de como implementar esta abordagem e mais informações sobre quais recursos do Azure suportam deteção automática e scaffold.

Selecione um modelo

Selecione esta opção para usar um modelo existente que defina muitos dos seus recursos e objetivos arquitetónicos do Azure como ponto de partida. azd Vai pedir-te para escolheres um modelo inicial ou outro modelo da galeria Awesome-Azd . Quando selecionas um modelo, os recursos desse modelo são adicionados ao diretório do teu projeto existente para usares como ponto de partida. Alguns modelos incluem código de aplicação de exemplo que pode substituir pelo seu próprio, enquanto outros (chamados "modelos iniciais") são apenas de infraestrutura.

Use o azd init comando para puxar um modelo existente para um diretório vazio e usá-lo como ponto de partida para a sua própria aplicação. Se o modelo incluir código-fonte da aplicação, podes construir a partir desse código ou substituir o diretório do código-fonte pelo teu.

Visite o Início com um tutorial modelo existente para detalhes sobre como implementar esta abordagem.

Consulte também

• Use um modelo existente para a sua aplicação.
• Crie um modelo a partir do código da sua aplicação

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.

Próximos passos