Správa vývojových nástrojů pro Azure pomocí azd tool

Rozhraní příkazového řádku pro vývojáře Azure (azd) obsahuje integrovanou skupinu příkazů azd tool pro zjišťování, instalaci, upgrade a kontrolu stavu běžných nástrojů používaných k sestavování a dodávání aplikací Azure. Zabalí základní správce balíčků na každé platformě (například winget, brew, apt, npma rozhraní příkazového řádku VS Code code ) za konzistentní sadou dílčích příkazů a podporuje interaktivní použití i automatizaci.

Mezi běžné případy použití patří azd tool :

  • Instalace všech doporučených Azure vývojových nástrojů na nový počítač pomocí jediného příkazu
  • Standardizace vývojového prostředí napříč týmem nebo sadou agentů CI.
  • Auditování, které Azure nástroje (a které verze) jsou na daném počítači nainstalované.
  • Kontrola a instalace aktualizací u nainstalovaných nástrojů
  • Nastavení nástroje pro skriptování v pipelinech pomocí neinteraktivních příznaků a výstupu ve formátu JSON

Integrované nástroje

Integrovaný registr obsahuje následující nástroje. Pomocí sloupců kategorií a priority určete, které nástroje se vztahují na daný pracovní postup.

identifikační číslo Name Category Priority Typická strategie instalace
az-cli Azure CLI cli Doporučený winget / brew / apt
github-copilot-cli rozhraní příkazového řádku GitHub Copilot cli Doporučený winget / brew / npm
vscode-azure-tools nástroje Azure (VS Code) extension Doporučený code ROZHRANÍ příkazového řádku
vscode-bicep Bicep (VS Code) extension Doporučený code ROZHRANÍ příkazového řádku
vscode-github-copilot GitHub Copilot (VS Code) extension Optional code ROZHRANÍ příkazového řádku
azure-mcp-server Azure MCP Server server Optional npm
azd-ai-extensions azd Rozšíření AI library Optional azd extension

Přesná strategie instalace závisí na operačním systému a správci balíčků dostupných na počítači.

Note

Rozšíření VS Code vyžadují, aby bylo rozhraní příkazového řádku code dostupné v prostředí PATH. Pokud code není k dispozici, nástroje se zobrazí jako nenainstalované a nemůžete je nainstalovat prostřednictvím azd tool.

Přehled příkazů

Skupina azd tool příkazů obsahuje následující dílčí příkazy.

Command Description
azd tool Spustí interaktivní tok, který zobrazuje nainstalované a dostupné nástroje a zobrazí výzvu k instalaci nástrojů v jednom kroku.
azd tool list Zobrazí seznam všech registrovaných nástrojů, včetně stavu instalace, verze, kategorie a priority.
azd tool show <id> Zobrazuje podrobné informace o konkrétním nástroji, včetně strategií instalace jednotlivých platforem a webu projektu.
azd tool check Kontroluje nainstalované nástroje pro dostupné aktualizace.
azd tool install [ids...] Nainstaluje jeden či více nástrojů pomocí id.
azd tool upgrade [ids...] Upgraduje jeden nebo více nainstalovaných nástrojů.
azd tool uninstall [ids...] Odebere jeden nebo více nástrojů. Vynechání ids interaktivního výběru nástrojů Podporuje hromadné odebrání, --dry-runa --output json.

Všechny příkazy podporují --output json pro strojově čitelný výstup vhodný pro skripty a roury.

Pro dovednosti nástroje obsahuje výstup JSON každou dovednost pro každého agenta a obsahuje agent pole. Příklady:

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

Běžné příznaky

K dispozici installupgradejsou následující příznaky:

  • --all: Nainstaluje nebo upgraduje každý způsobilý nástroj. Pro install tento příkaz obsahuje všechny doporučené nástroje. Tento upgradepříkaz obsahuje všechny nainstalované nástroje, které mají k dispozici aktualizace.

Příkazy installa uninstall příkazy upgradepodporují --dry-run akce náhledu bez provedení změn.

Následující možnosti řídí chování výzev:

  • azd může automaticky běžet v neinteraktivním režimu, když zjistí prostředí agenta CI/CD nebo AI.
  • --no-prompt: Explicitně potlačí interaktivní výzvy.
  • AZD_NON_INTERACTIVE=true: Explicitně potlačí interaktivní výzvy.
  • AZD_NON_INTERACTIVE=false: Explicitně ponechává výzvy povolené i v rozpoznaných prostředích CI/CD nebo agentů AI.
  • Explicitní hodnoty --no-prompt a AZD_NON_INTERACTIVE mají přednost před automatickou detekcí prostředí.

Ukázkový případ použití: bootstrap vývojového počítače

Pokud chcete nastavit kompletní sadu doporučených Azure vývojových nástrojů na novém počítači, spusťte následující příkaz:

azd tool install --all

Tento příkaz nainstaluje všechny nástroje označené jako recommended v registru pomocí příslušného správce balíčků pro aktuální platformu. Pokud chcete zobrazit náhled akcí instalace bez provedení změn, přidejte --dry-run:

azd tool install --all --dry-run

Pokud chcete udržovat nainstalované nástroje aktuální, spusťte následující příkazy:

azd tool check
azd tool upgrade --all

Výpis nainstalovaných a dostupných nástrojů

Spusťte azd tool list a zobrazte všechny registrované nástroje, jejich stav instalace a nainstalovanou verzi:

$ 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

Pokud chcete vrátit stejná data jako JSON pro skriptování, spusťte:

azd tool list --output json

Zobrazení podrobností o nástroji

Spusťte azd tool show <id> kontrolu konkrétního nástroje, včetně strategií instalace, které platí pro každou podporovanou platformu a web projektu:

azd tool show az-cli

Instalace jednoho nebo více nástrojů

Předáním jedné nebo více hodnot nástrojů id nainstalujte konkrétní nástroje:

azd tool install az-cli vscode-bicep

Pokud chcete nainstalovat každý doporučený nástroj, použijte --all:

azd tool install --all

Pokud chcete zobrazit náhled instalačních příkazů bez jejich spuštění, přidejte --dry-run:

azd tool install az-cli --dry-run

Spuštění azd tool bez podpříkazu spustí interaktivní tok, který zobrazí nainstalované nástroje, umožní výběr dalších nástrojů a nainstaluje je v jednom kroku.

Kontrola aktualizací

Spusťte azd tool check kontrolu nainstalovaných nástrojů pro dostupné aktualizace:

azd tool check

Nástroje pro upgrade

Upgradujte konkrétní nástroje předáním jejich id hodnot:

azd tool upgrade az-cli github-copilot-cli

Upgradujte vše, co má dostupnou aktualizaci:

azd tool upgrade --all

Zobrazte náhled plánu aktualizace bez jeho použití:

azd tool upgrade --all --dry-run

Nástroje pro odinstalaci

Odeberte jeden nebo více nástrojů předáním jejich id hodnot.

azd tool uninstall az-cli azure-mcp-server

Zobrazení náhledu odebrání bez provedení změn:

azd tool uninstall vscode-bicep --dry-run

Interaktivní výběr nástrojů spustíte azd tool uninstall bez ID nástrojů. Pokud chcete odebrat dovednost od konkrétního agenta umělé inteligence, použijte --agent.

azd tool uninstall my-skill --agent copilot

Přidejte --output json , když potřebujete výsledek odebrání ve skriptu nebo kanálu.

První spuštění

Pokud chcete zjistit a nainstalovat doporučené Azure vývojové nástroje, spusťte azd tool explicitně. Na rozdíl od předchozích verzí již příkazy pracovního postupu, jako jsou azd init, azd up a azd deploy, nespouštějí automatickou výzvu ke kontrole nástroje.

Ke přeskočení interaktivních výzev při spouštění azd tool příkazů použijte některou z následujících možností:

  • Předejte v příkazu --no-prompt.
  • Nastavte proměnnou prostředí AZD_NON_INTERACTIVE=true.
  • Spustit v rozpoznaném prostředí CI/CD nebo v prostředí agenta AI. azd může automaticky obejít interaktivní výzvy.

Chcete-li ponechat výzvy zapnuté v rozpoznaném prostředí CI/CD nebo AI agenta, nastavte AZD_NON_INTERACTIVE=false. Explicitně zadané hodnoty --no-prompt a AZD_NON_INTERACTIVE mají přednost před automatickým zjišťováním.

Ci a neinteraktivní scénáře

Skupina azd tool příkazů podporuje kanály a skripty prostřednictvím následujících možností:

  • Použijte poziční id argumenty se znakem install, upgradea uninstall vyhněte se interaktivnímu výběru.
  • Přidejte --no-prompt, nastavte AZD_NON_INTERACTIVE=true nebo se spolehněte na automatickou detekci v prostředích CI/CD nebo agentů AI, aby se potlačily dotazy.
  • Nastavte AZD_NON_INTERACTIVE=false, chcete-li vypnout automatickou detekci a ponechat výzvy povolené v prostředích CI/CD nebo agentů AI.
  • Explicitně zadané hodnoty --no-prompt a AZD_NON_INTERACTIVE mají přednost před automatickým zjišťováním.
  • Slouží --output json k zachycení strukturovaných výsledků pro podřízené kroky.

Následující příklad v kroku kanálu nainstaluje Azure CLI a rozšíření Bicep:

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

Související obsah

  • Poslední aktualizace v