Ausführen der Azure CLI in einem Docker-Container

Sie können Docker verwenden, um einen eigenständigen Linux-Container mit vorinstallierter Azure CLI auszuführen und eine schnelle und isolierte Umgebung für die Verwendung von Azure CLI bereitzustellen. Dieses Containerimage kann auch als Basis für Ihre eigenen benutzerdefinierten Bereitstellungen dienen.

Warnung

Azure CLI 2.63.0 (veröffentlicht August 2024) ist die endgültige Version, die auf dem alpinen Docker-Image unterstützt wird. Microsoft stellt keine Updates oder Fehlerbehebungen für dieses Image mehr bereit. Um eine fortgesetzte Unterstützung sicherzustellen, migrieren Sie zum Azure Linux-basierten Image (Azure Linux 3.0), das vollständig verwaltet wird. Sehen Sie sich die folgenden Beispiele für die Verwendung von Azure Linux 3.0 an.

Führen Sie Folgendes aus, um Warnmeldungen zu unterdrücken: az config set core.only_show_errors=yes. Ausführliche Informationen zu Konfigurationsoptionen finden Sie unter Azure CLI-Konfigurationswerte und Umgebungsvariablen.

Starten des Docker-Containers mit vorinstallierter Azure CLI

Öffnen Sie eine Eingabeaufforderung, und starten Sie einen Docker-Container mit vorinstallierter Azure CLI mit dem folgenden Befehl. Wenn Sie diesen Befehl in einer Pipeline verwenden, nutzen Sie ein deterministisches Tag (z. B. azurelinux3.0), um ein konsistentes Verhalten sicherzustellen.

docker run -it mcr.microsoft.com/azure-cli:azurelinux3.0

Hinweis

Um Ihre lokalen SSH-Schlüssel im Container zu verwenden, stellen Sie Ihr SSH-Verzeichnis ein, indem Sie die folgende Option einschließen: --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh Mit dieser Option kann der Container über Ihre Benutzerumgebung auf Ihre SSH-Schlüssel zugreifen.

docker run -it --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh mcr.microsoft.com/azure-cli:azurelinux3.0

Die Azure CLI ist im Image als az Befehl verfügbar, der bei /usr/local/bin/az zu finden ist.

Ausführen des Docker-Containers mit einer bestimmten Version der Azure CLI

Sie finden die verfügbaren Versionen in den Azure CLI-Versionshinweisen.

Wenn Sie eine bestimmte Version der Azure CLI in einem Docker-Container ausführen möchten, verwenden Sie den folgenden Befehl, und ersetzen 2.74.0 Sie diese durch Ihre gewünschte Version.

docker run -it mcr.microsoft.com/azure-cli:2.74.0-azurelinux3.0

Docker-Image aktualisieren

Um die Azure CLI bei Verwendung von Docker zu aktualisieren, müssen Sie das neueste Image abrufen und vorhandene Container neu erstellen. Vermeiden Sie aufgrund dieses Aktualisierungsprozesses die Verwendung von Azure CLI-Containern als persistente Datenspeicher.

Aktualisieren Sie Ihr lokales Image mithilfe des folgenden Befehls:

docker pull mcr.microsoft.com/azure-cli:latest

Docker-Image deinstallieren

Wenn Sie sich entscheiden, die Azure CLI zu deinstallieren, tut es uns leid, Sie verlieren zu müssen. Bevor Sie deinstallieren, verwenden Sie den Befehl az feedback, um uns mitzuteilen, was verbessert oder behoben werden könnte. Unser Ziel ist es, die Azure CLI fehlerfrei und benutzerfreundlicher zu gestalten. Falls ein Fehler aufgetreten ist, wären wir Ihnen dankbar, wenn Sie ein GitHub-Problem melden.

Um das Docker-Image zu entfernen, beenden Sie zuerst alle ausgeführten Container, und führen Sie dann Folgendes aus:

docker rmi mcr.microsoft.com/azure-cli

Nächste Schritte

Nachdem Sie nun bereit sind, die Azure CLI in einem Docker-Container zu verwenden, machen Sie sich einen kurzen Überblick über die wichtigsten Features und häufig verwendeten Befehle, um zu beginnen.

Erste Schritte mit Azure CLI