Freigeben über

Übersicht über Azure Developer CLI-Erweiterungen

Azure Developer CLI(azd)-Erweiterungen sind modulare Komponenten, die die Funktionalität der Azure Developer CLI erweitern. Sie ermöglichen es Ihnen, neue Funktionen hinzuzufügen, Workflows zu automatisieren und direkt über die CLI in andere Dienste zu integrieren. Erweiterungen helfen Ihnen bei der Anpassung azd an die sich entwickelnden Teamanforderungen und Azure-Szenarien.

Hinweis

azd Erweiterungen befinden sich derzeit in der Betaversion.

Verwalten von Erweiterungsquellen

Erweiterungen werden über Erweiterungsquellen verteilt und verwaltet, sodass sie leicht zu erkennen, zu installieren und zu aktualisieren sind, wenn Ihre Anforderungen wachsen.

  • Erweiterungsquellen sind datei- oder URL-basierte Manifeste, die Listen der verfügbaren azd Erweiterungen bereitstellen.
  • Benutzer können benutzerdefinierte Erweiterungsquellen hinzufügen, die eine Verbindung mit privaten, lokalen oder öffentlichen Registrierungen herstellen.
  • Erweiterungsquellen sind ein gleichwertiges Konzept für NuGet- oder Node Package Manager(NPM)-Feeds und müssen dem offiziellen Erweiterungsregistrierungsschema entsprechen.

azd stellt zwei Erweiterungsquellenregistrierungen bereit, die Ihnen bei den ersten Schritten mit Erweiterungen helfen:

  • Die offizielle Erweiterungsquellregistrierung ist vorkonfiguriert in azd und wird unter https://aka.ms/azd/extensions/registrygehostet.
  • Die Erweiterungsregistrierung kann Ihrer Konfiguration ebenfalls hinzugefügt azd werden. Diese Registrierung enthält experimentelle Erweiterungen für interne Tests, die möglicherweise oder auch nicht offizielle Erweiterungen werden.

Führen Sie den folgenden Befehl aus, um sich für die Entwicklungsregistrierung zu entscheiden:

# Add a new extension source name 'dev' to your `azd` configuration.
azd extension source add -n dev -t url -l "https://aka.ms/azd/extensions/registry/dev"

Vorsicht

Erweiterungen, die in der Dev-Registrierung gehostet werden, enthalten derzeit keine signierten Binärdateien.

Erweiterungsquellenbefehle

Verwenden Sie die folgenden Befehle, um Erweiterungsquellen für Ihre azd Installation zu verwalten.

Auflisten installierter Erweiterungsquellen

azd extension source list

Hinzufügen einer neuen Erweiterungsquelle

azd extension source add -n <name> -t url -l <registry-url>
  • -l, --location: Der Speicherort des Erweiterungsquellcodes.
  • -n, --name: Der Name der Erweiterungsquelle.
  • -t, --type: Der Typ der Erweiterungsquelle. Unterstützte Typen sind Datei und URL.

Entfernen einer Erweiterungsquelle

azd extension source remove <name>

Verwalten von Erweiterungen

Sobald Erweiterungen aktiviert sind und Ihre Erweiterungsquellen konfiguriert sind, können Sie Erweiterungen installieren, um neue Funktionen azdhinzuzufügen. Besuchen Sie die Schnellstartanleitung – Verwenden Sie den ARTIKEL zur KI-Erweiterung , um ein Beispiel für das Arbeiten mit Erweiterungen zu finden.

Erweiterungen auflisten

azd extension list [flags]
  • --installed Zeigt eine Liste der installierten Erweiterungen an.
  • --source Nur Erweiterungen aus der angegebenen Quelle auflisten.
  • --tags Ermöglicht das Filtern von Erweiterungen nach Tags (KI, Test)

Installieren einer Erweiterung

azd extension install <extension-names> [flags]

Ersetzen Sie <extension-name> durch den Namen der Erweiterung, die Sie installieren möchten.

  • -v, --version Gibt die Versionseinschränkung an, die beim Installieren von Erweiterungen angewendet werden soll.
  • -s, --source Gibt die Erweiterungsquelle an, die für Installationen verwendet wird.

Upgrade einer Erweiterung

azd extension upgrade <extension-name>
  • --all Aktualisiert alle zuvor installierten Erweiterungen, wenn angegeben.
  • -v, --version Aktualisiert eine angegebene Erweiterung mithilfe einer Versionseinschränkung, sofern angegeben.
  • -s, --source Gibt die Erweiterungsquelle an, die für Installationen verwendet wird.

Deinstallieren einer Erweiterung

azd extension uninstall <extension-name>
  • --all Entfernt alle installierten Erweiterungen, wenn angegeben.

Verwenden von azd-Erweiterungen in Dev-Containern

Das azd Dev Container-Feature unterstützt eine extensions Option zum automatischen Installieren einer durch Trennzeichen getrennten Liste von azd Erweiterungen während des Containerbuilds. Auf diese Weise installierte Erweiterungen sind verfügbar, sobald der Container gestartet wird, wodurch manuelles Setup reduziert und azd Befehle mit den bereits installierten erforderlichen Erweiterungen ausgeführt werden können.

Um Erweiterungen automatisch zu installieren, fügen Sie die extensions Option zum azd Featureeintrag in Ihrer devcontainer.json Datei hinzu:

{
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        "ghcr.io/azure/azure-dev/azd:latest": {
            "extensions": "my-ext-1,my-ext-2"
        }
    }
}

Der extensions Wert ist eine durch Trennzeichen getrennte Liste von Erweiterungsnamen azd . Die Installation erfolgt während des Containerbuilds, sodass die Erweiterungen sofort verwendet werden können, sobald der Container gestartet wird. Verwenden Sie nach dem Ändern der Erweiterungsliste den Befehl " Neu erstellen und erneut öffnen" in Visual Studio Code, um den Container mit den aktualisierten Erweiterungen neu zu erstellen.

Erfahren Sie mehr über das azd Dev Container-Feature.

Nächste Schritte

  • Last updated on