Gerenciar ferramentas de desenvolvimento Azure com azd tool

A CLI do Desenvolvedor do Azure (azd) inclui um grupo de comandos azd tool interno para descobrir, instalar, atualizar e verificar o status das ferramentas comuns usadas para criar e enviar aplicativos Azure. Ele encapsula os gerenciadores de pacotes subjacentes em cada plataforma (comowinget, , brewapt, npme a CLI do VS Codecode) por trás de um conjunto consistente de subcomandos e dá suporte ao uso interativo e à automação.

Casos de uso comuns para azd tool incluem:

• Instalando todas as ferramentas de desenvolvimento de Azure recomendadas em um novo computador com um único comando.
• Padronizando o ambiente de desenvolvimento em uma equipe ou conjunto de agentes de CI.
• Auditando quais Azure ferramentas (e quais versões) estão instaladas em um determinado computador.
• Verificando e aplicando atualizações a ferramentas instaladas.
• Configuração da ferramenta de script em pipelines usando sinalizadores não interativos e saída JSON.

Ferramentas integradas

O registro integrado inclui as seguintes ferramentas. Use as colunas de categoria e prioridade para determinar quais ferramentas se aplicam a um determinado fluxo de trabalho.

A estratégia exata de instalação depende do sistema operacional e dos gerenciadores de pacotes disponíveis no computador.

Visão geral de comandos

O azd tool grupo de comandos inclui os subcomandos a seguir.

Todos os comandos dão suporte --output json à saída legível pelo computador adequada para scripts e pipelines.

Para habilidades de ferramenta, a saída JSON lista cada habilidade para cada agente e inclui um agent campo. Por exemplo:

{
  "skills": [
    {
      "id": "my-skill",
      "agent": "copilot"
    }
  ]
}

Sinalizadores comuns

As seguintes opções estão disponíveis em install e upgrade:

• --all: instala ou atualiza todas as ferramentas elegíveis. Para install, este comando inclui todas as ferramentas recomendadas. Para upgrade, este comando inclui todas as ferramentas instaladas para as quais há atualizações disponíveis.

Os installcomandos e uninstall os upgradecomandos dão suporte --dry-run a ações de visualização sem fazer alterações.

As seguintes opções controlam o comportamento de solicitação:

• azd pode ser executado automaticamente no modo não interativo quando detecta um ambiente de CI/CD ou agente de IA.
• --no-prompt: suprime explicitamente os prompts interativos.
• AZD_NON_INTERACTIVE=true: suprime explicitamente os prompts interativos.
• AZD_NON_INTERACTIVE=false: mantém explicitamente as solicitações habilitadas, mesmo em ambientes de CI/CD ou de agente de IA detectados.
• Valores explícitos de --no-prompt e AZD_NON_INTERACTIVE substituem a detecção automática do ambiente.

Caso de uso de exemplo: inicializar um computador de desenvolvimento

Para configurar o conjunto completo de ferramentas de desenvolvimento de Azure recomendadas em um novo computador, execute o seguinte comando:

azd tool install --all

Esse comando instala todas as ferramentas marcadas como recommended no Registro usando o gerenciador de pacotes apropriado para a plataforma atual. Para visualizar as ações de instalação sem fazer alterações, adicione --dry-run:

azd tool install --all --dry-run

Para manter as ferramentas instaladas atuais, execute os seguintes comandos:

azd tool check
azd tool upgrade --all

Listar ferramentas instaladas e disponíveis

Execute azd tool list para exibir todas as ferramentas registradas, seu status de instalação e sua versão instalada:

$ azd tool list

  Id                     Name                      Category    Priority      Status          Version
  ─────────────────────  ────────────────────────  ──────────  ────────────  ──────────────  ────────
  az-cli                 Azure CLI                 cli         recommended   Installed       2.67.0
  github-copilot-cli     GitHub Copilot CLI        cli         recommended   Not Installed
  vscode-azure-tools     Azure Tools (VS Code)     extension   recommended   Installed       0.9.0
  vscode-bicep           Bicep (VS Code)           extension   recommended   Installed       0.30.0
  vscode-github-copilot  GitHub Copilot (VS Code)  extension   optional      Not Installed
  azure-mcp-server       Azure MCP Server          server      optional      Not Installed
  azd-ai-extensions      azd AI Extensions         library     optional      Not Installed

Para retornar os mesmos dados que JSON para script, execute:

azd tool list --output json

Mostrar detalhes de uma ferramenta

Execute azd tool show <id> para inspecionar uma ferramenta específica, incluindo as estratégias de instalação que se aplicam a cada plataforma com suporte e ao site do projeto:

azd tool show az-cli

Instalar uma ou mais ferramentas

Passe um ou mais valores de ferramenta id para instalar ferramentas específicas:

azd tool install az-cli vscode-bicep

Para instalar todas as ferramentas recomendadas, use --all:

azd tool install --all

Para visualizar os comandos de instalação sem executá-los, adicione --dry-run:

azd tool install az-cli --dry-run

A execução azd tool sem subcomando inicia um fluxo interativo que exibe as ferramentas instaladas, permite a seleção de ferramentas adicionais e as instala em uma única etapa.

Verificar se há atualizações

Execute azd tool check para verificar as ferramentas instaladas para obter atualizações disponíveis:

azd tool check

Ferramentas de atualização

Atualize ferramentas específicas passando seus id valores:

azd tool upgrade az-cli github-copilot-cli

Atualize tudo o que tem uma atualização disponível:

azd tool upgrade --all

Visualizar o plano de atualização sem aplicá-lo:

azd tool upgrade --all --dry-run

Desinstalar ferramentas

Remova uma ou mais ferramentas passando seus id valores.

azd tool uninstall az-cli azure-mcp-server

Visualizar uma remoção sem fazer alterações:

azd tool uninstall vscode-bicep --dry-run

Execute azd tool uninstall sem IDs de ferramenta para selecionar ferramentas interativamente. Para remover uma habilidade de um agente de IA específico, use --agent.

azd tool uninstall my-skill --agent copilot

Adicione --output json quando você precisar do resultado da remoção em um script ou pipeline.

Experiência de primeira execução

Para descobrir e instalar as ferramentas de desenvolvimento de Azure recomendadas, execute azd tool explicitamente. Ao contrário das versões anteriores, comandos de fluxo de trabalho, como azd init, azd upe azd deploy não disparam mais um prompt automático de verificação de ferramentas.

Use qualquer uma das seguintes opções para ignorar prompts interativos ao executar azd tool comandos:

• Passe --no-prompt no comando.
• Defina a variável AZD_NON_INTERACTIVE=truede ambiente.
• Execute em um ambiente detectado de CI/CD ou de agente de IA. azd pode contornar automaticamente solicitações interativas.

Para manter as solicitações de confirmação habilitadas em um ambiente de CI/CD ou de agente de IA detectado, defina AZD_NON_INTERACTIVE=false. Explícitos --no-prompt e AZD_NON_INTERACTIVE valores substituem a detecção automática.

CI e cenários não interativos

O azd tool grupo de comandos dá suporte a pipelines e scripts por meio das seguintes opções:

• Use argumentos posicionais id com install, upgradee uninstall para evitar seleção interativa.
• Adicione --no-prompt, defina AZD_NON_INTERACTIVE=true ou conte com a detecção automática em ambientes de CI/CD ou de agentes de IA para evitar prompts.
• Defina AZD_NON_INTERACTIVE=false para desativar a detecção automática e manter os prompts ativados em ambientes de CI/CD ou de agentes de IA.
• Explícitos --no-prompt e AZD_NON_INTERACTIVE valores substituem a detecção automática.
• Use --output json para capturar resultados estruturados para etapas subsequentes.

O exemplo a seguir instala o CLI do Azure e a extensão Bicep em uma etapa de pipeline:

azd tool install az-cli vscode-bicep --no-prompt --output json

Conteúdo relacionado

• O que é o Azure Developer CLI?
• Instale ou atualize a CLI do Desenvolvedor Azure
• Visão geral dos comandos da CLI do Desenvolvedor do Azure
• Gerenciar a configuração da CLI para Desenvolvedores do Azure
• Trabalhe com extensões do Azure Developer CLI