Installieren der Azure CLI unter Linux

Die Azure CLI ist ein plattformübergreifendes Befehlszeilentool, das lokal auf Linux-Computern installiert werden kann. Sie können mit der Azure CLI unter Linux eine Verbindung mit Azure herstellen und Verwaltungsbefehle für Azure-Ressourcen ausführen. Die CLI unter Linux ermöglicht die Ausführung verschiedener Befehle über ein Terminal, indem interaktive Befehlszeilenaufforderungen oder ein Skript verwendet werden. Wenn Sie die Azure CLI unter Linux installieren möchten, wird empfohlen, dazu den Paket-Manager einer Linux-Distribution zu verwenden. Wählen Sie den entsprechenden Paket-Manager für Ihre Distribution aus den obigen Optionen aus. Wenn Sie nicht über einen der aufgelisteten Paket-Manager verfügen, können Sie die Azure CLI manuell unter Linux installieren, indem Sie die Option Installationsskript auswählen.

Die aktuelle Version der Azure CLI ist 2.39.0. Informationen zur neuesten Version finden Sie in den Versionshinweisen. Führen Sie az version aus, um Ihre installierte Version zu ermitteln und festzustellen, ob Sie die CLI aktualisieren müssen.

Übersicht

Der apt-Paket-Manager enthält ein x86_64-Paket für die Azure-Befehlszeilenschnittstelle (Azure CLI), die mit den folgenden Distributionen getestet wurde.

Distribution Version
Ubuntu 18.04 LTS (Bionic Beaver), 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish)
Debian 10 (Buster), 11 (Bullseye)

Warnung

Sie können weiterhin frühere Versionen der Azure CLI auf alten Systemen verwenden, es werden jedoch keine Updates oder Fehlerbehebungen mehr zur Verfügung gestellt. Erwägen Sie ein Upgrade auf neuere Versionen von Ubuntu oder Debian, um die neueste Version der Azure CLI zu nutzen.

Warnung

Ubuntu 20.04 (Focal Fossa) und 20.10 (Groovy Gorilla) enthalten ein azure-cli-Paket mit der Version 2.0.81, das im universe-Repository verfügbar ist. Dieses Paket ist veraltet und wird nicht empfohlen. Falls dieses Paket installiert ist, entfernen Sie es mit dem Befehl sudo apt remove azure-cli -y && sudo apt autoremove -y, bevor Sie fortfahren.

Die ARM64-Architektur wird vom Deb-Paket azure-cli nicht unterstützt.

Installationsoptionen

Zum Installieren der Azure CLI auf Ihrem System stehen zwei Optionen zur Auswahl. Sie können einen einzelnen Befehl ausführen, der ein Installationsskript herunterlädt und die Installationsbefehle für Sie ausführt. Alternativ können Sie die Installationsbefehle selbst Schritt für Schritt ausführen. Beide Methoden werden im Folgenden beschrieben.

Option 1: Installieren mit einem Befehl

Das Azure CLI-Team pflegt ein Skript, mit dem alle Installationsbefehle in einem Schritt ausgeführt werden können. Dieses Skript wird über curl heruntergeladen und direkt an bash weitergeleitet, um die CLI zu installieren.

Wenn Sie den Inhalt des Skripts vor der Ausführung überprüfen möchten, laden Sie es einfach mit curl herunter, und überprüfen Sie es in Ihrem bevorzugten Text-Editor.

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Option 2: Schrittweise Installation

Wenn Sie die Installation der Azure CLI lieber Schritt für Schritt durchführen möchten, befolgen Sie die folgenden Schritte.

  1. Rufen Sie die für die Installation erforderlichen Pakete ab:

    sudo apt-get update
    sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. Laden Sie den Microsoft-Signaturschlüssel herunter, und installieren Sie ihn.

    curl -sL https://packages.microsoft.com/keys/microsoft.asc |
        gpg --dearmor |
        sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
    
  3. Fügen Sie das Azure CLI-Softwarerepository hinzu:
    AZ_REPO=$(lsb_release -cs)
    echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" |
        sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. Aktualisieren Sie die Repositoryinformationen, und installieren Sie das Paket azure-cli:

    sudo apt-get update
    sudo apt-get install azure-cli
    

Installieren einer bestimmten Version

Sie müssen zunächst azure-cli-Repositoryinformationen konfigurieren, wie oben gezeigt. Verfügbare Versionen finden Sie unter Versionshinweise für die Azure CLI.

  1. So zeigen Sie verfügbare Versionen mit dem Befehl an:

    apt-cache policy azure-cli
    
  2. So installieren Sie eine bestimmte Version:

    sudo apt-get install azure-cli=<version>-1~bullseye
    

Problembehandlung

In diesem Abschnitt finden Sie einige allgemeine Probleme, die bei der Installation mit apt auftreten können. Falls ein Problem auftritt, das hier nicht behandelt wird, melden Sie es auf GitHub.

Problem vom Typ „Kein Modul“ unter Ubuntu 20.04 (Focal)/WSL

Wenn Sie azure-cli unter Focal installiert haben, ohne das Azure CLI-Softwarerepository in Schritt 3 der Anweisungen für die manuelle Installation hinzuzufügen oder unser Skript zu verwenden, treten unter Umständen Probleme auf, etwa das Problem „Kein Modul mit dem Namen 'decorator' or 'antlr4'“. Das ist darauf zurückzuführen, dass es sich beim installierten Paket um das veraltete Paket azure-cli 2.0.81 aus dem Repository focal/universe handelt. Entfernen Sie das Paket zuerst, indem Sie sudo apt remove azure-cli -y && sudo apt autoremove -y ausführen. Befolgen Sie anschließend die obigen Anweisungen zum Installieren des aktuellen azure-cli-Pakets.

„lsb_release“ gibt nicht die richtige Basisdistributionsversion zurück.

Einige von Ubuntu oder Debian abgeleiteten Distributionen wie Linux Mint geben über lsb_release unter Umständen nicht den richtigen Versionsnamen zurück. Mit diesem Wert wird im Installationsprozess das zu installierende Pakete ermittelt. Wenn Sie den Codenamen der Ubuntu- oder Debian-Version kennen, von der Ihre Distribution abgeleitet ist, können Sie beim Hinzufügen des Repositorys den Wert AZ_REPO manuell festlegen. Sehen Sie sich andernfalls Informationen dazu an, wie Sie für Ihre Distribution den Basisdistributions-Codenamen ermitteln, und legen Sie AZ_REPO auf den richtigen Wert fest.

Kein Paket für Ihre Distribution

Manchmal dauert es nach der Veröffentlichung einer Distribution etwas, bis ein Azure CLI-Paket dafür zur Verfügung gestellt wird. Die Azure CLI ist im Hinblick auf zukünftige Abhängigkeitsversionen resilient konzipiert und nutzt daher möglichst wenige dieser Abhängigkeiten. Ist für Ihre Basisdistribution kein Paket verfügbar, verwenden Sie ein Paket für eine ältere Distribution.

Legen Sie dazu beim Hinzufügen des Repositorys den Wert AZ_REPO manuell fest. Verwenden Sie für Ubuntu-Distributionen das aktuelle jammy-Repository:

AZ_REPO="jammy"

Verwenden Sie für Debian-Distributionen das aktuelle bullseye-Repository:

AZ_REPO="bullseye"

Distributionen, die vor Ubuntu Bionic und Debian Buster veröffentlicht wurden, werden nicht unterstützt.

Installation der Azure-Befehlszeilenschnittstelle durch EOS (Elementary OS) nicht möglich

Die Azure-Befehlszeilenschnittstelle kann von EOS nicht installiert werden, da lsb_release den Wert HERA (Name des EOS-Release) zurückgibt. Zur Lösung des Problems muss die Datei /etc/apt/sources.list.d/azure-cli.list korrigiert und hera main in bionic main geändert werden.

Ursprünglicher Dateiinhalt:

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ hera main

Geänderter Dateiinhalt:

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ bionic main

Der Proxy blockiert die Verbindung.

Wenn Sie aufgrund eines Proxys keine Verbindung mit einer externen Ressource herstellen können, stellen Sie sicher, dass Sie die Variablen HTTP_PROXY und HTTPS_PROXY in Ihrer Shell korrekt festgelegt haben. Wenden Sie sich an den Systemadministrator, um Informationen dazu zu erhalten, welche Hosts und Ports für diese Proxys verwendet werden müssen.

Diese Werte gelten für viele Linux-Programme, u. a. die Programme, die beim Installationsvorgang verwendet werden. Diese Werte legen Sie wie folgt fest:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

Wichtig

Wenn Sie sich hinter einem Proxy befinden, müssen diese Shellvariablen so festgelegt sein, dass sie mit der CLI eine Verbindung mit Azure-Diensten herstellen. Wenn Sie nicht die Standardauthentifizierung verwenden, wird empfohlen, dass Sie diese Variablen in Ihrer Datei vom Typ .bashrc exportieren. Berücksichtigen Sie dabei immer die Sicherheitsrichtlinien Ihres Unternehmens und die Anforderungen Ihres Systemadministrators.

Konfigurieren Sie apt explizit so, dass dieser Proxy immer verwendet wird. Stellen Sie sicher, dass die folgenden Zeilen in einer apt-Konfigurationsdatei in /etc/apt/apt.conf.d/ erscheinen. Wir empfehlen, dass Sie Ihre vorhandene globale Konfigurationsdatei, eine vorhandene Proxykonfigurationsdatei, 40proxies oder 99local verwenden. Berücksichtigen Sie dabei jedoch die Verwaltungsanforderungen Ihres Systems.

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

Wenn Ihr Proxy keine Standardauthentifizierung verwendet, entfernen Sie den Teil [username]:[password]@ des Proxy-URI. Weitere Informationen zur Proxykonfiguration finden Sie in der offiziellen Ubuntu-Dokumentation:

Zum Abrufen des Microsoft-Signaturschlüssels und des Pakets von unserem Repository muss Ihr Proxy HTTPS-Verbindungen mit der folgenden Adresse zulassen:

  • https://packages.microsoft.com

Die CLI kann auf dem Windows-Subsystem für Linux nicht installiert oder ausgeführt werden.

Das Windows-Subsystem für Linux (WSL) ist eine Übersetzungsebene für Systemaufrufe, die auf der Windows-Plattform basiert. Daher tritt unter Umständen ein Fehler auf, wenn Sie die Azure CLI installieren oder ausführen. Die CLI nutzt einige Features, die in WSL unter Umständen einen Fehler enthalten. Falls unabhängig von der Art der CLI-Installation ein Fehler auftritt, ist die Wahrscheinlichkeit hoch, dass ein Problem mit dem WSL und nicht mit dem CLI-Installationsvorgang vorliegt.

So beheben Sie Probleme mit Ihrer WSL-Installation und ggf andere Probleme:

  • Führen Sie möglichst den gleichen Installationsvorgang auf einem Linux-Computer oder einem virtuellen Computer aus, um zu sehen, ob er erfolgreich ist. Ist dies der Fall, hängt das Problem mit hoher Wahrscheinlichkeit mit WSL zusammen. Informationen zum Starten eines virtuellen Linux-Computers in Azure finden Sie in der Dokumentation zum Erstellen eines virtuellen Linux-Computers im Azure-Portal.
  • Stellen Sie sicher, dass die neueste Version von WSL ausgeführt wird. Um die aktuelle Version zu erhalten, aktualisieren Sie Ihre Windows 10-Installation.
  • Suchen Sie nach offenen Problemen mit WSL. Mithilfe dieser Informationen kann Ihr Problem vielleicht behoben werden. Häufig finden Sie Vorschläge, wie Sie das Problem umgehen, bzw. Informationen zu einem Release, in dem das Problem behoben wird.
  • Gibt es noch keinen Eintrag für Ihr Problem, melden Sie ein neues Problem mit WSL, und geben Sie dabei möglichst viele Details an.

Treten beim Installieren oder Ausführen auf dem WSL weiterhin Probleme auf, ziehen Sie die Installation der CLI für Windows in Betracht.

Aktualisieren

Die CLI bietet einen internen Befehl zum Aktualisieren auf die aktuelle Version:

az upgrade

Hinweis

Der Befehl az upgrade wurde in Version 2.11.0 hinzugefügt und funktioniert nicht mit Versionen vor 2.11.0. Ältere Versionen können durch eine Neuinstallation (siehe Installieren der Azure CLI) aktualisiert werden.

Mit diesem Befehl werden auch alle installierten Erweiterungen standardmäßig aktualisiert. Weitere az upgrade-Optionen finden Sie auf der Referenzseite für Befehle.

Sie können auch apt-get upgrade zum Aktualisieren des CLI-Pakets verwenden.

sudo apt-get update && sudo apt-get upgrade

Hinweis

Durch diesen Befehl werden alle installierten Pakete auf Ihrem System aktualisiert, deren Abhängigkeiten nicht geändert wurden. Wenn Sie nur ein Upgrade für die CLI durchführen möchten, verwenden Sie apt-get install.

sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli

Deinstallieren

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.

  1. Deinstallieren Sie sie mit apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Entfernen Sie die Azure CLI-Repositoryinformationen, wenn Sie nicht planen, die CLI neu zu installieren:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Wenn Sie keine anderen Pakete von Microsoft verwenden, entfernen Sie den Signaturschlüssel:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg
    
  4. Entfernen Sie alle nicht benötigten Pakete:

    sudo apt autoremove
    

Übersicht

Für Linux-Distributionen mit dnf wie RHEL 8 oder CentOS Stream 8 gibt es RPM-Pakete für die Azure CLI.

Warnung

Ab Azure CLI 2.39.0 (veröffentlicht am 02.08.2022) werden keine RPM-Pakete für RHEL 7 und CentOS 7 veröffentlicht. Sie können weiterhin frühere Versionen der Azure CLI auf diesen Systemen verwenden, es werden jedoch keine Updates oder Fehlerbehebungen mehr zur Verfügung gestellt. Erwägen Sie ein Upgrade auf neuere Versionen von RHEL oder CentOS, um die neueste Version der Azure CLI zu nutzen.

Die aktuelle Version der Azure CLI ist 2.39.0. Informationen zur neuesten Version finden Sie in den Versionshinweisen. Führen Sie az version aus, um Ihre installierte Version zu ermitteln und festzustellen, ob Sie die CLI aktualisieren müssen.

Wichtig

Das RPM-Paket der Azure CLI ist vom python3-Paket abhängig. Auf Ihrem System handelt es sich dabei möglicherweise um eine ältere Python-Version als die erforderliche Version 3.6.x. Sollte das Auswirkungen für Sie haben, suchen Sie ein Ersatzpaket von python3.

Denken Sie daran, dass Python 2 am 1. Januar 2020 ausgelaufen ist und keine Updates mehr erhält. Die Azure CLI unterstützt Python 2.7 seit Version 2.1.0 nicht mehr. Bei neuen Versionen wird die ordnungsgemäße Ausführung mit Python 2.7 nicht mehr garantiert.

Hinweis

Nutzen Sie bei Verwendung von Linux-Systemen, die den dnf-Paket-Manager nicht unterstützen, den yum-Paket-Manager.

Installieren

  1. Importieren Sie den Microsoft-Repositoryschlüssel.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. Fügen Sie für RHEL 8 oder CentOS Stream 8 packages-microsoft-com-prod Repository hinzu:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
    

    Fügen Sie für RHEL 7 oder CentOS 7 azure-cli Repository hinzu:

    echo -e "[azure-cli]
    name=Azure CLI
    baseurl=https://packages.microsoft.com/yumrepos/azure-cli
    enabled=1
    gpgcheck=1
    gpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/azure-cli.repo
    
  3. Installieren Sie mit dem Befehl dnf install.

    sudo dnf install azure-cli
    

Installieren einer bestimmten Version

Sie müssen zunächst azure-cli-Repositoryinformationen konfigurieren, wie oben gezeigt. Verfügbare Versionen finden Sie unter Versionshinweise für die Azure CLI.

  1. So zeigen Sie verfügbare Versionen mit dem Befehl an:

    dnf list --showduplicates azure-cli
    
  2. So installieren Sie eine bestimmte Version:

    sudo dnf install azure-cli-<version>-1.el7
    

Problembehandlung

In diesem Abschnitt finden Sie einige allgemeine Probleme, die bei der Installation mit dnf auftreten können. Falls ein Problem auftritt, das hier nicht behandelt wird, melden Sie es auf GitHub.

Installieren auf RHEL 7.6 oder anderen Systemen ohne Python 3

Führen Sie wenn möglich ein Upgrade Ihres Systems auf eine Version mit offizieller Unterstützung für python 3.6+-Pakete durch. Andernfalls müssen Sie zuerst ein python3-Paket und dann die Azure CLI ohne Abhängigkeit installieren.

Sie können den folgenden Befehl verwenden, um die Azure CLI mit dem aus der Quelle erstellten python 3.6-Paket zu installieren:

curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

Sie können auch Schritt für Schritt vorgehen:

Die Azure CLI erfordert zuerst SSL 1.1+, und Sie müssen openssl 1.1 aus der Quelle erstellen, bevor Sie python3 erstellen:

sudo dnf install gcc gcc-c++ make ncurses patch wget tar zlib zlib-devel -y
# build openssl from source
cd ~
wget https://www.openssl.org/source/openssl-1.1.1d.tar.gz
tar -xzf openssl-1.1.1d.tar.gz
cd openssl-1.1.1d
./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl
make
sudo make install
# configure shared object lookup directory so that libssl.so.1.1 can be found
echo "/usr/local/ssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1d.conf
# reload config
sudo ldconfig -v

Erstellen Sie anschließend Python 3 aus der Quelle:

PYTHON_VERSION="3.6.9"
PYTHON_SRC_DIR=$(mktemp -d)
wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
cd $PYTHON_SRC_DIR/Python-$PYTHON_VERSION
./configure --prefix=/usr --with-openssl=/usr/local/ssl
make
sudo make install

Führen Sie schließlich Schritt 1 und 2 der Installationsanweisungen aus, um das Azure CLI-Repository hinzuzufügen. Nun können Sie das Paket herunterladen und ohne Abhängigkeit installieren.

Hinweis

Falls Sie das dnf-Download-Plug-In nicht installiert haben, wird beim Ausführen des unten angegebenen Codes der Fehler „Befehl nicht gefunden“ angezeigt. Verwenden Sie dnf install 'dnf-command(download)' zum Installieren des dnf-Download-Plug-Ins.

sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm

Als Alternative können Sie Python 3 auch über ein zusätzliches Repository installieren. Wenn Sie python3 eingerichtet haben, aber weiterhin den Fehler python3: command not found erhalten, wenn Sie versuchen, die CLI auszuführen, müssen Sie sie bei dieser Vorgehensweise dem Pfad hinzufügen.

scl enable rh-python36 bash

Der Proxy blockiert die Verbindung.

Wenn Sie aufgrund eines Proxys keine Verbindung mit einer externen Ressource herstellen können, stellen Sie sicher, dass Sie die Variablen HTTP_PROXY und HTTPS_PROXY in Ihrer Shell korrekt festgelegt haben. Wenden Sie sich an den Systemadministrator, um Informationen dazu zu erhalten, welche Hosts und Ports für diese Proxys verwendet werden müssen.

Diese Werte gelten für viele Linux-Programme, u. a. die Programme, die beim Installationsvorgang verwendet werden. Diese Werte legen Sie wie folgt fest:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

Wichtig

Wenn Sie sich hinter einem Proxy befinden, müssen diese Shellvariablen so festgelegt sein, dass sie mit der CLI eine Verbindung mit Azure-Diensten herstellen. Wenn Sie nicht die Standardauthentifizierung verwenden, wird empfohlen, dass Sie diese Variablen in Ihrer Datei vom Typ .bashrc exportieren. Berücksichtigen Sie dabei immer die Sicherheitsrichtlinien Ihres Unternehmens und die Anforderungen Ihres Systemadministrators.

Konfigurieren Sie dnf explizit so, dass dieser Proxy immer verwendet wird. Stellen Sie sicher, dass die folgenden Zeilen im Abschnitt [main] von /etc/dnf/dnf.conf erscheinen:

[main]
# ...
proxy=http://[proxy]:[port] # If your proxy requires https, change http->https
proxy_username=[username] # Only required for basic auth
proxy_password=[password] # Only required for basic auth

Zum Abrufen des Microsoft-Signaturschlüssels und des Pakets von unserem Repository muss Ihr Proxy HTTPS-Verbindungen mit der folgenden Adresse zulassen:

  • https://packages.microsoft.com

Die CLI kann auf dem Windows-Subsystem für Linux nicht installiert oder ausgeführt werden.

Das Windows-Subsystem für Linux (WSL) ist eine Übersetzungsebene für Systemaufrufe, die auf der Windows-Plattform basiert. Daher tritt unter Umständen ein Fehler auf, wenn Sie die Azure CLI installieren oder ausführen. Die CLI nutzt einige Features, die in WSL unter Umständen einen Fehler enthalten. Falls unabhängig von der Art der CLI-Installation ein Fehler auftritt, ist die Wahrscheinlichkeit hoch, dass ein Problem mit dem WSL und nicht mit dem CLI-Installationsvorgang vorliegt.

So beheben Sie Probleme mit Ihrer WSL-Installation und ggf andere Probleme:

  • Führen Sie möglichst den gleichen Installationsvorgang auf einem Linux-Computer oder einem virtuellen Computer aus, um zu sehen, ob er erfolgreich ist. Ist dies der Fall, hängt das Problem mit hoher Wahrscheinlichkeit mit WSL zusammen. Informationen zum Starten eines virtuellen Linux-Computers in Azure finden Sie in der Dokumentation zum Erstellen eines virtuellen Linux-Computers im Azure-Portal.
  • Stellen Sie sicher, dass die neueste Version von WSL ausgeführt wird. Um die aktuelle Version zu erhalten, aktualisieren Sie Ihre Windows 10-Installation.
  • Suchen Sie nach offenen Problemen mit WSL. Mithilfe dieser Informationen kann Ihr Problem vielleicht behoben werden. Häufig finden Sie Vorschläge, wie Sie das Problem umgehen, bzw. Informationen zu einem Release, in dem das Problem behoben wird.
  • Gibt es noch keinen Eintrag für Ihr Problem, melden Sie ein neues Problem mit WSL, und geben Sie dabei möglichst viele Details an.

Treten beim Installieren oder Ausführen auf dem WSL weiterhin Probleme auf, ziehen Sie die Installation der CLI für Windows in Betracht.

Aktualisieren

Die CLI bietet einen internen Befehl zum Aktualisieren auf die aktuelle Version:

az upgrade

Hinweis

Der Befehl az upgrade wurde in Version 2.11.0 hinzugefügt und funktioniert nicht mit Versionen vor 2.11.0. Ältere Versionen können durch eine Neuinstallation (siehe Installieren der Azure CLI) aktualisiert werden.

Mit diesem Befehl werden auch alle installierten Erweiterungen standardmäßig aktualisiert. Weitere az upgrade-Optionen finden Sie auf der Referenzseite für Befehle.

Sie können die Azure CLI auch mit dem Befehl dnf update aktualisieren.

sudo dnf update azure-cli

Deinstallieren

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.

  1. Entfernen Sie das Paket aus Ihrem System.

    sudo dnf remove azure-cli
    
  2. Entfernen Sie die Repositoryinformationen, wenn Sie nicht planen, die CLI neu zu installieren.

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. Wenn Sie keine anderen Microsoft-Pakete verwenden, entfernen Sie den Signaturschlüssel.

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
    sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
    

Übersicht

RPMs werden für CBL-Mariner 1.0 und 2.0 freigegeben.

Installieren

Installieren Sie das Paket mit dem Befehl tdnf install:

sudo tdnf install azure-cli

Installieren einer bestimmten Version

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

So zeigen Sie verfügbare Versionen mit dem Befehl an:

tdnf list azure-cli

So installieren Sie eine bestimmte Version:

sudo tdnf install azure-cli-<version>-1

Aktualisieren

Aktualisieren Sie die Azure CLI mit dem Befehl tdnf update:

sudo tdnf update azure-cli

Deinstallieren

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 Paket aus Ihrem System:

sudo tdnf remove azure-cli

Übersicht

Für Linux-Distributionen mit zypper wie openSUSE oder SLES ist ein Paket für die Azure CLI verfügbar. Dieses Paket wurde mit openSUSE Leap 15.1 und SLES 15 getestet.

Die aktuelle Version der Azure CLI ist 2.39.0. Informationen zur neuesten Version finden Sie in den Versionshinweisen. Führen Sie az version aus, um Ihre installierte Version zu ermitteln und festzustellen, ob Sie die CLI aktualisieren müssen.

Wichtig

Das RPM-Paket der Azure CLI ist vom python3-Paket abhängig. Auf Ihrem System handelt es sich dabei möglicherweise um eine ältere Python-Version als die erforderliche Version 3.6.x. Sollte das Auswirkungen für Sie haben, suchen Sie ein Ersatzpaket von python3.

Denken Sie daran, dass Python 2 am 1. Januar 2020 ausgelaufen ist und keine Updates mehr erhält. Die Azure CLI unterstützt Python 2.7 seit Version 2.1.0 nicht mehr. Bei neuen Versionen wird die ordnungsgemäße Ausführung mit Python 2.7 nicht mehr garantiert.

Installieren

  1. Installieren Sie curl:

    sudo zypper install -y curl
    
  2. Importieren Sie den Microsoft-Repositoryschlüssel:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  3. Erstellen Sie lokale azure-cli-Repositoryinformationen:

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
    
  4. Aktualisieren Sie den zypper-Paketindex, und führen Sie die Installation durch:

    sudo zypper install --from azure-cli azure-cli
    

    2 eingeben, um die Installation fortzusetzen, indem einige Abhängigkeiten ignoriert werden.

Installieren einer bestimmten Version

Sie müssen zunächst azure-cli-Repositoryinformationen konfigurieren, wie oben gezeigt. Verfügbare Versionen finden Sie unter Versionshinweise für die Azure CLI.

  1. So zeigen Sie verfügbare Versionen mit dem Befehl an:

    zypper search --details --match-exact azure-cli
    
  2. So installieren Sie eine bestimmte Version:

    sudo zypper install --from azure-cli azure-cli=<version>-1.el7
    

Problembehandlung

In diesem Abschnitt finden Sie einige allgemeine Probleme, die bei der Installation mit zypper auftreten können. Falls ein Problem auftritt, das hier nicht behandelt wird, melden Sie es auf GitHub.

NotImplementedError auf OpenSUSE 15-VM

Auf der OpenSUSE 15-VM ist die Azure CLI mit Version 2.0.45 vorinstalliert. Diese ist veraltet, und es treten Probleme mit az login auf. Entfernen Sie sie zusammen mit den zugehörigen Abhängigkeiten, bevor Sie die Installationsanweisungen zum Hinzufügen der aktuellen Azure CLI befolgen:

sudo zypper rm -y --clean-deps azure-cli

Wenn Sie die Azure CLI aktualisiert haben, ohne die Abhängigkeiten von Version 2.0.45 zu entfernen, beeinträchtigen die alten Abhängigkeiten unter Umständen die aktuelle Version der Azure CLI. Sie müssen die alte Version wieder hinzufügen, um eine Verknüpfung mit ihren Abhängigkeiten herzustellen, und anschließend azure-cli zusammen mit den Abhängigkeiten entfernen:

# The package name may vary on different system version, run 'zypper --no-refresh info azure-cli' to check the source package format
sudo zypper install --oldpackage azure-cli-2.0.45-4.22.noarch

sudo zypper rm -y --clean-deps azure-cli

Installieren auf SLES 12 oder anderen Systemen ohne Python 3.6

Unter SLES 12 ist 3.4 das standardmäßige python3-Paket und wird von der Azure CLI nicht unterstützt. Sie können zuerst die Schritte 1 bis 3 der Installationsanweisungen ausführen, um das Repository azure-cli hinzuzufügen. Erstellen Sie dann eine höhere Version von python3 aus der Quelle. Abschließend können Sie das Azure CLI-Paket herunterladen und ohne Abhängigkeit installieren.

Sie können den folgenden Befehl verwenden, um die Azure CLI anhand der oben beschriebenen Schritten zu installieren oder zu aktualisieren. Dieses Skript installiert Python 3.8 unter /usr/local/azcli und erzwingt die Verwendung durch die Azure CLI, indem der Alias az auf PATH=/usr/local/azcli/bin:$PATH az festgelegt wird. Sie können das Skript auch herunterladen und entsprechend Ihren Anforderungen ändern. Beispielsweise können Sie die Python-Version oder den Installationsspeicherort ändern.

curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash

Denken Sie bei der ersten Installation daran, den folgenden Befehl auszuführen, um den Alias zu aktivieren:

source ~/.bashrc

Der Proxy blockiert die Verbindung.

Wenn Sie aufgrund eines Proxys keine Verbindung mit einer externen Ressource herstellen können, stellen Sie sicher, dass Sie die Variablen HTTP_PROXY und HTTPS_PROXY in Ihrer Shell korrekt festgelegt haben. Wenden Sie sich an den Systemadministrator, um Informationen dazu zu erhalten, welche Hosts und Ports für diese Proxys verwendet werden müssen.

Diese Werte gelten für viele Linux-Programme, u. a. die Programme, die beim Installationsvorgang verwendet werden. Diese Werte legen Sie wie folgt fest:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

Wichtig

Wenn Sie sich hinter einem Proxy befinden, müssen diese Shellvariablen so festgelegt sein, dass sie mit der CLI eine Verbindung mit Azure-Diensten herstellen. Wenn Sie nicht die Standardauthentifizierung verwenden, wird empfohlen, dass Sie diese Variablen in Ihrer Datei vom Typ .bashrc exportieren. Berücksichtigen Sie dabei immer die Sicherheitsrichtlinien Ihres Unternehmens und die Anforderungen Ihres Systemadministrators.

Konfigurieren Sie zypper (über yast2) explizit so, dass dieser Proxy immer verwendet wird. Führen Sie hierfür den Befehl yast2 proxy als Superuser aus, und geben Sie die Informationen im Formular ein. Wenn auf Ihrem System ein Fenster-Manager verfügbar ist, können Sie auch den Bereich Network Services > Proxy in YaST Control Center verwenden.

Details zur erweiterten Konfiguration oder weitere Informationen finden Sie in der Dokumentation zur OpenSUSE-Proxykonfiguration.

Zum Abrufen des Microsoft-Signaturschlüssels und des Pakets von unserem Repository muss Ihr Proxy HTTPS-Verbindungen mit den folgenden Adressen zulassen:

  • https://packages.microsoft.com
  • https://download.opensuse.org

Die CLI kann auf dem Windows-Subsystem für Linux nicht installiert oder ausgeführt werden.

Das Windows-Subsystem für Linux (WSL) ist eine Übersetzungsebene für Systemaufrufe, die auf der Windows-Plattform basiert. Daher tritt unter Umständen ein Fehler auf, wenn Sie die Azure CLI installieren oder ausführen. Die CLI nutzt einige Features, die in WSL unter Umständen einen Fehler enthalten. Falls unabhängig von der Art der CLI-Installation ein Fehler auftritt, ist die Wahrscheinlichkeit hoch, dass ein Problem mit dem WSL und nicht mit dem CLI-Installationsvorgang vorliegt.

So beheben Sie Probleme mit Ihrer WSL-Installation und ggf andere Probleme:

  • Führen Sie möglichst den gleichen Installationsvorgang auf einem Linux-Computer oder einem virtuellen Computer aus, um zu sehen, ob er erfolgreich ist. Ist dies der Fall, hängt das Problem mit hoher Wahrscheinlichkeit mit WSL zusammen. Informationen zum Starten eines virtuellen Linux-Computers in Azure finden Sie in der Dokumentation zum Erstellen eines virtuellen Linux-Computers im Azure-Portal.
  • Stellen Sie sicher, dass die neueste Version von WSL ausgeführt wird. Um die aktuelle Version zu erhalten, aktualisieren Sie Ihre Windows 10-Installation.
  • Suchen Sie nach offenen Problemen mit WSL. Mithilfe dieser Informationen kann Ihr Problem vielleicht behoben werden. Häufig finden Sie Vorschläge, wie Sie das Problem umgehen, bzw. Informationen zu einem Release, in dem das Problem behoben wird.
  • Gibt es noch keinen Eintrag für Ihr Problem, melden Sie ein neues Problem mit WSL, und geben Sie dabei möglichst viele Details an.

Treten beim Installieren oder Ausführen auf dem WSL weiterhin Probleme auf, ziehen Sie die Installation der CLI für Windows in Betracht.

SSL-Zertifikatproblem

Wenn ein Zertifikat auf einem Computer beschädigt oder veraltet ist, erhalten Sie möglicherweise eine Fehlermeldung, die besagt, dass curl die Legitimität des Servers nicht verifizieren konnte und daher keine sichere Verbindung herstellen konnte. Aktualisieren Sie Ihr Zertifikat, um das Problem zu beheben.

sudo zypper update-ca-certificates

Aktualisieren

Die CLI bietet einen internen Befehl zum Aktualisieren auf die aktuelle Version:

az upgrade

Hinweis

Der Befehl az upgrade wurde in Version 2.11.0 hinzugefügt und funktioniert nicht mit Versionen vor 2.11.0. Ältere Versionen können durch eine Neuinstallation (siehe Installieren der Azure CLI) aktualisiert werden.

Mit diesem Befehl werden auch alle installierten Erweiterungen standardmäßig aktualisiert. Weitere az upgrade-Optionen finden Sie auf der Referenzseite für Befehle.

Sie können das Paket auch mit dem Befehl zypper update aktualisieren.

sudo zypper refresh
sudo zypper update azure-cli

Deinstallieren

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.

  1. Entfernen Sie das Paket aus Ihrem System.

    sudo zypper remove -y azure-cli
    
  2. Entfernen Sie die Repositoryinformationen, wenn Sie nicht planen, die CLI neu zu installieren.

    sudo zypper removerepo azure-cli
    
  3. Wenn Sie keine anderen Microsoft-Pakete verwenden, entfernen Sie den Microsoft-Signaturschlüssel.

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
    sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
    

Übersicht

Hinweis

Es wird dringend empfohlen, die CLI mit einem Paket-Manager zu installieren. Ein Paket-Manager stellt sicher, dass Sie immer die neuesten Updates erhalten, und gewährleistet die Stabilität der CLI-Komponenten. Überprüfen Sie vor der manuellen Installation, ob ein Paket für Ihre Distribution verfügbar ist.

Die CLI benötigt die folgende Software:

Wichtig

Die CLI unterstützt Python 2.7 seit Version 2.1.0 nicht mehr. Bei neuen Versionen wird die ordnungsgemäße Ausführung mit Python 2.7 nicht mehr garantiert.

Installieren oder Aktualisieren

Sowohl für die Installation als auch die Aktualisierung der CLI muss das Installationsskript erneut ausgeführt werden. Installieren Sie die CLI durch Ausführen von curl.

curl -L https://aka.ms/InstallAzureCli | bash

Das Skript kann auch heruntergeladen und lokal ausgeführt werden. Unter Umständen müssen Sie Ihre Shell neu starten, damit einige Änderungen wirksam werden.

Problembehandlung

In diesem Abschnitt werden einige allgemeine Probleme beschrieben, die bei einer manuellen Installation auftreten können. Falls ein Problem auftritt, das hier nicht behandelt wird, melden Sie es auf GitHub.

curl-Fehler „Objekt verschoben“

Wenn Sie einen Fehler von curl im Zusammenhang mit dem -L-Parameter oder eine Fehlermeldung mit dem Text „Objekt verschoben“ erhalten, versuchen Sie, die vollständige URL anstatt der aka.ms-Umleitung zu verwenden:

curl https://azurecliprod.blob.core.windows.net/install | bash

Der Befehl az wurde nicht gefunden.

Wenn Sie den Befehl nicht ausführen können, nachdem Sie die Installation durchgeführt und bash oder zsh verwendet haben, leeren Sie den Befehlshash-Cache Ihrer Shell. Ausführen

hash -r

Überprüfen Sie, ob das Problem behoben wurde.

Dieses Problem kann auch auftreten, wenn Sie die Shell nach der Installation nicht neu gestartet haben. Stellen Sie sicher, dass sich der Befehl az in $PATH befindet. Den Befehl az finden Sie hier:

<install path>/bin

Der Proxy blockiert die Verbindung.

Wenn Sie aufgrund eines Proxys keine Verbindung mit einer externen Ressource herstellen können, stellen Sie sicher, dass Sie die Variablen HTTP_PROXY und HTTPS_PROXY in Ihrer Shell korrekt festgelegt haben. Wenden Sie sich an den Systemadministrator, um Informationen dazu zu erhalten, welche Hosts und Ports für diese Proxys verwendet werden müssen.

Diese Werte gelten für viele Linux-Programme, u. a. die Programme, die beim Installationsvorgang verwendet werden. Diese Werte legen Sie wie folgt fest:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

Wichtig

Wenn Sie sich hinter einem Proxy befinden, müssen diese Shellvariablen so festgelegt sein, dass sie mit der CLI eine Verbindung mit Azure-Diensten herstellen. Wenn Sie nicht die Standardauthentifizierung verwenden, wird empfohlen, dass Sie diese Variablen in Ihrer Datei vom Typ .bashrc exportieren. Berücksichtigen Sie dabei immer die Sicherheitsrichtlinien Ihres Unternehmens und die Anforderungen Ihres Systemadministrators.

Zum Abrufen der Installationsskripts muss Ihr Proxy HTTPS-Verbindungen mit den folgenden Adressen zulassen:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Endpunkte, die vom Paket-Manager Ihrer Distribution (sofern vorhanden) für Core-Pakete verwendet werden

Die CLI kann auf dem Windows-Subsystem für Linux nicht installiert oder ausgeführt werden.

Das Windows-Subsystem für Linux (WSL) ist eine Übersetzungsebene für Systemaufrufe, die auf der Windows-Plattform basiert. Daher tritt unter Umständen ein Fehler auf, wenn Sie die Azure CLI installieren oder ausführen. Die CLI nutzt einige Features, die in WSL unter Umständen einen Fehler enthalten. Falls unabhängig von der Art der CLI-Installation ein Fehler auftritt, ist die Wahrscheinlichkeit hoch, dass ein Problem mit dem WSL und nicht mit dem CLI-Installationsvorgang vorliegt.

So beheben Sie Probleme mit Ihrer WSL-Installation und ggf andere Probleme:

  • Führen Sie möglichst den gleichen Installationsvorgang auf einem Linux-Computer oder einem virtuellen Computer aus, um zu sehen, ob er erfolgreich ist. Ist dies der Fall, hängt das Problem mit hoher Wahrscheinlichkeit mit WSL zusammen. Informationen zum Starten eines virtuellen Linux-Computers in Azure finden Sie in der Dokumentation zum Erstellen eines virtuellen Linux-Computers im Azure-Portal.
  • Stellen Sie sicher, dass die neueste Version von WSL ausgeführt wird. Um die aktuelle Version zu erhalten, aktualisieren Sie Ihre Windows 10-Installation.
  • Suchen Sie nach offenen Problemen mit WSL. Mithilfe dieser Informationen kann Ihr Problem vielleicht behoben werden. Häufig finden Sie Vorschläge, wie Sie das Problem umgehen, bzw. Informationen zu einem Release, in dem das Problem behoben wird.
  • Gibt es noch keinen Eintrag für Ihr Problem, melden Sie ein neues Problem mit WSL, und geben Sie dabei möglichst viele Details an.

Treten beim Installieren oder Ausführen auf dem WSL weiterhin Probleme auf, ziehen Sie die Installation der CLI für Windows in Betracht.

Deinstallieren

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.

Sie können die CLI deinstallieren, indem Sie die Dateien direkt aus dem Verzeichnis löschen, das Sie bei der Installation ausgewählt haben. Das Standardinstallationsverzeichnis ist $HOME.

  1. Entfernen Sie die installierten CLI-Dateien.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. Ändern Sie die Datei $HOME/.bash_profile, indem Sie die folgende Zeile entfernen:

    <install location>/lib/azure-cli/az.completion
    
  3. Laden Sie bei Verwendung von bash oder zsh den Befehlscache Ihrer Shell neu.

    hash -r
    

Daten entfernen

Wenn Sie nicht planen, die Azure CLI neu zu installieren, entfernen Sie die zugehörigen Daten.

rm -rf ~/.azure

Nächste Schritte

Machen Sie sich nach der Installation der Azure-Befehlszeilenschnittstelle kurz mit den Features sowie mit häufig verwendeten Befehlen vertraut.