Gerir ferramentas de desenvolvimento Azure com azd tool

A Azure Developer CLI (azd) inclui um grupo de comandos azd tool incorporado para descobrir, instalar, atualizar e verificar o estado das ferramentas comuns usadas para construir e lançar aplicações Azure. Envolve os gestores de pacotes subjacentes em cada plataforma (como winget, brew, apt, npm, e a CLI VS Code code ) atrás de um conjunto consistente de subcomandos, e suporta tanto o uso interativo como a automação.

Casos de uso comuns para azd tool incluem:

• Instalar todas as ferramentas de desenvolvimento Azure recomendadas numa nova máquina com um único comando.
• Padronizar o ambiente de desenvolvimento numa equipa ou conjunto de agentes de CI.
• Auditar quais as ferramentas do Azure (e quais as versões) instaladas numa determinada máquina.
• Verificar e aplicar atualizações às ferramentas instaladas.
• Configuração da ferramenta de criação de scripts em pipelines com opções não interativas e saída em JSON.

Ferramentas incorporadas

O registo incorporado inclui as seguintes ferramentas. Use as colunas de categoria e prioridade para determinar quais as ferramentas que se aplicam a um dado fluxo de trabalho.

A estratégia exata de instalação depende do sistema operativo e dos gestores de pacotes disponíveis na máquina.

Visão geral dos comandos

O azd tool grupo de comando inclui os seguintes subcomandos.

Todos os comandos suportam a saída --output json legível por máquinas, adequada para scripts e pipelines.

Para competências de ferramenta, a saída JSON lista cada competência para cada agente e inclui um agent campo. Por exemplo:

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

Bandeiras comuns

As seguintes bandeiras estão disponíveis em install e upgrade:

• --all: Instala ou melhora todas as ferramentas elegíveis. Para install, este comando inclui todas as ferramentas recomendadas. Para upgrade, este comando inclui todas as ferramentas instaladas que têm atualizações disponíveis.

Os installcomandos , upgrade, and uninstall suportam --dry-run pré-visualizar ações sem fazer alterações.

As seguintes opções controlam o comportamento dos prompts:

• azd pode correr automaticamente em modo não interativo quando deteta um ambiente CI/CD ou agente de IA.
• --no-prompt: Suprime explicitamente pedidos interativos.
• AZD_NON_INTERACTIVE=true: Suprime explicitamente pedidos interativos.
• AZD_NON_INTERACTIVE=false: Mantém explicitamente o prompting ativado, mesmo em ambientes detetados de CI/CD ou agentes de IA.
• Os valores explícitos de --no-prompt e AZD_NON_INTERACTIVE substituem a deteção automática do ambiente.

Exemplo de caso de uso: arrancar uma máquina de desenvolvimento

Para configurar o conjunto completo de ferramentas de desenvolvimento Azure recomendadas numa nova máquina, execute o seguinte comando:

azd tool install --all

Este comando instala todas as ferramentas marcadas como recommended no registo usando o gestor de pacotes apropriado para a plataforma atual. Para pré-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 atualizadas, execute os seguintes comandos:

azd tool check
azd tool upgrade --all

Lista de ferramentas instaladas e disponíveis

Execute azd tool list para mostrar todas as ferramentas registadas, o seu estado de instalação e a 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 devolver os mesmos dados em JSON para scripts, execute:

azd tool list --output json

Mostrar detalhes para 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 suportada e ao site do projeto:

azd tool show az-cli

Instale 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, utilize --all:

azd tool install --all

Para pré-visualizar os comandos de instalação sem os executar, adicione --dry-run:

azd tool install az-cli --dry-run

Executar azd tool sem subcomando inicia um fluxo interativo que mostra as ferramentas instaladas, permite a seleção de ferramentas adicionais e instala-as numa única etapa.

Verifique atualizações

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

azd tool check

Ferramentas de atualização

Atualize ferramentas específicas fornecendo os respetivos valores id:

azd tool upgrade az-cli github-copilot-cli

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

azd tool upgrade --all

Pré-visualize o plano de atualização sem o aplicar:

azd tool upgrade --all --dry-run

Desinstalar ferramentas

Remova uma ou mais ferramentas passando os seus id valores.

azd tool uninstall az-cli azure-mcp-server

Pré-visualize 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 de forma interativa. Para remover uma habilidade de um agente de IA específico, use --agent.

azd tool uninstall my-skill --agent copilot

Adiciona --output json quando precisares do resultado de remoção num script ou pipeline.

Experiência de estreia

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

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

• Passe --no-prompt no comando.
• Defina a variável AZD_NON_INTERACTIVE=trueambiente .
• Executar num ambiente de CI/CD ou de agente de IA detetado. azd Pode contornar automaticamente os prompts interativos.

Para manter o prompting ativado num ambiente de CI/CD ou agente de IA detetado, defina AZD_NON_INTERACTIVE=false. Os valores explícitos --no-prompt e AZD_NON_INTERACTIVE sobrepõem-se à deteção automática.

CI e cenários não interativos

O azd tool grupo de comandos suporta pipelines e scripts através das seguintes opções:

• Use argumentos posicionais id com install, upgrade, e uninstall para evitar a seleção interativa.
• Adicionar --no-prompt, definir AZD_NON_INTERACTIVE=trueou depender da deteção automática em ambientes CI/CD ou agentes de IA para suprimir os prompts.
• Defina AZD_NON_INTERACTIVE=false para optar por não usar a deteção automática e manter os prompts ativados em ambientes CI/CD ou agentes de IA.
• Os valores explícitos --no-prompt e AZD_NON_INTERACTIVE sobrepõem-se à deteção automática.
• Use --output json para captar resultados estruturados para os passos posteriores.

O exemplo seguinte instala a CLI do Azure e a extensão Bicep numa etapa de pipeline:

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

Conteúdo relacionado

• O que é a CLI do Azure Developer?
• Instale ou atualize a Azure Developer CLI
• Visão geral dos comandos Azure Developer CLI
• Gerir a configuração da CLI do Azure Developer
• Trabalhar com extensões da CLI do Azure Developer