Visão geral dos modelos da CLI do Azure Developer

Os modelos de CLI do Desenvolvedor do Azure (azd) são repositórios de código regulares que incluem código de exemplo da aplicação, incluindo azd arquivos de configuração e de infraestrutura. azd os modelos permitem que você provisione recursos do Azure, implante seu aplicativo, configure pipelines de CI/CD e muito mais. Você pode criar seus próprios modelos ou começar a usar um modelo existente de um repositório de modelos, como o Awesome AZD. Neste artigo, você aprenderá sobre os seguintes conceitos:

• Como azd os modelos permitem provisionar e implantar recursos do aplicativo
• Como são estruturados os modelos azd
• Como decidir se deseja usar um modelo existente ou criar um
• Explorar os modelos iniciais existentes azd

Por que usar modelos da CLI do Azure Developer?

Os desenvolvedores geralmente enfrentam muitas tarefas demoradas e desafiadoras ao criar aplicativos com reconhecimento de ambiente adequadamente arquitetados e configurados para a nuvem. As equipes devem levar em conta muitas preocupações diferentes nesses ambientes, como a criação de recursos, a aplicação de configurações, a configuração de monitoramento e registro, a criação de pipelines de CI/CD e outras tarefas. azd os modelos reduzem e simplificam essas responsabilidades para ajudar o desenvolvedor em sua jornada do desenvolvimento local para um aplicativo implantado com êxito no Azure.

Por exemplo, suponha que você trabalhe em uma empresa que opera uma plataforma de gerenciamento de tíquetes e comunicação com o cliente, que requer os seguintes recursos do Azure:

• Duas instâncias do Serviço de Aplicativo e um Plano do Serviço de Aplicativo para hospedar um aplicativo Web front-end e uma API back-end
• Uma instância do Cofre da Chave para armazenar segredos seguros do aplicativo
• Um banco de dados do Cosmos DB para armazenar permanentemente dados do aplicativo
• Recursos do Azure Monitor, como painéis do Application Insights
• Um Service Bus para gerenciar mensagens escaláveis
• Pipelines de CI/CD para garantir que as alterações possam ser implantadas de forma confiável por meio de um processo automatizado e repetível.

Em vez de começar do zero, com azd, pode aproveitar os modelos de arquitetura existentes para fornecer e implantar a maioria dos recursos para si. A equipe de desenvolvimento pode então se concentrar na criação do aplicativo e fazer ajustes menores na arquitetura do modelo.

Como funcionam os modelos da CLI do Azure Developer

Os modelos da CLI do Desenvolvedor do Azure são projetados para funcionar com comandos azd como azd init e azd up. Os modelos incluem arquivos de configuração e infraestrutura como código (IaC) que são usados pelos comandos para executar tarefas como provisionar recursos do Azure e implantar o código do aplicativo neles.

Por exemplo, um fluxo de trabalho azd típico usando um modelo existente inclui as seguintes etapas:

1. Execute o azd init comando com o --template parâmetro para clonar um modelo existente do GitHub.

   azd init --template todo-nodejs-mongo
   

2. Execute o azd auth login comando para autenticar sua assinatura do Azure.

   azd auth login
   

3. Execute o comando azd up para provisionar e implantar os recursos de modelo no Azure. O azd up comando aproveita os arquivos de configuração e infraestrutura como código (IaC) em seu modelo para provisionar recursos do Azure e implantar seu aplicativo nesses recursos.

   azd up
   

4. Depois que seu ambiente estiver configurado no Azure, você poderá modificar localmente os recursos do aplicativo ou os modelos de recursos do Azure e, em seguida, executar azd up novamente para provisionar suas alterações.

Explore a estrutura do modelo da CLI do Azure Developer

azd Os modelos são repositórios de código padrão com alguns ativos adicionais incluídos. Todos os azd modelos compartilham uma estrutura de arquivo semelhante com base em azd convenções:

• infra pasta - Contém toda a infraestrutura Bicep ou Terraform como arquivos de código para o modelo azd. azd executa esses arquivos para criar os recursos do Azure necessários para hospedar seu aplicativo.
• azure.yaml ficheiro - Um ficheiro de configuração que mapeia pastas de código-fonte no seu projeto para recursos do Azure definidos na pasta infra para implantação. Por exemplo, você pode definir um serviço de API e um serviço front-end da Web em pastas separadas e mapeá-los para diferentes recursos do Azure para implantação.
• .azure pasta - Contém configurações essenciais do Azure e variáveis de ambiente, como o local para implantar recursos ou outras informações de assinatura.
• src folder - Contém todo o código-fonte do aplicativo implantável. Alguns azd modelos excluem a pasta src e fornecem apenas recursos de infraestrutura para que possa adicionar o seu próprio código da aplicação.

Por exemplo, um modelo comum azd pode corresponder à seguinte estrutura de pastas:

azd Os modelos também incluem opcionalmente uma ou mais das seguintes pastas:

• .github folder - Contém os ficheiros de fluxo de trabalho de CI/CD para GitHub Actions, o fornecedor de CI/CD padrão para azd.
• .azdo pasta - Se você decidir usar o Azure Pipelines for CI/CD, defina os arquivos de configuração do fluxo de trabalho nessa pasta.
• .devcontainer folder - Permite configurar um ambiente de Dev Container para seu aplicativo.

Comece com um modelo existente ou crie o seu próprio

Existem duas abordagens principais para trabalhar com modelos azd:

• Comece com um modelo existente azd .
  • Esta é uma boa escolha se estás apenas a começar com azd ou se procuras um modelo para criar uma nova aplicação com uma arquitetura e frameworks semelhantes.
• Converter um projeto existente em um azd modelo.
  • Esta é uma boa escolha quando você já tem um aplicativo existente, mas deseja torná-lo compatível com azd os recursos.

As seções a seguir fornecem mais informações sobre essas duas opções.

Começar com um modelo existente

Está disponível uma ampla seleção de azd modelos na galeria de templates awesome-azd. Esses modelos fornecem infraestrutura e código de aplicativo para vários cenários de desenvolvimento, estruturas de linguagem e serviços do Azure. Se você encontrar um modelo alinhado com sua pilha de aplicativos local ou arquitetura desejada, poderá estender e substituir o código do modelo pelo seu próprio

Por exemplo, os modelos a seguir azd fornecem pontos de partida para arquiteturas e estruturas comuns de aplicativos:

Criar um novo azd modelo para seu aplicativo

Você também pode converter um aplicativo existente em um azd modelo para aprimorar o repositório com recursos de provisionamento e implantação. Essa abordagem permite o maior controle e produz uma solução reutilizável para futuros trabalhos de desenvolvimento no aplicativo. As etapas de alto nível para criar seu próprio modelo são as seguintes:

• Inicialize o modelo de projeto com azd init.
• Crie a infraestrutura Bicep ou Terraform como arquivos de código na infra pasta.
• Atualize o arquivo azure.yaml para vincular os serviços do aplicativo aos recursos do Azure.
• Provisionar & implantar com azd up.

Os recursos a seguir fornecem mais informações sobre como criar seus próprios modelos:

• Crie seu primeiro modelo de CLI do Azure Developer
• Torne o seu projeto compatível com azd o guia

Diretrizes para o uso de azd modelos

Observe que cada modelo que você usa com a CLI do Azure Developer é licenciado por seu respetivo proprietário (que pode ou não ser a Microsoft) sob o contrato que acompanha o modelo. É sua responsabilidade determinar qual licença se aplica a qualquer modelo que você escolher usar.

A Microsoft não é responsável por quaisquer modelos que não sejam da Microsoft e não analisa esses modelos quanto a problemas de segurança, privacidade, compatibilidade ou desempenho. Os modelos que você usa com a CLI do Desenvolvedor do Azure, incluindo aqueles fornecidos pela Microsoft, não são suportados por nenhum programa ou serviço de suporte da Microsoft. Quaisquer modelos fornecidos pela Microsoft são fornecidos NO ESTADO EM QUE SE ENCONTRAM sem qualquer tipo de garantia.

Próximos passos