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.

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

Introducción a los comandos

El azd tool grupo de comandos incluye los siguientes subcomandos.

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