Ontwikkelhulpprogramma's voor Azure beheren met azd tool

De Azure Developer CLI (azd) bevat een ingebouwde azd tool opdrachtgroep voor het detecteren, installeren, upgraden en controleren van de status van veelgebruikte hulpprogramma's die worden gebruikt voor het bouwen en verzenden van Azure toepassingen. Het verpakt de onderliggende pakketbeheerders op elk platform (zoals winget, brew, apt, en npmde VS Code code CLI) achter een consistente set subopdrachten en ondersteunt zowel interactief gebruik als automatisering.

Veelvoorkomende gebruiksvoorbeelden zijn azd tool onder andere:

• Installeer alle aanbevolen Azure ontwikkelhulpprogramma's op een nieuwe computer met één opdracht.
• De ontwikkelomgeving standaardiseren binnen een team of een groep CI-agents.
• Controleren welke Azure hulpprogramma's (en welke versies) op een bepaalde computer zijn geïnstalleerd.
• Controleren op en toepassen van updates op geïnstalleerde hulpprogramma's.
• Installatie van scriptprogramma's in pijplijnen met niet-interactieve vlaggen en JSON-uitvoer.

Ingebouwde hulpprogramma's

Het ingebouwde register bevat de volgende hulpprogramma's. Gebruik de categorie- en prioriteitkolommen om te bepalen welke hulpprogramma's van toepassing zijn op een bepaalde werkstroom.

De exacte installatiestrategie is afhankelijk van het besturingssysteem en de pakketbeheerders die beschikbaar zijn op de computer.

Overzicht van opdrachten

De azd tool opdrachtgroep bevat de volgende subopdrachten.

Alle opdrachten bieden ondersteuning --output json voor machineleesbare uitvoer die geschikt is voor scripts en pijplijnen.

Voor toolvaardigheden bevat JSON-uitvoer elke vaardigheid voor elke agent en bevat een agent veld. Voorbeeld:

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

Algemene vlaggen

De volgende vlaggen zijn beschikbaar op install en upgrade:

• --all: Installeert of upgradet elk in aanmerking komend hulpprogramma. Voor install, deze opdracht bevat alle aanbevolen hulpprogramma's. Deze upgradeopdracht bevat alle geïnstalleerde hulpprogramma's waarvoor updates beschikbaar zijn.

De install, upgradeen uninstall opdrachten ondersteunen --dry-run preview-acties zonder wijzigingen aan te brengen.

De volgende opties bepalen het promptgedrag:

• azd kan automatisch worden uitgevoerd in de niet-interactieve modus wanneer een CI/CD- of AI-agentomgeving wordt gedetecteerd.
• --no-prompt: Hiermee worden interactieve prompts expliciet onderdrukt.
• AZD_NON_INTERACTIVE=true: Hiermee worden interactieve prompts expliciet onderdrukt.
• AZD_NON_INTERACTIVE=false: Laat promptverzoeken expliciet ingeschakeld, zelfs in gedetecteerde CI/CD- of AI-agentomgevingen.
• Expliciet --no-prompt en AZD_NON_INTERACTIVE waarden overschrijven automatische detectie van omgevingen.

Voorbeeldtoepassing: een ontwikkelmachine opzetten

Voer de volgende opdracht uit om de volledige set aanbevolen Azure ontwikkelhulpprogramma's op een nieuwe computer in te stellen:

azd tool install --all

Met deze opdracht wordt elk hulpprogramma geïnstalleerd dat is gemarkeerd als recommended in het register met behulp van het juiste pakketbeheer voor het huidige platform. Als u een voorbeeld van de installatieacties wilt bekijken zonder wijzigingen aan te brengen, voegt u het volgende toe --dry-run:

azd tool install --all --dry-run

Voer de volgende opdrachten uit om geïnstalleerde hulpprogramma's actueel te houden:

azd tool check
azd tool upgrade --all

Geïnstalleerde en beschikbare hulpprogramma's weergeven

Voer deze opdracht uit azd tool list om elk geregistreerd hulpprogramma, de installatiestatus en de geïnstalleerde versie weer te geven:

$ 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

Als u dezelfde gegevens wilt retourneren als JSON voor scripting, voert u het volgende uit:

azd tool list --output json

Details voor een hulpprogramma weergeven

Voer azd tool show <id> uit om een specifiek hulpprogramma te inspecteren, inclusief de installatiestrategieën die van toepassing zijn op elk ondersteund platform en de projectwebsite:

azd tool show az-cli

Een of meer hulpprogramma's installeren

Geef een of meer hulpprogrammawaarden id door om specifieke hulpprogramma's te installeren:

azd tool install az-cli vscode-bicep

Als u elk aanbevolen hulpprogramma wilt installeren, gebruikt u --all:

azd tool install --all

Als u een voorbeeld van de installatieopdrachten wilt bekijken zonder deze uit te voeren, voegt u het volgende toe --dry-run:

azd tool install az-cli --dry-run

Als u geen subopdracht uitvoert azd tool , wordt een interactieve stroom gestart waarin geïnstalleerde hulpprogramma's worden weergegeven, extra hulpprogramma's kunnen worden geselecteerd en in één stap worden geïnstalleerd.

Controleren op updates

Uitvoeren azd tool check om geïnstalleerde hulpprogramma's voor beschikbare updates te scannen:

azd tool check

Hulpmiddelen upgraden

Werk specifieke hulpprogramma's bij door hun id waarden door te geven:

azd tool upgrade az-cli github-copilot-cli

Upgrade alles met een beschikbare update:

azd tool upgrade --all

Bekijk een voorbeeld van het upgradeplan zonder dit toe te passen:

azd tool upgrade --all --dry-run

Hulpprogramma's verwijderen

Verwijder een of meer hulpprogramma's door hun waarden door te id geven.

azd tool uninstall az-cli azure-mcp-server

Een voorbeeld van een verwijdering bekijken zonder wijzigingen aan te brengen:

azd tool uninstall vscode-bicep --dry-run

Voer azd tool uninstall zonder hulpprogramma-id's uit om hulpprogramma's interactief te selecteren. Als u een vaardigheid uit een specifieke AI-agent wilt verwijderen, gebruikt u --agent.

azd tool uninstall my-skill --agent copilot

Voeg --output json toe wanneer u het verwijderingsresultaat nodig hebt in een script of pijplijn.

First-run-ervaring

Als u aanbevolen Azure ontwikkelhulpprogramma's wilt detecteren en installeren, voert u deze expliciet uitazd tool. In tegenstelling tot eerdere versies leiden werkstroomopdrachten zoals azd init, azd up en azd deploy niet langer tot een automatische melding om hulpprogramma's te controleren.

Gebruik een van de volgende opties om interactieve prompts over te slaan bij het uitvoeren azd tool van opdrachten:

• Geef de opdracht door --no-prompt .
• Stel de omgevingsvariabele AZD_NON_INTERACTIVE=truein.
• Uitvoeren in een gedetecteerde CI/CD- of AI-agentomgeving. azd kan automatisch interactieve meldingen omzeilen.

Om prompts ingeschakeld te houden in een gedetecteerde CI/CD- of AI-agentomgeving, stelt u AZD_NON_INTERACTIVE=false in. Expliciet --no-prompt en AZD_NON_INTERACTIVE waarden overschrijven automatische detectie.

CI- en niet-interactieve scenario's

De azd tool opdrachtgroep ondersteunt pijplijnen en scripts via de volgende opties:

• Gebruik positionele id argumenten met install, upgradeen uninstall om interactieve selectie te voorkomen.
• Voeg --no-prompt, stel AZD_NON_INTERACTIVE=trueof vertrouw op automatische detectie in CI/CD- of AI-agentomgevingen om prompts te onderdrukken.
• Stel AZD_NON_INTERACTIVE=false in om automatische detectie uit te schakelen en prompts ingeschakeld te houden in CI/CD- of AI-agentomgevingen.
• Expliciet --no-prompt en AZD_NON_INTERACTIVE waarden overschrijven automatische detectie.
• Gebruik --output json dit om gestructureerde resultaten vast te leggen voor downstreamstappen.

In het volgende voorbeeld worden de Azure CLI en de Bicep-extensie in een pijplijnstap geïnstalleerd:

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

Verwante inhoud

• Wat is de Azure Developer CLI?
• De Azure Developer CLI installeren of bijwerken
• Overzicht van Azure Developer CLI-opdrachten
• Beheer Azure Cli-configuratie voor ontwikkelaars
• Werken met Azure Developer CLI-extensies