Ausführen der Azure CLI in einem Docker-Container

Mit Docker können Sie einen eigenständigen Linux-Container mit vorinstallierter Azure CLI verwenden. Docker ermöglicht Ihnen einen schnellen Einstieg mit einer isolierten Umgebung für die Ausführung der CLI. Das Image kann auch als Grundlage für eigene Bereitstellungen verwendet werden.

Warnung

Azure CLI 2.63.0 (veröffentlicht im August 2024) ist die letzte Version, die im Alpine Docker-Image unterstützt wird. Microsoft stellt keine zusätzlichen Updates oder Fehlerbehebungen für dieses Image bereit. Erwägen Sie die Migration zum Azure Linux-basierten Image für die Azure CLI, das vollständig unterstützt wird.

Um Warnmeldungen zu deaktivieren, führen Sie den Befehl aus az config set core.only_show_errors=yes. Weitere Informationen zu Azure CLI-Konfigurationseinstellungen finden Sie unter CLI-Konfigurationswerte und Umgebungsvariablen.

Starten des Docker-Containers mit vorinstallierter Azure CLI

Öffnen Sie eine Eingabeaufforderung, und starten Sie den Docker-Container mit vorinstallierter Azure CLI mit dem folgenden Befehl. Bei Verwendung in einer Pipeline wird empfohlen, einen deterministischen Tagnamen zu verwenden (z. B cbl-mariner2.0. )

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

Hinweis

Wenn Sie die SSH-Schlüssel aus Ihrer Benutzerumgebung übernehmen möchten, verwenden Sie -v ${HOME}/.ssh:/root/.ssh, um Ihre SSH-Schlüssel in der Umgebung bereitzustellen.

docker run -it -v ${HOME}/.ssh:/root/.ssh mcr.microsoft.com/azure-cli:cbl-mariner2.0

Die CLI wird in dem Image als Befehl az in /usr/local/bin installiert.

Führen Sie den Docker-Container mit einer bestimmten Version der Azure CLI aus

Verfügbare Versionen finden Sie unter Versionshinweise für die Azure CLI.

Verwenden Sie diesen Befehl, um eine bestimmte Version der Azure CLI im Docker-Container auszuführen. Ändern Sie 2.62.0 ihre gewünschte Version.

docker run -it mcr.microsoft.com/azure-cli:2.62.0-cbl-mariner2.0

Aktualisieren des Docker-Images

Für die Aktualisierung mit Docker ist das Abrufen des neuen Images per Pull und das Neuerstellen vorhandener Container erforderlich. Aus diesem Grund sollten Sie die Verwendung eines Containers vermeiden, der die CLI als Datenspeicher hostet.

Aktualisieren Sie Ihr lokales Image mit docker pull.

docker pull mcr.microsoft.com/azure-cli:cbl-mariner2.0

Deinstallieren des Docker-Images

Es tut uns leid, wenn Sie die Azure CLI deinstallieren möchten. Verwenden Sie vor der Deinstallation den az feedback-Befehl, um uns mitzuteilen, was verbessert oder behoben werden sollte. Unser Ziel ist eine fehlerfreie und benutzerfreundliche Azure CLI. Falls ein Fehler aufgetreten ist, wären wir Ihnen dankbar, wenn Sie ein GitHub-Problem melden.

Entfernen Sie das CLI-Image, nachdem Sie alle Container angehalten haben, die das CLI-Image ausführen.

docker rmi mcr.microsoft.com/azure-cli

Nächste Schritte

Die Azure CLI kann nun in einem Docker-Container verwendet werden. Machen Sie sich jetzt kurz mit den Features sowie mit häufig verwendeten Befehlen vertraut.