Gestire gli strumenti di sviluppo di Azure con azd tool

L'interfaccia della riga di comando Azure Developer (azd) include un gruppo di comandi azd tool predefinito per individuare, installare, aggiornare e controllare lo stato degli strumenti comuni usati per compilare e spedire applicazioni Azure. Racchiude i gestori di pacchetti sottostanti di ogni piattaforma (come winget, brew, apt, npm e la CLI code di VS Code) dietro un insieme coerente di sottocomandi e supporta sia l'uso interattivo sia l'automazione.

I casi d'uso comuni per azd tool includono:

  • Installazione di tutti gli strumenti di sviluppo Azure consigliati in un nuovo computer con un singolo comando.
  • Standardizzare l'ambiente di sviluppo all'interno di un team o di un gruppo di agenti CI.
  • Controllo degli strumenti di Azure (e delle versioni) installati in un determinato computer.
  • Verifica e applicazione degli aggiornamenti agli strumenti installati.
  • Configurazione dello strumento di scripting nelle pipeline con flag non interattivi e output JSON.

Strumenti predefiniti

Il Registro di sistema predefinito include gli strumenti seguenti. Usare le colonne di categoria e priorità per determinare quali strumenti si applicano a un determinato flusso di lavoro.

ID. Name Category Priorità Strategia di installazione tipica
az-cli interfaccia della riga di comando di Azure cli Recommended winget / brew / apt
github-copilot-cli interfaccia della riga di comando (CLI) di GitHub Copilot cli Recommended winget / brew / npm
vscode-azure-tools Azure Tools (VS Code) extension Recommended Interfaccia della riga di comando di code
vscode-bicep Bicep (VS Code) extension Recommended Interfaccia della riga di comando di code
vscode-github-copilot GitHub Copilot (VS Code) extension Optional Interfaccia della riga di comando di code
azure-mcp-server Server MCP di Azure server Optional npm
azd-ai-extensions azd Estensioni per intelligenza artificiale library Optional azd extension

La strategia di installazione esatta dipende dal sistema operativo e dalle gestioni pacchetti disponibili nel computer.

Note

Le estensioni di VS Code richiedono che l'interfaccia a riga di comando code sia disponibile su PATH. Se code non è disponibile, gli strumenti vengono visualizzati come non installati e non è possibile installarli tramite azd tool.

Panoramica dei comandi

Il azd tool gruppo di comandi include i sottocomandi seguenti.

Command Description
azd tool Avvia un flusso interattivo che mostra gli strumenti installati e disponibili e richiede gli strumenti da installare in un unico passaggio.
azd tool list Elenca tutti gli strumenti registrati, inclusi lo stato di installazione, la versione, la categoria e la priorità.
azd tool show <id> Mostra informazioni dettagliate per uno strumento specifico, incluse le strategie di installazione per piattaforma e il sito Web del progetto.
azd tool check Controlla gli strumenti installati per gli aggiornamenti disponibili.
azd tool install [ids...] Installa uno o più strumenti tramite id.
azd tool upgrade [ids...] Aggiorna uno o più strumenti installati.
azd tool uninstall [ids...] Rimuove uno o più strumenti. Omettere ids di selezionare gli strumenti in modo interattivo. Supporta la rimozione in blocco, --dry-rune --output json.

Tutti i comandi supportano l'output --output json leggibile da una macchina, adatto a script e pipeline.

Per le competenze degli strumenti, l'output JSON elenca ogni competenza per ogni agente e include un agent campo. Per esempio:

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

Flag comuni

I flag seguenti sono disponibili in install e upgrade:

  • --all: installa o aggiorna ogni strumento idoneo. Per install, questo comando include tutti gli strumenti consigliati. Per upgrade, questo comando include tutti gli strumenti installati con aggiornamenti disponibili.

I installcomandi , upgradee uninstall supportano --dry-run le azioni di anteprima senza apportare modifiche.

Le seguenti opzioni determinano il comportamento dei prompt:

  • azd può essere eseguito automaticamente in modalità non interattiva quando rileva un ambiente CI/CD o un agente IA.
  • --no-prompt: elimina in modo esplicito le richieste interattive.
  • AZD_NON_INTERACTIVE=true: elimina in modo esplicito le richieste interattive.
  • AZD_NON_INTERACTIVE=false: mantiene esplicitamente abilitati i prompt, anche negli ambienti CI/CD o di agenti IA rilevati.
  • I valori --no-promptesplicitiAZD_NON_INTERACTIVE hanno la precedenza sul rilevamento automatico dell'ambiente.

Caso d'uso di esempio: eseguire il bootstrap di un computer di sviluppo

Per configurare il set completo di strumenti di sviluppo Azure consigliati in un nuovo computer, eseguire il comando seguente:

azd tool install --all

Questo comando installa ogni strumento contrassegnato come recommended nel Registro di sistema usando la gestione pacchetti appropriata per la piattaforma corrente. Per visualizzare in anteprima le azioni di installazione senza apportare modifiche, aggiungere --dry-run:

azd tool install --all --dry-run

Per mantenere aggiornati gli strumenti installati, eseguire i comandi seguenti:

azd tool check
azd tool upgrade --all

Elencare gli strumenti installati e disponibili

Eseguire azd tool list per visualizzare ogni strumento registrato, il relativo stato di installazione e la versione installata:

$ 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

Per restituire gli stessi dati di JSON per lo scripting, eseguire:

azd tool list --output json

Visualizzare i dettagli per uno strumento

Eseguire azd tool show <id> per esaminare uno strumento specifico, incluse le strategie di installazione applicabili a ogni piattaforma supportata e al sito Web del progetto:

azd tool show az-cli

Installare uno o più strumenti

Passare uno o più valori degli strumenti id per installare strumenti specifici:

azd tool install az-cli vscode-bicep

Per installare ogni strumento consigliato, usare --all:

azd tool install --all

Per visualizzare in anteprima i comandi di installazione senza eseguirli, aggiungere --dry-run:

azd tool install az-cli --dry-run

L'esecuzione azd tool senza sottocomando avvia un flusso interattivo che visualizza gli strumenti installati, consente la selezione di strumenti aggiuntivi e li installa in un unico passaggio.

Verificare la disponibilità di aggiornamenti

Eseguire azd tool check per analizzare gli strumenti installati per gli aggiornamenti disponibili:

azd tool check

Strumenti di aggiornamento

Aggiornare strumenti specifici passando i relativi id valori:

azd tool upgrade az-cli github-copilot-cli

Aggiornare tutti gli elementi con un aggiornamento disponibile:

azd tool upgrade --all

Visualizzare in anteprima il piano di aggiornamento senza applicarlo:

azd tool upgrade --all --dry-run

Strumenti di disinstallazione

Rimuovere uno o più strumenti passando i valori id .

azd tool uninstall az-cli azure-mcp-server

Visualizzare in anteprima una rimozione senza apportare modifiche:

azd tool uninstall vscode-bicep --dry-run

Eseguire azd tool uninstall senza ID strumento per selezionare gli strumenti in modo interattivo. Per rimuovere una competenza da un agente di intelligenza artificiale specifico, usare --agent.

azd tool uninstall my-skill --agent copilot

Aggiungere --output json quando è necessario il risultato della rimozione in uno script o in una pipeline.

Esperienza al primo avvio

Per individuare e installare gli strumenti di sviluppo Azure consigliati, eseguire azd tool in modo esplicito. A differenza delle versioni precedenti, i comandi del flusso di lavoro come azd init, azd up e azd deploy non attivano più un prompt automatico di verifica degli strumenti.

Usare una delle opzioni seguenti per ignorare i prompt interattivi durante l'esecuzione azd tool dei comandi:

  • Passare --no-prompt al comando.
  • Impostare la variabile AZD_NON_INTERACTIVE=truedi ambiente .
  • Esegui in un ambiente CI/CD o di agente IA rilevato. azd può ignorare automaticamente le richieste interattive.

Per mantenere abilitato il prompt in un ambiente CI/CD o di un agente di IA rilevato, impostare AZD_NON_INTERACTIVE=false. I valori espliciti --no-prompt e AZD_NON_INTERACTIVE hanno la precedenza sul rilevamento automatico.

Scenari CI e non interattivi

Il azd tool gruppo di comandi supporta pipeline e script tramite le opzioni seguenti:

  • Usare gli argomenti posizionali id con install, upgradee uninstall per evitare la selezione interattiva.
  • Aggiungere --no-prompt, impostare AZD_NON_INTERACTIVE=true o fare affidamento sul rilevamento automatico in ambienti CI/CD o con agenti di IA per disattivare le richieste.
  • Imposta AZD_NON_INTERACTIVE=false per disattivare il rilevamento automatico e mantenere abilitato il prompt negli ambienti CI/CD o degli agenti IA.
  • I valori espliciti --no-prompt e AZD_NON_INTERACTIVE hanno la precedenza sul rilevamento automatico.
  • Usare --output json per acquisire risultati strutturati per i passaggi downstream.

L'esempio seguente installa il interfaccia della riga di comando di Azure e l'estensione Bicep in un passaggio della pipeline:

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

Contenuti correlati

  • Last updated on