Como funciona o Azure Developer CLI

  • 6 minutos

O Azure Developer CLI (azd) foi criado com base em comandos amigáveis para desenvolvedores e em modelos de aplicativos básicos. O azd fornece um conjunto de comandos que ajuda a integrar e gerenciar seu aplicativo no Azure usando modelos de projeto padronizados. Esses modelos incluem todos os ativos de configuração e código-fonte necessários para provisionar e implantar seu aplicativo no Azure. Você pode começar a usar o azd trabalhando em um dos exemplos de modelos existentes e extensíveis ou criando modelos próprios.

Explorar os comandos do azd

O Azure Developer CLI inclui um conjunto acessível de comandos que são mapeados para fases comuns de fluxo de trabalho de desenvolvimento, como provisionamento e implantação de recursos. Alguns comandos do azd, como azd up, por exemplo, também lidam com várias fases ao mesmo tempo para simplificar ainda mais essas tarefas.

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

  1. Execute o comando azd init com o parâmetro --template para clonar um modelo existente e definir um nome de ambiente quando precisar.

    azd init --template todo-nodejs-mongo

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

    azd auth login

  3. Execute o comando azd up para provisionar e implantar os recursos de modelos no Azure.

    azd up

  4. Depois que o ambiente for 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 as alterações.

Há outros comandos azd disponíveis para realizar outras tarefas e expandir esse fluxo de trabalho. O azd foi projetado para ter um número mínimo de comandos com poucos parâmetros para facilitar o uso. Alguns dos comandos azd mais comuns incluem:

  • azd init – Inicialize um novo aplicativo.
  • azd up – Provisione recursos do Azure e implante seu projeto com um só comando.
  • azd provision – Provisione os recursos do Azure para um aplicativo.
  • azd deploy – Implante o código do aplicativo no Azure.
  • azd pipeline – (Beta) Gerencie e configure seus pipelines de implantação.
  • azd auth – Autentique-se com o Azure.
  • azd config – Gerencie as configurações do azd (por exemplo, assinatura padrão do Azure, localização).
  • azd down – Exclua os recursos do Azure para um aplicativo.

Explorar os modelos do azd

Os comandos do Azure Developer CLI foram projetados para funcionar com modelos de projeto padronizados. Cada modelo é um repositório de código que segue convenções específicas de arquivo e pasta. Os modelos contêm os ativos necessários para o azd provisionar recursos do Azure e, opcionalmente, implantar o código-fonte do aplicativo. Alguns modelos podem não incluir o código-fonte do aplicativo sob a suposição de que você irá adicionar o seu próprio. Quando você executa um comando como azd up, a ferramenta usa os ativos do modelo de projeto para executar várias etapas de fluxo de trabalho, como provisionamento ou implantação de recursos no Azure.

Há duas abordagens principais para trabalhar com os modelos do azd:

  • Estender um modelo existente do azd – Já existe uma ampla biblioteca de modelos do azd para abranger arquiteturas, cenários e pilhas de aplicativos locais comuns. Navegue pelos vários modelos no site da biblioteca de modelos awesome-azd. Se você encontrar um modelo que se alinha com sua pilha de aplicativos local ou arquitetura desejada, poderá usá-lo como ponto de partida. Em seguida, substitua o diretório do código-fonte e modifique os arquivos de configuração ou infraestrutura para atender às suas necessidades.

  • Converter seu aplicativo em um modelo do azd – Você também pode converter um aplicativo existente em um azd template seguindo o guia Tornar seu projeto compatível com o azd. Em geral, criar um modelo próprio é mais complexo inicialmente, mas permite o maior controle e produz uma solução reutilizável para trabalhos futuros de desenvolvimento no aplicativo. As principais etapas para criar seu modelo são as seguintes:

    • Inicialize o modelo de projeto com o azd init.

    • Crie a infraestrutura como arquivos de código usando o Bicep ou o Terraform.

    • Atualize o arquivo azure.yaml para vincular os serviços de aplicativo aos recursos do Azure.

    • Provisione e implemente com azd up.

      A diagram showing the Azure Developer CLI template creation workflow.

Seja qual for a abordagem escolhida, a estrutura de modelo resultante é a mesma. Todos os modelos do azd incluem os seguintes ativos:

  • Pasta infra – Contém toda a infraestrutura do Bicep ou do Terraform como arquivos de código para o modelo do azd. A infraestrutura como código permite que você defina recursos e configurações de infraestrutura em arquivos de definição declarativa que geram os mesmos ambientes de maneira confiável sempre que são implantados. O Terraform funciona em várias plataformas de nuvem, enquanto o Bicep é específico do Azure. Esses arquivos são executados pelo azd para criar os recursos do Azure necessários para hospedar seu aplicativo. Saiba mais sobre a infraestrutura como código no módulo de treinamento O que é a infraestrutura como código?.

  • Arquivo azure.yaml – Um arquivo de configuração que define um ou mais serviços no seu projeto e os mapeia para os recursos do Azure para implantação. Por exemplo, você pode definir um serviço de API e um serviço de front-end da Web, cada um com atributos que os mapeiam para diferentes recursos do Azure para implantação.

  • Pasta .azure – Contém configurações essenciais do Azure e variáveis de ambiente, como o local para implantar recursos ou outras informações da assinatura.

  • src folder – Contém todo o código-fonte do aplicativo implantável. Alguns modelos do azd fornecem apenas ativos de infraestrutura e deixam o diretório src vazio para você adicionar seu código de aplicativo.

    A screenshot showing the Azure Developer CLI template structure.

Opcionalmente, a maioria dos modelos do azd inclui uma ou mais das seguintes pastas:

  • Pasta .devcontainer – Permite que você configure um ambiente de Contêiner de Desenvolvimento para seu aplicativo. Uma abordagem comum de ambiente de desenvolvimento que não é específica do azd.
  • Pasta .github – Contém os arquivos de fluxo de trabalho de CI/CD para o GitHub Actions, que é o provedor de CI/CD padrão do azd.
  • Pasta .azdo – Se você decidir usar o Azure Pipelines para CI/CD, defina os arquivos de configuração de fluxo de trabalho nessa pasta.