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.

För verktygsfärdigheter listar JSON-utdata varje färdighet för varje agent och innehåller ett agent fält. Ett exempel:

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

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.

Kommandona install, upgradeoch uninstall stöder --dry-run förhandsgranskningsåtgärder utan att göra ändringar.

Följande alternativ styr beteendet för uppmaningar:

• azd kan automatiskt köras i icke-interaktivt läge när den identifierar en CI/CD- eller AI-agentmiljö.
• --no-prompt: Undertrycker uttryckligen interaktiva frågor.
• AZD_NON_INTERACTIVE=true: Undertrycker uttryckligen interaktiva frågor.
• AZD_NON_INTERACTIVE=false: Håller uttryckligen interaktiva frågor aktiverade, även i upptäckta CI/CD- eller AI-agentmiljöer.
• Explicita --no-prompt värden och AZD_NON_INTERACTIVE värden åsidosätter automatisk identifiering av miljön.

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

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

Avinstallera verktyg

Ta bort ett eller flera verktyg genom att skicka deras id värden.

azd tool uninstall az-cli azure-mcp-server

Förhandsgranska en borttagning utan att göra ändringar:

azd tool uninstall vscode-bicep --dry-run

Kör azd tool uninstall utan verktygs-ID för att välja verktyg interaktivt. Om du vill ta bort en färdighet från en specifik AI-agent använder du --agent.

azd tool uninstall my-skill --agent copilot

Lägg till --output json när du behöver borttagningsresultatet i ett skript eller en pipeline.

Upplevelse vid första körningen

Kör azd tool uttryckligen för att hitta och installera rekommenderade Azure-utvecklingsverktyg. Till skillnad från tidigare versioner utlöser arbetsflödeskommandon som azd init, azd upoch azd deploy inte längre en automatisk knappkontrollsprompt.

Använd något av följande alternativ för att hoppa över interaktiva frågor när du kör azd tool kommandon:

• Skicka --no-prompt kommandot vidare.
• Ange miljövariabeln AZD_NON_INTERACTIVE=true.
• Kör i en identifierad CI/CD- eller AI-agentmiljö. azd kan automatiskt kringgå interaktiva frågor.

Om du vill fortsätta ha uppmaningar aktiverade i en identifierad CI/CD- eller AI-agentmiljö anger du AZD_NON_INTERACTIVE=false. Explicita --no-prompt värden och AZD_NON_INTERACTIVE värden åsidosätter automatisk identifiering.

CI och icke-interaktiva scenarier

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

• Använd positionsargument id med install, upgradeoch uninstall för att undvika interaktiv markering.
• Lägg till --no-prompt, ange AZD_NON_INTERACTIVE=trueeller förlita dig på automatisk identifiering i CI/CD- eller AI-agentmiljöer för att förhindra uppmaningar.
• Ange AZD_NON_INTERACTIVE=false för att välja bort automatisk detektering och låta uppmaningar förbli aktiverade i CI/CD- eller AI-agentmiljöer.
• Explicita --no-prompt värden och AZD_NON_INTERACTIVE värden åsidosätter automatisk identifiering.
• Använd --output json för att samla in strukturerade resultat för nedströmssteg.

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