Verwalten von Azure Entwicklungstools mit azd tool

Die Azure Developer CLI (azd) enthält eine integrierte azd tool-Befehlsgruppe zum Ermitteln, Installieren, Aktualisieren und Überprüfen des Status allgemeiner Tools, die zum Erstellen und Versenden von Azure Anwendungen verwendet werden. Sie vereinheitlicht die zugrunde liegenden Paketmanager auf den einzelnen Plattformen (z. B. winget, brew, apt, npm und die VS Code-code-CLI) über eine einheitliche Gruppe von Unterbefehlen und unterstützt sowohl die interaktive Nutzung als auch die Automatisierung.

Häufige Anwendungsfälle für azd tool umfassen:

  • Installieren aller empfohlenen Azure Entwicklungstools auf einem neuen Computer mit einem einzigen Befehl.
  • Vereinheitlichung der Entwicklungsumgebung innerhalb eines Teams oder mehrerer CI-Agenten.
  • Überwachung, welche Azure Tools (und welche Versionen) auf einem bestimmten Computer installiert werden.
  • Überprüfen und Anwenden von Updates auf installierte Tools.
  • Einrichtung des Skripting-Tools in den Pipelines mithilfe von nicht-interaktiven Flags und JSON-Ausgabe.

Integrierte Tools

Die integrierte Registrierung enthält die folgenden Tools. Verwenden Sie die Spalten "Kategorie" und "Priorität", um zu bestimmen, welche Tools für einen bestimmten Workflow gelten.

ID Name Kategorie Priorität Typische Installationsstrategie
az-cli Azure CLI cli Empfohlen winget / brew / apt
github-copilot-cli GitHub Copilot-CLI cli Empfohlen winget / brew / npm
vscode-azure-tools Azure-Tools (VS-Code) extension Empfohlen code CLI
vscode-bicep Bicep (VS-Code) extension Empfohlen code CLI
vscode-github-copilot GitHub Copilot (VS-Code) extension Fakultativ code CLI
azure-mcp-server Azure MCP-Server server Fakultativ npm
azd-ai-extensions azd KI-Erweiterungen library Fakultativ azd extension

Die genaue Installationsstrategie hängt vom Betriebssystem und den Auf dem Computer verfügbaren Paketmanagern ab.

Hinweis

VS Code-Erweiterungen erfordern, dass die code CLI auf PATH verfügbar ist. Wenn code nicht verfügbar, werden die Tools als nicht installiert angezeigt, und Sie können sie nicht über azd toolinstallieren.

Übersicht über Befehle

Die azd tool Befehlsgruppe enthält die folgenden Unterbefehle.

Befehl Description
azd tool Startet einen interaktiven Ablauf, der installierte und verfügbare Tools anzeigt und in einem Schritt zur Installation von Tools auffordert.
azd tool list Listet alle registrierten Tools auf, einschließlich Installationsstatus, Version, Kategorie und Priorität.
azd tool show <id> Zeigt detaillierte Informationen für ein bestimmtes Tool, einschließlich plattformspezifischer Installationsstrategien und der Projektwebsite.
azd tool check Überprüft installierte Tools auf verfügbare Updates.
azd tool install [ids...] Installiert ein oder mehrere Tools mit id.
azd tool upgrade [ids...] Aktualisiert mindestens ein installiertes Tools.
azd tool uninstall [ids...] Entfernt ein oder mehrere Tools. ids Lassen Sie die Auswahl von Tools interaktiv aus. Unterstützt Massenentfernung, --dry-runund --output json.

Alle Befehle unterstützen --output json zur maschinenlesbaren Ausgabe, die für Skripte und Pipelines geeignet ist.

Für Toolkenntnisse listet die JSON-Ausgabe jede Fähigkeit für jeden Agent auf und enthält ein agent Feld. Beispiel:

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

Häufige Flags

Die folgenden Flags sind verfügbar unter install und upgrade:

  • --all: Installiert oder aktualisiert jedes berechtigte Tool. Für install umfasst dieser Befehl alle empfohlenen Tools. Für upgrade umfasst dieser Befehl alle installierten Tools, für die Updates verfügbar sind.

Die installBefehle upgradeund uninstall Befehle unterstützen --dry-run die Vorschauaktionen, ohne Änderungen vorzunehmen.

Die folgenden Optionen steuern das Eingabeaufforderungsverhalten:

  • azd kann automatisch im nicht-interaktiven Modus ausgeführt werden, wenn eine CI/CD- oder KI-Agentenumgebung erkannt wird.
  • --no-prompt: Unterdrückt explizit interaktive Eingabeaufforderungen.
  • AZD_NON_INTERACTIVE=true: Unterdrückt explizit interaktive Eingabeaufforderungen.
  • AZD_NON_INTERACTIVE=false: Hält die Eingabeaufforderung explizit aktiviert, selbst in erkannten CI/CD- oder KI-Agent-Umgebungen.
  • Explizite --no-prompt und AZD_NON_INTERACTIVE Werte setzen die automatische Erkennung der Umgebung außer Kraft.

Beispielanwendungsfall: Bootstrap eines Entwicklungscomputers

Führen Sie den folgenden Befehl aus, um den vollständigen Satz empfohlener Azure Entwicklungstools auf einem neuen Computer einzurichten:

azd tool install --all

Mit diesem Befehl wird jedes Tool installiert, das als recommended in der Registrierung gekennzeichnet ist, indem der entsprechende Paket-Manager für die aktuelle Plattform verwendet wird. Um eine Vorschau der Installationsaktionen anzuzeigen, ohne Änderungen vorzunehmen, fügen Sie Folgendes hinzu --dry-run:

azd tool install --all --dry-run

Führen Sie die folgenden Befehle aus, um die installierten Tools aktuell zu halten:

azd tool check
azd tool upgrade --all

Installierte und verfügbare Tools auflisten

Führen Sie die Ausführung azd tool list aus, um jedes registrierte Tool, seinen Installationsstatus und seine installierte Version anzuzeigen:

$ 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

Um die gleichen Daten wie JSON für Skripting zurückzugeben, führen Sie Folgendes aus:

azd tool list --output json

Anzeigen von Details für ein Tool

Führen Sie die Ausführung azd tool show <id> aus, um ein bestimmtes Tool zu untersuchen, einschließlich der Installationsstrategien, die für jede unterstützte Plattform und die Projektwebsite gelten:

azd tool show az-cli

Installieren eines oder mehrerer Tools

Übergeben Sie einen oder mehrere Werte für das Tool id, um bestimmte Tools zu installieren:

azd tool install az-cli vscode-bicep

Verwenden Sie --all, um alle empfohlenen Werkzeuge zu installieren:

azd tool install --all

Um eine Vorschau der Installationsbefehle anzuzeigen, ohne sie auszuführen, fügen Sie Folgendes hinzu --dry-run:

azd tool install az-cli --dry-run

Wird azd tool ohne Unterbefehl ausgeführt, startet ein interaktiver Ablauf, der installierte Tools anzeigt, die Auswahl zusätzlicher Tools ermöglicht und diese in einem Schritt installiert.

Nach Updates suchen

Führen Sie die Ausführung azd tool check aus, um installierte Tools auf verfügbare Updates zu überprüfen:

azd tool check

Tools aktualisieren

Aktualisieren Sie bestimmte Tools, indem Sie ihre id Werte übergeben:

azd tool upgrade az-cli github-copilot-cli

Aktualisieren Sie alles, was über ein verfügbares Update verfügt:

azd tool upgrade --all

Zeigen Sie eine Vorschau des Upgradeplans an, ohne ihn anzuwenden:

azd tool upgrade --all --dry-run

Deinstallationstools

Entfernen Sie ein oder mehrere Tools, indem Sie deren id Werte übergeben.

azd tool uninstall az-cli azure-mcp-server

Zeigen Sie eine Vorschau einer Entfernung an, ohne Änderungen vorzunehmen:

azd tool uninstall vscode-bicep --dry-run

Führen Sie azd tool uninstall ohne Tool-IDs aus, um Tools interaktiv auszuwählen. Um eine Fähigkeit von einem bestimmten KI-Agenten zu entfernen, verwenden Sie --agent.

azd tool uninstall my-skill --agent copilot

Fügen Sie hinzu --output json , wenn Sie das Entfernungsergebnis in einem Skript oder einer Pipeline benötigen.

Erlebnis beim ersten Start

Führen Sie azd tool explizit aus, um empfohlene Azure-Entwicklungstools zu finden und zu installieren. Im Gegensatz zu früheren Versionen lösen Workflowbefehle wie azd init, azd up und azd deploy keine automatische Eingabeaufforderung für die Tool-Prüfung mehr aus.

Verwenden Sie eine der folgenden Optionen, um interaktive Eingabeaufforderungen beim Ausführen azd tool von Befehlen zu überspringen:

  • Übergeben Sie --no-prompt den Befehl.
  • Legen Sie die Umgebungsvariable AZD_NON_INTERACTIVE=truefest.
  • In einer erkannten CI/CD- oder KI-Agentenumgebung ausführen. azd kann interaktive Eingabeaufforderungen automatisch umgehen.

Um Rückfragen in einer erkannten CI/CD- oder KI-Agent-Umgebung weiterhin zu aktivieren, legen Sie AZD_NON_INTERACTIVE=false fest. Explizite --no-prompt Und AZD_NON_INTERACTIVE Werte setzen die automatische Erkennung außer Kraft.

CI- und nicht interaktive Szenarien

Die azd tool Befehlsgruppe unterstützt Pipelines und Skripts über die folgenden Optionen:

  • Verwenden Sie Positionsargumente id mit install, upgradeund uninstall vermeiden Sie die interaktive Auswahl.
  • Fügen Sie --no-prompt hinzu, legen Sie AZD_NON_INTERACTIVE=true fest oder verlassen Sie sich in CI/CD- oder KI-Agent-Umgebungen auf die automatische Erkennung, um Eingabeaufforderungen zu unterdrücken.
  • Setzen Sie AZD_NON_INTERACTIVE=false, um die automatische Erkennung zu deaktivieren und Eingabeaufforderungen in CI/CD- oder KI-Agent-Umgebungen aktiviert zu lassen.
  • Explizite --no-prompt Und AZD_NON_INTERACTIVE Werte setzen die automatische Erkennung außer Kraft.
  • Verwenden Sie --output json, um strukturierte Ergebnisse für nachgelagerte Schritte zu erfassen.

Im folgenden Beispiel werden die Azure CLI und die Bicep-Erweiterung in einem Pipelineschritt installiert:

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

Verwandte Inhalte

  • Last updated on