Visão geral dos comandos da CLI do Desenvolvedor do Azure

A CLI do Desenvolvedor do Azure (azd) foi projetada para simplificar o fluxo de trabalho de desenvolvedor de ponta a ponta no Azure. azd fornece comandos de alto nível que atuam como abstrações para simplificar tarefas comuns do desenvolvedor, como inicialização de projeto, provisionamento de infraestrutura, implantação de código e monitoramento. Os comandos azd estão disponíveis no terminal, em um IDE (ambiente de desenvolvimento integrado) ou por meio de pipelines de CI/CD (integração contínua/implantação contínua). Neste artigo, você aprenderá sobre o seguinte:

• Conceitos de comando essenciais azd
• Como os comandos azd se comparam com outras ferramentas
• A relação entre azd comandos e modelos
• Comandos comuns azd e quais tarefas de desenvolvimento eles aceleram

Observação

Acesse o guia de início rápido Implantar um modelo da CLI do Desenvolvedor do Azure para explorar um fluxo de trabalho de comando de exemplo azd com mais detalhes.

Comparar os comandos do Azure Developer CLI

A ênfase em estágios de desenvolvimento de alto nível diferencia os comandos de outras azd ferramentas de linha de comando, como a CLI do Azure ou o Azure PowerShell. Enquanto essas ferramentas fornecem vários comandos para controle granular sobre recursos e configurações individuais do Azure, azd fornece menos comandos mais amplos para automatizar tarefas de desenvolvimento de nível superior, como provisionar vários recursos ou implantar vários serviços ao mesmo tempo.

A tabela a seguir destaca as diferenças entre um comando de exemplo azd e outras ferramentas de linha de comando do Azure. Observe que o azd provision comando executa várias tarefas ao mesmo tempo e não tem um equivalente direto nessas outras ferramentas. Muitos comandos da CLI do Azure ou do PowerShell seriam necessários para realizar a mesma tarefa.

Ferramenta	Comando de exemplo	Resultado
CLI para Desenvolvedores do Azure	azd provision	Provisiona vários recursos do Azure necessários para um aplicativo com base em recursos e configurações do projeto, como um grupo de recursos do Azure, um aplicativo Web do Serviço de Aplicativo do Azure e um plano de serviço de aplicativo, uma conta de Armazenamento do Azure e um Azure Key Vault.
Azure CLI (Interface de Linha de Comando do Azure)	az webapp create --resource-group myResourceGroup --plan myAppServicePlan --name myWebApp	Provisiona um novo aplicativo web no grupo de recursos especificado e no plano de serviço de aplicativos.
Azure PowerShell	New-AzWebApp -ResourceGroupName "myResourceGroup" -Name "myWebApp" -AppServicePlan "myAppServicePlan"	Provisiona um novo aplicativo web no grupo de recursos especificado e no plano de serviço de aplicativos.

Modelos e comandos da CLI do Desenvolvedor do Azure

azd os comandos são capazes de executar tarefas de fluxo de trabalho mais amplas devido, em parte, à integração deles com o azd sistema de modelos. Os modelos da CLI do Desenvolvedor do Azure são projetos de código que aderem a azd convenções estruturais e incluem código de aplicativo de exemplo, arquivos de infraestrutura e arquivos de configuração. A maioria dos azd modelos inclui o seguinte:

• Pasta .azure – Contém as variáveis de ambiente e as configurações essenciais do Azure, como o local para implantar recursos ou outras informações da assinatura.
• Pasta infra – Contém toda a infraestrutura do Bicep ou do Terraform como arquivos de código para o modelo azd.
• Pasta src – Contém todo o código-fonte do aplicativo implantável.
• azure.yaml arquivo – um arquivo de configuração que define um ou mais serviços no seu projeto e os mapeia para recursos do Azure definidos na pasta infra para implantação.

Sem azd comandos, esses modelos são apenas repositórios de código padrão. Essencialmente, os modelos azd servem como planos fundamentais, enquanto os comandos da CLI atuam como mecanismos que conduzem a implantação, o gerenciamento e o monitoramento de seus aplicativos. azd os comandos usam os ativos nesses modelos para executar várias tarefas.

Usando o modelo anterior como exemplo:

• O azd provision comando cria recursos no Azure usando os arquivos de infraestrutura como código na infra pasta de um modelo.
• O azd deploy comando implanta um aplicativo ou serviço definido na src pasta.

Observação

azd também pode criar e gerenciar alguns recursos do Azure sem a necessidade de definir modelos de infraestrutura como código manualmente usando o novo azd compose recurso, que está atualmente em alfa.

Explorar comandos comuns

As seções a seguir fornecem uma visão geral de alguns dos comandos mais comuns azd para fornecer exemplos de trabalho com modelos e diferentes tarefas de desenvolvimento.

Observação

Para obter uma lista completa de comandos azd e seus parâmetros, acesse a página Referência da CLI do Desenvolvedor do Azure.

Inicializar e executar um modelo

• azd init: inicializa um modelo existente azd ou cria e inicializa um novo modelo. Esse comando basicamente configura os arquivos e diretórios necessários para começar a trabalhar com azd.
• azd up: um comando de conveniência para provisionar, empacotar e implantar todos os recursos do aplicativo em um comando. Esse comando é o equivalente à execução azd provision, azd packagee azd deploy individualmente.

Provisionamento de infraestrutura

• azd provision: provisiona os recursos necessários do Azure, como instâncias do Aplicativo de Contêiner do Azure ou contas de Armazenamento do Azure com base em modelos de infraestrutura como código ou recursos definidos em azure.yaml.

Implantação de Código

• azd package: empacota o código do aplicativo a ser implantado no Azure.
• azd deploy: implanta o código do aplicativo nos recursos criados pelo azd provision comando.

Monitoramento e gerenciamento

• azd monitor: fornece insights sobre a integridade e o desempenho do aplicativo implantado

Configuração de pipeline de CI/CD

• azd pipeline config: configura um pipeline de CI/CD para o projeto. Esse comando configura os pipelines de integração contínua e de implantação contínua para automatizar os processos de compilação e implantação.

Gerenciamento de Ambiente

• azd env list: lista todos os ambientes diferentes (por exemplo, desenvolvimento, preparo, produção) que foram configurados para o modelo.
• azd env new: cria um novo ambiente com sua própria configuração e recursos, permitindo que você gerencie vários ambientes para diferentes estágios de desenvolvimento.

Limpeza de Recursos

• azd down: exclui os recursos do Azure criados pelo modelo para limpar seu ambiente e evitar custos desnecessários.

Próximas etapas

O que são modelos da CLI do Desenvolvedor do Azure?