Como funciona a CLI do Azure Developer

Concluído

A CLI do Desenvolvedor do Azure (azd) é criada em torno de comandos amigáveis para desenvolvedores e modelos de aplicativos fundamentais. azd fornece um conjunto de comandos que ajudam a integrar e gerenciar seu aplicativo no Azure usando modelos de projeto padronizados. Esses modelos incluem todo o código-fonte e ativos de configuração necessários para provisionar e implantar seu aplicativo no Azure. Você pode começar a usar azd trabalhando com um dos modelos de exemplo existentes e extensíveis ou criando o seu próprio.

Explorar azd comandos

A CLI do Desenvolvedor do Azure inclui um conjunto acessível de comandos que mapeiam para estágios comuns do fluxo de trabalho de desenvolvimento, como provisionamento e implantação de recursos. Alguns azd comandos, como azd up também lidar com vários estágios ao mesmo tempo, para simplificar ainda mais essas tarefas.

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 e definir um nome de ambiente quando solicitado.

   azd init --template todo-nodejs-mongo
   

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

   azd auth login
   

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

   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.

Outros azd comandos estão disponíveis para concluir outras tarefas e expandir este fluxo de trabalho. azd é projetado para ter um número mínimo de comandos com poucos parâmetros para facilidade de uso. Alguns dos comandos mais comuns azd incluem:

• azd init - Inicialize um novo aplicativo.
• azd up - Provisione recursos do Azure e implante seu projeto com um único 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 - Autenticar com o Azure.
• azd config - Gerencie configurações azd (por exemplo, assinatura padrão do Azure, local).
• azd down - Exclua recursos do Azure para um aplicativo.

Explore azd modelos

Os comandos da CLI do Desenvolvedor do Azure são projetados para trabalhar com modelos de projeto padronizados. Cada modelo é um repositório de código que adere a convenções específicas de arquivos e pastas. Os modelos contêm os ativos azd necessários para 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ê está adicionando o seu próprio. Quando você executa um comando como azd up, a ferramenta usa os ativos de modelo de projeto para executar várias etapas de fluxo de trabalho, como provisionamento ou implantação de recursos no Azure.

Existem duas abordagens principais para trabalhar com azd modelos:

• Estender um modelo existente azd - Uma grande biblioteca de azd modelos já existe para cobrir pilhas, cenários e arquiteturas de aplicativos locais comuns. Você pode navegar por muitos dos modelos no site da biblioteca de modelos awesome-azd. Se você encontrar um modelo que mapeia para 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 próprio aplicativo em um azd modelo - Você também pode converter um aplicativo existente em um azd template seguindo o guia Tornar seu projeto compatível com azdele. Criar seu próprio modelo geralmente é mais trabalhoso inicialmente, mas permite o maior controle e produz uma solução reutilizável para futuros trabalhos de desenvolvimento no aplicativo. As etapas principais para criar seu próprio modelo são as seguintes:

  • Inicialize o modelo de projeto com azd init.

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

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

  • Provisionar & implantar com azd up.

    

Independentemente da abordagem escolhida, a estrutura do modelo resultante é a mesma. Todos os azd modelos incluem os seguintes ativos:

• infra folder - Contém toda a infraestrutura do Bíceps ou Terraform como arquivos de código para o azd modelo. A infraestrutura como código permite definir recursos e configurações de infraestrutura em arquivos de definição declarativa que geram de forma confiável os mesmos ambientes sempre que são implantados. O Terraform funciona em várias plataformas de nuvem, enquanto o Bicep é específico para o Azure. azd executa esses arquivos para criar os recursos do Azure necessários para hospedar seu aplicativo. Você pode aprender mais sobre infraestrutura como código no módulo de treinamento O que é infraestrutura como código?

• azure.yaml file - Um arquivo de configuração que define um ou mais serviços em seu projeto e os mapeia para recursos do Azure para implantação. Por exemplo, você pode definir um serviço de API e um serviço front-end da Web, cada um com atributos que os mapeiam 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 fornecem apenas ativos de infraestrutura e deixam o src diretório vazio para você adicionar seu próprio código de aplicativo.

  

A maioria dos azd modelos também inclui opcionalmente uma ou mais das seguintes pastas:

• .devcontainer folder - Permite configurar um ambiente de Dev Container para seu aplicativo. Uma abordagem de ambiente de desenvolvimento comum que não é específica do azd.
• .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.