Partilhar via

Visão geral dos modelos da CLI do Azure Developer

  • Artigo

Os modelos da CLI do Desenvolvedor do Azure (azd) são repositórios de código padrão que incluem código de aplicativo de exemplo, bem como azd arquivos de configuração e 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 azd os modelos são estruturados
  • Como decidir se deseja usar um modelo existente ou criar um
  • Explore 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 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, você azd pode aproveitar os modelos de arquitetura existentes para provisionar e implantar a maioria dos recursos para você. 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 azd comandos 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 típico azd 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 azd up comando 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 executar novamente para provisionar azd up suas alterações.

Compreender a estrutura do modelo da CLI do Azure Developer

Todos os azd modelos compartilham uma estrutura de arquivo semelhante com base em azd convenções. Os ativos mínimos exigidos geralmente incluem o seguinte:

  • infra folder - Contém toda a infraestrutura do Bíceps ou Terraform como arquivos de código para o azd modelo. azd executa esses arquivos para criar os recursos do Azure necessários para hospedar seu aplicativo.

  • azure.yaml file - Um arquivo de configuração que define um ou mais serviços em seu projeto e os mapeia para os infra recursos do Azure definidos na pasta para implantação. Por exemplo, você pode definir um serviço de API e um serviço front-end da Web e mapeá-los para diferentes recursos do Azure para implantação.

  • .azure folder - 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 e fornecem apenas ativos de src infraestrutura para que você possa adicionar seu próprio código de aplicativo.

    Nota

    Os modelos que excluem a pasta geralmente são projetados como modelos iniciais de src infraestrutura.

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

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

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

Uma captura de tela mostrando uma estrutura de modelo da CLI do Desenvolvedor do Azure.

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

Existem duas abordagens principais para trabalhar com azd modelos:

  • Comece com um modelo existente azd .
    • Esta é uma boa escolha se você está apenas começando ou azd se está procurando um modelo para criar um novo aplicativo com uma arquitetura e estruturas 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

Uma ampla seleção de modelos está disponível na galeria de azd modelos 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:

Template Anfitrião da aplicação Pilha de tecnologia
React Web App com API C# e MongoDB no Azure Serviço de Aplicações do Azure Azure Cosmos DB para NoSQL, Bicep
React Web App com API C# e Banco de Dados SQL no Azure Serviço de Aplicações do Azure Banco de Dados SQL do Azure, Bicep
Static React Web App + Funções com API C# e Banco de Dados SQL no Azure Aplicativos Web estáticos do Azure, Azure Functions Banco de Dados SQL do Azure, Bicep

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 azure.yaml arquivo 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:

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

Selecionar e implantar um modelo