Freigeben über

Installieren oder Aktualisieren der Azure Developer CLI

Willkommen bei der Azure Developer CLI (azd)! Beginnen wir mit der Installation und lernen, wie man azd ausführt.

Wählen Sie zunächst Ihre Entwicklungsumgebung aus. Weitere Informationen zu den Vor- und Nachteilen der verschiedenen Entwicklungsumgebungsoptionen finden Sie unter Azure Developer CLI (azd) unterstützte Umgebungen.

Weitere erweiterte Installationsszenarien und Anweisungen finden Sie unter Azure Developer CLI Installer Scripts.

Hinweis: Bei der Installation von azd werden die folgenden Tools im azd-Bereich installiert (d. h., sie sind nicht global installiert) und entfernt, wenn azd deinstalliert wird:

Installieren von azd

winget install microsoft.azd

Aktualisieren von azd

winget upgrade microsoft.azd

Deinstallieren azd

winget uninstall microsoft.azd

Hinweis

Auf Apple Silicon Macs (M1 und M2) azd ist Rosetta 2 erforderlich. Wenn Rosetta 2 noch nicht installiert ist, wird vom Terminal aus ausgeführt softwareupdate --install-rosetta .

Der azd Installationsprozess wählt automatisch die richtige Binärdatei für die Architektur Ihres Computers aus.

Installieren von azd

brew install azure/azd/azd

Wenn Sie brew aktualisieren, um azd von einer Version, die nicht mit brew installiert wurde, zu upgraden, entfernen Sie die vorhandene Version von azd mithilfe des Deinstallationsskripts (falls am Standardspeicherort installiert) oder löschen Sie die azd Binärdatei manuell. Dadurch wird automatisch die richtige Version installiert.

Aktualisieren von azd

brew upgrade azure/azd/azd

Deinstallieren azd

brew uninstall azd

Installieren von azd

curl -fsSL https://aka.ms/install-azd.sh | bash

Aktualisieren von azd

curl -fsSL https://aka.ms/install-azd.sh | bash

Wenn azd installiert wird, werden die folgenden Tools im azd-Bereich installiert (d. h. sie werden nicht global installiert) und entfernt, wenn azd deinstalliert wird.

Deinstallieren azd

curl -fsSL https://aka.ms/uninstall-azd.sh | bash

Voraussetzungen

Bevor Sie mit der Verwendung azdbeginnen, stellen Sie folgendes sicher:

Installieren azd in einem Entwicklercontainer

Ein Entwicklercontainer ist ein Docker-Image, das alle Erforderlichen enthält, die Sie zum Ausführen einer App auf Ihrem lokalen Computer benötigen. Installieren Sie azd als Feature in Ihrem Entwicklercontainer mithilfe der folgenden Schritte:

  1. Fügen Sie das azd Feature zur devcontainer.json Datei im .devcontainer Ordner im Hauptverzeichnis Ihrer Vorlage hinzu.

    {
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        // See https://containers.dev/features for list of features
        "ghcr.io/devcontainers/features/docker-in-docker:2": {
        },
        "ghcr.io/azure/azure-dev/azd:latest": {}
    }
    // Rest of file omitted...
}

  2. Erstellen Sie den Entwicklercontainer neu, und führen Sie diesen aus. Verwenden Sie in Visual Studio Code die befehlspalette, um den Befehl Rebuild und Erneut öffnen in Dev Container auszuführen.

Azd-Erweiterungen automatisch installieren

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.

Überprüfen Sie Ihre Installation

Überprüfen Sie, ob die azd Installation erfolgreich abgeschlossen wurde, indem Sie den azd version Befehl in einem Terminal ausführen:

azd version

azd druckt die aktuelle Version:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Azure Developer CLI aktualisieren

Wenn Sie mit einer veralteten Version von azd arbeiten, wird eine Warnung zum Upgrade auf die neueste Version angezeigt. Folgen Sie den Anweisungen in der Warnung, um auf die neueste Version zu aktualisieren.

Hilfe anfordern

Informationen zum Melden eines Fehlers, Anfordern von Hilfe oder Vorschlagen einer neuen Funktion für die Azure Developer CLI finden Sie auf der Seite Fehlerbehebung und Support.

Nächste Schritte

Schnellstart – Auswählen und Bereitstellen einer azd-Vorlage

Was sind Azure Developer CLI-Vorlagen?

häufig gestellte Fragen Azure Developer CLI

  • Last updated on