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 --cask 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 Rebuild und Erneut öffnen in Dev Container befehl in Visual Studio Code, um den Container mit den aktualisierten Erweiterungen neu zu erstellen.

Erfahren Sie mehr über das feature azd Dev Container.

Ü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)

Aktualisierung der Azure Developer CLI

Sie können azd mit dem integrierten azd update Befehl (Beta) aktualisieren oder manuell dieselbe Methode verwenden, die Sie zum Installieren verwendet haben.

Verwenden Sie azd update (Beta)

Der azd update Befehl erkennt, wie azd ursprünglich installiert wurde, und delegiert automatisch an die entsprechende Updatemethode:

Installationsmethode Was azd update tut
winget Führt winget upgrade Microsoft.Azd
choco Läuft choco upgrade azd
Installationsskript oder MSI (Windows) Wird mit automatischer Sicherung und Wiederherstellung ausgeführt install-azd.ps1
Installieren von Skripts (Linux/macOS) Läuft install-azd.sh
Homebrew Läuft brew upgrade --cask azure/azd/azd
.deb / .rpm Paket Direktes Herunterladen und Ersetzen der Binärdatei

Führen Sie den folgenden Befehl aus, um auf die neueste stabile Version zu aktualisieren:

azd update

Hinweis

Der azd update Befehl befindet sich derzeit in der Betaversion. Weitere Informationen zur Unterstützung von Alpha- und Betafeatures finden Sie auf der Seite "Featureversionsverwaltung" und "Releasestrategie ".

Wechseln von Updatekanälen

azd unterstützt zwei Updatekanäle: stable (Standard) und daily. Kanalwechsel wird für skriptbasierte Installationen und Homebrew unterstützt. Wenn Sie azd über winget oder choco installiert haben, sind tägliche Builds über diese Paketmanager nicht verfügbar – azd update zeigt Anleitungen, wie zuerst über das Skript neu installiert werden kann.

So wechseln Sie zum daily Kanal und aktualisieren:

azd update --channel daily

So wechseln Sie zurück zum stable Kanal:

azd update --channel stable

Beim Wechseln von Kanälen werden Sie aufgefordert, eine Bestätigung zu erhalten, azd bevor Sie fortfahren.

Verwenden des Paket-Managers oder Installieren von Skripts

Sie können auch jederzeit manuell mit demselben Paket-Manager aktualisieren oder Skriptbefehle installieren, die in den obigen Installationsabschnitten gezeigt werden. Wenn azd nicht mehr aktuell ist, wird eine Warnmeldung mit dem entsprechenden Update-Befehl für Ihre Installationsmethode angezeigt.

Hilfe anfordern

Informationen zum Melden eines Fehlers, Anfordern von Hilfe oder Vorschlagen eines neuen Features 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