Hantera Azure utvecklingsverktyg medazd tool

Azure Developer CLI (azd) innehåller en inbyggd azd tool kommandogrupp för att identifiera, installera, uppgradera och kontrollera statusen för vanliga verktyg som används för att skapa och skicka Azure program. Den omsluter underliggande pakethanterare på varje plattform (till exempel winget, brew, apt, npmoch VS Code code CLI) bakom en konsekvent uppsättning underkommandon och stöder både interaktiv användning och automatisering.

Vanliga användningsfall för azd tool är:

• Installera alla rekommenderade Azure utvecklingsverktyg på en ny dator med ett enda kommando.
• Standardisera utvecklingsmiljön i ett team eller en uppsättning CI-agenter.
• Granska vilka Azure verktyg (och vilka versioner) som är installerade på en viss dator.
• Söka efter och tillämpa uppdateringar på installerade verktyg.
• Konfiguration av skriptverktyg i pipelines med icke-interaktiva flaggor och JSON-utdata.

Inbyggda verktyg

Det inbyggda registret innehåller följande verktyg. Använd kolumnerna kategori och prioritet för att avgöra vilka verktyg som gäller för ett visst arbetsflöde.

Den exakta installationsstrategin beror på operativsystemet och de pakethanterare som är tillgängliga på datorn.

Översikt över kommandon

Kommandogruppen azd tool innehåller följande underkommandon.

Alla kommandon stöder --output json för maskinläsbara utdata som lämpar sig för skript och pipelines.

Vanliga flaggor

Följande flaggor är tillgängliga på install och upgrade:

• --all: Installerar eller uppgraderar alla berättigade verktyg. För installinnehåller det här kommandot alla rekommenderade verktyg. För upgradeinnehåller det här kommandot alla installerade verktyg som har tillgängliga uppdateringar.
• --dry-run: Förhandsgranskar de åtgärder azd som skulle utföras utan att göra några ändringar.

Följande alternativ styr beteendet för uppmaningar:

• --no-prompt: Undertrycker interaktiva frågor. Användbart i skript.
• AZD_NON_INTERACTIVE=true: Miljövariabel som motsvarar --no-prompt.
• AZD_SKIP_FIRST_RUN=true: Inaktiverar uppmaningen om kontroll av verktyg vid första körningen.

Exempel på användningsscenario: konfigurera en utvecklingsdator från grunden

Kör följande kommando för att konfigurera den fullständiga uppsättningen rekommenderade Azure utvecklingsverktyg på en ny dator:

azd tool install --all

Det här kommandot installerar alla verktyg som markerats som recommended i registret med hjälp av lämplig pakethanterare för den aktuella plattformen. Om du vill förhandsgranska installationsåtgärderna utan att göra ändringar lägger du till --dry-run:

azd tool install --all --dry-run

Kör följande kommandon för att hålla installerade verktyg aktuella:

azd tool check
azd tool upgrade --all

Lista installerade och tillgängliga verktyg

Kör azd tool list för att visa varje registrerat verktyg, dess installationsstatus och dess installerade version:

$ 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

Om du vill returnera samma data som JSON för skriptkörning kör du:

azd tool list --output json

Visa information för ett verktyg

Kör azd tool show <id> för att inspektera ett specifikt verktyg, inklusive de installationsstrategier som gäller för varje plattform som stöds och projektwebbplatsen:

azd tool show az-cli

Installera ett eller flera verktyg

Skicka ett eller flera värden för verktyg id för att installera specifika verktyg:

azd tool install az-cli vscode-bicep

Om du vill installera alla rekommenderade verktyg använder du --all:

azd tool install --all

Om du vill förhandsgranska installationskommandona utan att köra dem lägger du till --dry-run:

azd tool install az-cli --dry-run

När du kör azd tool utan underkommando startar ett interaktivt flöde som visar installerade verktyg, tillåter val av ytterligare verktyg och installerar dem i ett enda steg.

Sök efter uppdateringar

Kör azd tool check för att söka igenom installerade verktyg efter tillgängliga uppdateringar:

azd tool check

azd kör också en periodisk bakgrundsuppdateringskontroll och visar icke-påträngande meddelanden när nyare versioner av registrerade verktyg är tillgängliga.

Uppgraderingsverktyg

Uppgradera specifika verktyg genom att skicka deras id värden:

azd tool upgrade az-cli github-copilot-cli

Uppgradera allt som har en tillgänglig uppdatering:

azd tool upgrade --all

Förhandsgranska uppgraderingsplanen utan att tillämpa den:

azd tool upgrade --all --dry-run

Upplevelse vid första körningen

Första gången ett arbetsflödeskommando, till exempel azd init, azd upeller azd deploy körs, azd utför en engångsverktygskontroll och uppmanar till att granska eller installera rekommenderade verktyg.

Använd något av följande alternativ för att hoppa över eller inaktivera den första körningsprompten:

• Ange --no-prompt i arbetsflödeskommandot.
• Ange miljövariabeln AZD_SKIP_FIRST_RUN=true.
• Kör i en identifierad CI-miljö. azd kringgår automatiskt uppmaningen när CI, TF_BUILD eller GITHUB_ACTIONS är inställt.

CI och icke-interaktiva scenarier

Kommandogruppen azd tool stöder pipelines och skript via följande alternativ:

• Använd positionella id argument med install och upgrade för att undvika interaktiv markering.
• Lägg till --no-prompt eller ställ in AZD_NON_INTERACTIVE=true för att ignorera prompter.
• Använd --output json för att samla in strukturerade resultat för nedströmssteg.
• Förlita dig på automatisk identifiering av CI, vilket undertrycker den första körningsprompten och meddelanden om bakgrundsuppdateringar.

I följande exempel installeras Azure CLI och Bicep-tillägget i ett pipelinesteg:

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

Relaterat innehåll

• Vad är Azure Developer CLI?
• Installera eller uppdatera CLI för Azure Developer
• Översikt över CLI-kommandon för Azure Developer
• Hantera CLI-konfiguration för Azure developer
• Arbeta med CLI-tillägg för Azure Developer