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 GitHub Copilot CLI cli Doporučený winget / brew / npm
vscode-azure-tools nástroje Azure (VS Code) extension Doporučený code CLI
vscode-bicep Bicep (VS Code) extension Doporučený code CLI
vscode-github-copilot GitHub Copilot (VS Code) extension Optional code CLI
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ů.

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

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.
  • --dry-run: Zobrazí náhled akcí, které by azd provedl, aniž by provedl jakékoli změny.

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

  • --no-prompt: Potlačí interaktivní výzvy. Užitečné ve skriptech.
  • AZD_NON_INTERACTIVE=true: Proměnná prostředí ekvivalentní --no-prompt.
  • AZD_SKIP_FIRST_RUN=true: Zakáže výzvu ke kontrole nástroje při prvním spuštění.

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

azd také spustí pravidelnou kontrolu aktualizace na pozadí a zobrazí nerušivé oznámení, pokud jsou k dispozici novější verze registrovaných nástrojů.

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

První spuštění

Při prvním spuštění příkazu pracovního postupu, například azd init, azd up nebo azd deploy, provede azd jednorázovou kontrolu nástrojů a vyzve ke kontrole nebo instalaci doporučených nástrojů.

Pokud chcete přeskočit nebo zakázat výzvu prvního spuštění, použijte některou z následujících možností:

  • Předejte --no-prompt příkazu workflow.
  • Nastavte proměnnou prostředí AZD_SKIP_FIRST_RUN=true.
  • Spusťte v zjištěném prostředí CI. azd automaticky přeskočí výzvu, když je nastavena možnost CI, TF_BUILD nebo GITHUB_ACTIONS.

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í argumenty id, install a upgrade, abyste se vyhnuli interaktivnímu výběru.
  • Přidejte --no-prompt nebo nastavte AZD_NON_INTERACTIVE=true, aby se potlačily výzvy.
  • Slouží --output json k zachycení strukturovaných výsledků pro podřízené kroky.
  • Spolehněte se na automatickou detekci CI, která potlačí výzvu při prvním spuštění a oznámení o aktualizacích na pozadí.

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

  • Last updated on