Administración de herramientas de desarrollo de Azure con azd tool

La CLI para desarrolladores de Azure () incluye un grupo de comandos /> integrado winget, brew, apt, npmy la CLI de VS Code code ) detrás de un conjunto coherente de subcomandos y admite tanto el uso interactivo como la automatización.

Entre los casos de uso comunes de azd tool se incluyen:

• Instalar todas las herramientas de desarrollo recomendadas Azure en una nueva máquina con un solo comando.
• Estandarizar el entorno de desarrollo en un equipo o un conjunto de agentes de CI.
• Auditoría de qué herramientas Azure (y qué versiones) se instalan en un equipo determinado.
• Comprobar y aplicar actualizaciones a las herramientas instaladas.
• Configuración de la herramienta de scripting en canalizaciones mediante marcas no interactivas y salida JSON.

Herramientas integradas

El registro integrado incluye las siguientes herramientas. Use las columnas de categoría y prioridad para determinar qué herramientas se aplican a un flujo de trabajo determinado.

Id	Name	Category	Priority	Estrategia de instalación típica
az-cli	CLI de Azure	cli	Recommended	winget / brew / apt
github-copilot-cli	CLI de GitHub Copilot	cli	Recommended	winget / brew / npm
vscode-azure-tools	herramientas de Azure (VS Code)	extension	Recommended	CLI de code
vscode-bicep	Bicep (VS Code)	extension	Recommended	CLI de code
vscode-github-copilot	GitHub Copilot (VS Code)	extension	Optional	CLI de code
azure-mcp-server	servidor MCP de Azure	server	Optional	npm
azd-ai-extensions	azd Extensiones de IA	library	Optional	azd extension

La estrategia de instalación exacta depende del sistema operativo y de los administradores de paquetes disponibles en la máquina.

Note

Las extensiones de VS Code requieren que la code CLI esté disponible en .PATH Si code no está disponible, las herramientas aparecen como no instaladas y no se pueden instalar a través de azd tool.

Introducción a los comandos

El azd tool grupo de comandos incluye los siguientes subcomandos.

Comando	Description
azd tool	Inicia un flujo interactivo que muestra las herramientas instaladas y disponibles y solicita que las herramientas se instalen en un paso.
azd tool list	Enumera todas las herramientas registradas, incluido el estado de instalación, la versión, la categoría y la prioridad.
azd tool show <id>	Muestra información detallada para una herramienta específica, incluidas las estrategias de instalación por plataforma y el sitio web del proyecto.
azd tool check	Comprueba las herramientas instaladas para ver las actualizaciones disponibles.
azd tool install [ids...]	Instala una o varias herramientas mediante id.
azd tool upgrade [ids...]	Actualiza una o varias herramientas instaladas.
azd tool uninstall [ids...]	Quita una o varias herramientas. ids Omitir para seleccionar herramientas de forma interactiva. Admite la eliminación masiva, --dry-runy --output json.

Todos los comandos admiten --output json para una salida en un formato legible por máquina, adecuada para scripts y canalizaciones.

En el caso de las aptitudes de herramientas, la salida JSON muestra cada aptitud para cada agente e incluye un agent campo. Por ejemplo:

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

Marcas comunes

Las marcas siguientes están disponibles en install y upgrade:

• --all: instala o actualiza todas las herramientas aptas. Para install, este comando incluye todas las herramientas recomendadas. Para upgrade, este comando incluye todas las herramientas instaladas que tienen actualizaciones disponibles.

Los installcomandos , upgradey uninstall admiten --dry-run acciones de vista previa sin realizar cambios.

Las siguientes opciones controlan el comportamiento de las indicaciones:

• azd se puede ejecutar automáticamente en modo no interactivo cuando detecta un entorno de agente de CI/CD o AI.
• --no-prompt: suprime explícitamente las solicitudes interactivas.
• AZD_NON_INTERACTIVE=true: suprime explícitamente las solicitudes interactivas.
• AZD_NON_INTERACTIVE=false: mantiene explícitamente activadas las solicitudes, incluso en entornos detectados de CI/CD o de agentes de IA.
• Los valores explícitos --no-prompt y AZD_NON_INTERACTIVE anulan la detección automática del entorno.

Caso de uso de ejemplo: arranque de una máquina de desarrollo

Para configurar el conjunto completo de herramientas de desarrollo de Azure recomendadas en una nueva máquina, ejecute el siguiente comando:

azd tool install --all

Este comando instala todas las herramientas marcadas como recommended en el Registro mediante el administrador de paquetes adecuado para la plataforma actual. Para obtener una vista previa de las acciones de instalación sin realizar cambios, agregue --dry-run:

azd tool install --all --dry-run

Para mantener las herramientas instaladas actuales, ejecute los siguientes comandos:

azd tool check
azd tool upgrade --all

Enumerar las herramientas instaladas y disponibles

Ejecute azd tool list para mostrar todas las herramientas registradas, su estado de instalación y su versión 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 los mismos datos en formato JSON para su uso en scripts, ejecute:

azd tool list --output json

Mostrar detalles de una herramienta

Ejecute azd tool show <id> para inspeccionar una herramienta específica, incluidas las estrategias de instalación que se aplican a cada plataforma compatible y al sitio web del proyecto:

azd tool show az-cli

Instalación de una o varias herramientas

Pase uno o varios valores de herramienta id para instalar herramientas específicas:

azd tool install az-cli vscode-bicep

Para instalar todas las herramientas recomendadas, use --all:

azd tool install --all

Para obtener una vista previa de los comandos de instalación sin ejecutarlos, agregue --dry-run:

azd tool install az-cli --dry-run

La ejecución azd tool sin subcomando inicia un flujo interactivo que muestra las herramientas instaladas, permite seleccionar herramientas adicionales e instalarlas en un solo paso.

Buscar actualizaciones

Ejecute azd tool check para examinar las herramientas instaladas para ver las actualizaciones disponibles:

azd tool check

Herramientas de actualización

Actualice herramientas específicas pasando sus id valores:

azd tool upgrade az-cli github-copilot-cli

Actualice todo lo que tiene una actualización disponible:

azd tool upgrade --all

Obtenga una vista previa del plan de actualización sin aplicarlo:

azd tool upgrade --all --dry-run

Herramientas de desinstalación

Quite una o varias herramientas pasando sus id valores.

azd tool uninstall az-cli azure-mcp-server

Obtenga una vista previa de una eliminación sin realizar cambios:

azd tool uninstall vscode-bicep --dry-run

Ejecute azd tool uninstall sin identificadores de herramientas para seleccionar herramientas de forma interactiva. Para quitar una aptitud de un agente de IA específico, use --agent.

azd tool uninstall my-skill --agent copilot

Agregue --output json cuando necesite el resultado de eliminación en un script o canalización.

Experiencia de primer uso

Para detectar e instalar las herramientas de desarrollo recomendadas Azure, ejecute azd tool explícitamente. A diferencia de las versiones anteriores, los comandos de flujo de trabajo como azd init, azd upy azd deploy ya no desencadenan una solicitud automática de comprobación de herramientas.

Use cualquiera de las siguientes opciones para omitir avisos interactivos al ejecutar azd tool comandos:

• Pase --no-prompt en el comando.
• Establezca la variable AZD_NON_INTERACTIVE=truede entorno .
• Ejecute en un entorno de agente de INTELIGENCIA ARTIFICIAL o CI/CD detectado. azd puede omitir automáticamente las solicitudes interactivas.

Para mantener habilitadas las solicitudes de confirmación en un entorno de CI/CD o de agente de IA detectado, configure AZD_NON_INTERACTIVE=false. Los valores explícitos --no-prompt y AZD_NON_INTERACTIVE anulan la detección automática.

Escenarios de CI y no interactivos

El azd tool grupo de comandos admite canalizaciones y scripts a través de las siguientes opciones:

• Use argumentos posicionales id con install, upgradey uninstall para evitar la selección interactiva.
• Añade --no-prompt, establece AZD_NON_INTERACTIVE=true o confía en la detección automática en entornos de CI/CD o de agentes de IA para suprimir las indicaciones.
• Configure AZD_NON_INTERACTIVE=false para desactivar la detección automática y mantener activadas las solicitudes en entornos de CI/CD o de agentes de IA.
• Los valores explícitos --no-prompt y AZD_NON_INTERACTIVE anulan la detección automática.
• Usa --output json para capturar resultados estructurados para los pasos posteriores.

En el ejemplo siguiente se instala el CLI de Azure y la extensión Bicep en un paso de canalización:

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

Contenido relacionado

• ¿Qué es Azure Developer CLI?
• Instalar o actualizar la CLI de Azure Developer
• Introducción a los comandos de la CLI para desarrolladores de Azure
• Administrar la configuración de Azure Developer CLI
• Trabajar con extensiones de Azure Developer CLI