Installieren der Azure CLI unter Linux

In diesem Artikel erfahren Sie, wie Sie die Azure CLI unter Linux installieren. Wählen Sie den entsprechenden Paket-Manager für Ihre Distribution aus den Optionen oben auf der Seite aus. Es wird empfohlen, den Paket-Manager einer Linux-Distribution zu verwenden. Sie können die Azure CLI jedoch auch manuell unter Linux installieren, indem Sie die Option Skript installieren auswählen.

Die aktuelle Version der Azure CLI ist 2.63.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.

Voraussetzungen

• Azure CLI 2.38.2 (veröffentlicht am 21. Juni 2024) ist die letzte Version, die auf RHEL 7 und Centos 7 unterstützt wird. Microsoft stellt keine Updates oder Fehlerbehebungen für diese Verteilungen mehr bereit.

• Microsoft entwickelt und unterstützt weiterhin die Azure CLI und das Linux-Installationsskript.

• Nutzen Sie für Linux-Systeme, die den dnf-Paket-Manager nicht unterstützen, den yum-Paket-Manager.

Installieren der Azure-Befehlszeilenschnittstelle

Führen Sie zum Installieren der Azure-CLI die folgenden Schritte aus:

1. Importieren Sie den Microsoft-Repositoryschlüssel.

   sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
   

2. Fügen Sie für RHEL 9 oder CentOS Stream Repository hinzu packages-microsoft-com-prod :

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

   Fügen Sie für RHEL 8 Repository hinzu packages-microsoft-com-prod :

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

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

   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
   

   Achtung

   CentOS 7 End Of Life (EOL) war 30. Juni 2024. Informationen zu unterstützten Azure CLI-Umgebungen finden Sie im Azure CLI-Supportlebenszyklus

3. Installieren Sie mit dem Befehl dnf install.

   sudo dnf install azure-cli
   

Installieren einer bestimmten Version

Sie müssen zunächst wie zuvor gezeigt die Informationen zum azure-cli-Repository konfigurieren. 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
   

Aktualisieren der Azure CLI

Ab Version 2.11.0 enthält die Azure CLI einen internen Befehl, um ein Update auf die neueste Version durchzuführen.

az upgrade

Mit diesem Befehl werden standardmäßig auch alle installierten Erweiterungen aktualisiert. Weitere az upgrade-Optionen finden Sie auf der Referenzseite für Befehle. Für Azure CLI-Versionen vor 2.11.0 müssen Sie das Tool wie unter Installieren der Azure CLI beschrieben neu installieren, um es zu aktualisieren.

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

sudo dnf update azure-cli

Deinstallieren der Azure CLI

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
   

Daten entfernen

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

rm -rf ~/.azure

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 nach Möglichkeit ein Upgrade Ihres Systems auf eine Version mit offizieller Unterstützung für das python 3.6+-Paket 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 das Azure CLI-Installationsskript mit aus der Quelle erstelltem python 3.6-Paket herunterzuladen und 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

Wenn das dnf-Download-Plug-In noch nicht installiert ist, tritt beim Ausführen des folgenden Codes der Fehler command not found auf. 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

Alternativ können Sie Python 3 auch mithilfe eines zusätzlichen Repositorys installieren. Verwenden Sie diese Methode, wenn Sie python3 eingerichtet haben, aber weiterhin den Fehler python3: command not found erhalten. Stellen Sie sicher, dass es in Ihren Pfad aufgenommen wurde.

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 eine*n Systemadministrator*in, um Informationen dazu zu erhalten, welche Hosts und Ports für diese Proxys verwendet werden müssen.

Die Werte in diesen Variablen werden von vielen Linux-Programmen und während des Installationsvorgangs verwendet. 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 wahrscheinlich mit WSL zusammen. Informationen zum Starten einer Linux-VM in Azure finden Sie in der Dokumentation zum Erstellen einer Linux-VM 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 Issues zu WSL, die sich auf Ihr Problem beziehen. 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.

Voraussetzungen

• Azure CLI 2.38.2 (veröffentlicht am 21. Juni 2024) ist die neueste Version, die auf SUSE Linux Enterprise Server (SLES) und OpenSUSE (Leap) unterstützt wird. Microsoft stellt keine Updates oder Fehlerbehebungen für diese Verteilungen mehr bereit.

• Microsoft entwickelt und unterstützt weiterhin die Azure CLI und das Linux-Installationsskript. SUSE verwaltet und unterstützt Pakete, die von SUSE-/OpenSUSE-Repositorys bereitgestellt werden.

• Auf Azure-, SUSE- und OpenSUSE-VMs, die auf Azure Marketplace-Images basieren, ist die Azure CLI bereits installiert.

Installieren der Azure-Befehlszeilenschnittstelle

Um die Azure CLI unter SUSE/OpenSUSE zu installieren, wählen Sie eine der folgenden Methoden aus:

1. Verwenden Sie das von SUSE in den SUSE-/OpenSUSE-Repositorys bereitgestellte Enterprise-Paket.

2. Verwenden Sie die auf der Registerkarte „Installationsskript (alle)“ beschriebene Installationsmethode.

3. Installieren aus Microsoft-Repositorys

Installieren aus SUSE- oder OpenSUSE-Repositorys

Das RPM-Paket der Azure CLI ist vom python3-Paket abhängig.

sudo zypper install -y azure-cli

Installieren mit dem Installationsskript

Sie können die Azure CLI unter jeder Linux-Version manuell installieren, indem Sie die Option Installationsskript verwenden.

Wenn Sie mit dieser Methode ein Update auf die neueste Version vornehmen, müssen Sie zuerst die vorherige Version und alle Repositorys deinstallieren, die Sie möglicherweise für diese Version hinzugefügt haben.

Installieren aus Microsoft-Repositorys

Führen Sie die folgenden Schritte aus, um die neueste frühere Version der Azure CLI mithilfe von Microsoft-Repositorys zu installieren.

(Dieses Paket wurde mit SLES 15 und openSUSE Leap 15.1 getestet.)

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 wie zuvor gezeigt die Informationen zum azure-cli-Repository konfigurieren. Verfügbare Versionen finden Sie in den Versionshinweisen für die Azure CLI.

1. Zeigen Sie die verfügbaren Versionen mit diesem 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
   

Aktualisieren der Azure CLI

Ab Version 2.11.0 enthält die Azure CLI einen internen Befehl, um ein Update auf die neueste Version durchzuführen.

az upgrade

Mit diesem Befehl werden standardmäßig auch alle installierten Erweiterungen aktualisiert. Weitere az upgrade-Optionen finden Sie auf der Referenzseite für Befehle. Für Azure CLI-Versionen vor 2.11.0 müssen Sie das Tool wie unter Installieren der Azure CLI beschrieben neu installieren, um es zu aktualisieren.

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

sudo zypper refresh
sudo zypper update azure-cli

Deinstallieren der Azure CLI

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
   

Daten entfernen

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

rm -rf ~/.azure

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.

Installation ohne Python 3

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. Neuere Versionen der CLI werden mit Python 2.7 möglicherweise nicht ordnungsgemäß ausgeführt.

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 diese Version 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 eine*n Systemadministrator*in, um Informationen dazu zu erhalten, welche Hosts und Ports für diese Proxys verwendet werden müssen.

Die Werte in diesen Variablen werden von vielen Linux-Programmen und während des Installationsvorgangs verwendet. 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 wahrscheinlich mit WSL zusammen. Informationen zum Starten einer Linux-VM in Azure finden Sie in der Dokumentation zum Erstellen einer Linux-VM 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 Issues zu WSL, die sich auf Ihr Problem beziehen. 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, wird möglicherweise eine Fehlermeldung angezeigt, die besagt, dass cURL die Legitimität des Servers nicht verifizieren und daher keine sichere Verbindung herstellen konnte. Aktualisieren Sie Ihr Zertifikat, um das Problem zu beheben.

sudo zypper update-ca-certificates

Voraussetzungen

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

  Distribution	Version
  Ubuntu	20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish), 24.04 (Noble Numbat)
  Debian	10 (Buster), 11 (Bullseye), 12 (Bookworm)

• 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. Weitere Informationen zu apt remove finden Sie unter Ubuntu-Paketverwaltung. Wenden Sie sich alternativ an Ubuntu.

Installieren der Azure-Befehlszeilenschnittstelle

Zum Installieren der Azure CLI auf Ihrem System stehen zwei Optionen zur Auswahl. Sie können ein Installationsskript herunterladen, das die Installationsbefehle für Sie ausführt, oder die Installationsbefehle nacheinander selbst ausführen. Beide Methoden werden im Folgenden beschrieben:

Option 1: Installieren mit einem Befehl

Die einfachste Möglichkeit zum Installieren der Azure CLI ist ein Skript, das vom Azure CLI-Team verwaltet wird. Dieses Skript führt alle Installationsbefehle in einem Schritt aus. 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 mit curl herunter, und öffnen 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 benötigten Pakete ab:

   sudo apt-get update
   sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
   

2. Laden Sie den Microsoft-Signaturschlüssel herunter, und installieren Sie ihn.

   sudo mkdir -p /etc/apt/keyrings
   curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
     gpg --dearmor | sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null
   sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
   

3. Fügen Sie das Azure CLI-Softwarerepository hinzu:

   AZ_DIST=$(lsb_release -cs)
   echo "Types: deb
   URIs: https://packages.microsoft.com/repos/azure-cli/
   Suites: ${AZ_DIST}
   Components: main
   Architectures: $(dpkg --print-architecture)
   Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources
   

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

Konfigurieren Sie zunächst wie zuvor gezeigt die Informationen zum azure-cli-Repository. Verfügbare Versionen finden Sie unter Versionshinweise für die Azure CLI.

1. Zeigen Sie verfügbare Versionen der Azure CLI an.

   apt-cache policy azure-cli
   

2. Installieren Sie eine bestimmte Version.

   # Obtain the currently installed distribution
   AZ_DIST=$(lsb_release -cs)
   
   # Store an Azure CLI version of choice
   AZ_VER=2.51.0
   
   # Install a specific version
   sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}
   

   Um eine bestimmte Version ohne Variablen zu installieren, ersetzen Sie die angezeigte Azure CLI-Version und den Linux-Verteilungsnamen:

   sudo apt-get install azure-cli=2.51.0-1~bullseye
   

Wenn Die Fehlermeldung Das Paket „azure-cli“ kann nicht gefunden werden angezeigt wird, sind die azure-cli-Repositoryinformationen nicht konfiguriert. Führen Sie die unter Option 2: Ausführliche Installationsanweisungen angegebenen Schritte aus.

Wenn Die Fehlermeldung Version x.xx.x-1~distributionName für azure-cli wurde nicht gefunden angezeigt wird, verwenden Sie lsb_release -cs, um die von Ihnen ausgeführte Verteilung zu finden.

Aktualisieren der Azure CLI

Ab Version 2.11.0 enthält die Azure CLI einen internen Befehl, um ein Update auf die neueste Version durchzuführen.

az upgrade

Mit diesem Befehl werden standardmäßig auch alle installierten Erweiterungen aktualisiert. Weitere az upgrade-Optionen finden Sie auf der Referenzseite für Befehle. Für Azure CLI-Versionen vor 2.11.0 müssen Sie das Tool wie unter Installieren der Azure CLI beschrieben neu installieren, um es zu aktualisieren.

Sie können auch apt-get upgrade zum Aktualisieren des CLI-Pakets verwenden. Durch diesen Befehl werden alle installierten Pakete auf Ihrem System aktualisiert, deren Abhängigkeiten nicht geändert wurden.

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

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 der Azure CLI

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.sources
   

3. Wenn Sie keine anderen Pakete von Microsoft verwenden, entfernen Sie den Signaturschlüssel:

   sudo rm /etc/apt/keyrings/microsoft.gpg
   

4. Entfernen Sie alle nicht benötigten Pakete:

   sudo apt autoremove
   

Daten entfernen

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

rm -rf ~/.azure

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.

Das azure-cli-Paket unterstützt die ARM64-Architektur ab Version 2.46.0 der CLI.

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 es zunächst, 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 abgeleitete Distributionen (etwa 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 ist ein aktualisiertes Azure CLI-Paket nicht sofort nach der Veröffentlichung einer Distributionsversion verfügbar. 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.

Wenn Sie ein Paket für eine ältere Distribution ausprobieren möchten, legen Sie den Wert von AZ_REPO manuell fest, wenn Sie das Repository hinzufügen. Verwenden Sie für Ubuntu-Distributionen das aktuelle jammy-Repository:

AZ_REPO="jammy"

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

AZ_REPO="bookworm"

Wichtig

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 CLI kann von EOS nicht installiert werden, da lsb_release den Wert HERA (Name des EOS-Releases) zurückgibt. Zur Lösung des Problems muss die Datei /etc/apt/sources.list.d/azure-cli.sources korrigiert und Suites: hera in Suites: bionic geändert werden.

Ursprünglicher Dateiinhalt:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Geänderter Dateiinhalt:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

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 eine*n Systemadministrator*in, um Informationen dazu zu erhalten, welche Hosts und Ports für diese Proxys verwendet werden müssen.

Die Werte in diesen Variablen werden von vielen Linux-Programmen und während des Installationsvorgangs verwendet. 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:

• apt.conf man page
• Ubuntu Wiki – apt-get howto

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 wahrscheinlich mit WSL zusammen. Informationen zum Starten einer Linux-VM in Azure finden Sie in der Dokumentation zum Erstellen einer Linux-VM 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 Issues zu WSL, die sich auf Ihr Problem beziehen. 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.

Installieren der Azure-Befehlszeilenschnittstelle

RPMs werden für Azure Linux über CBL-Mariner veröffentlicht. Das azure-cli-Paket unterstützt die ARM64-Architektur ab Version 2.46.0 der CLI.

Führen Sie zum Installieren der Azure-CLI die folgenden Schritte aus:

1. Installieren Sie den offiziellen von Microsoft kuratierten Satz vertrauenswürdiger Stammzertifikate:

   sudo tdnf install ca-certificates
   

2. Installieren Sie die Azure-Befehlszeilenschnittstelle:

   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 der Azure CLI

Aktualisieren Sie die Azure CLI mit dem Befehl tdnf update:

sudo tdnf update azure-cli

Deinstallieren der Azure CLI

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

Daten entfernen

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

rm -rf ~/.azure

Voraussetzungen

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.

Für das Installationsskript für die Azure CLI ist die folgende Software erforderlich:

• Python 3.8.x, 3.9.x, 3.10.x – Weitere Informationen finden Sie unter Supportlebenszyklus – Python-Abhängigkeit.
• libffi
• OpenSSL 1.0.2

Installieren oder Aktualisieren der Azure CLI

Wichtig

Das Installationsskript funktioniert nur unter Python 3.8.x, 3.9.x oder 3.10.x. Dieses Installationsskript funktioniert nicht unter Python 3.11.x oder höheren Versionen.

Sowohl die Installation als auch die Aktualisierung der Azure CLI erfordert eine erneute Ausführung des Installationsskripts:

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

Das Skript kann auch heruntergeladen und lokal ausgeführt werden. Möglicherweise müssen Sie die Shell neu starten, damit die Änderungen wirksam werden.

Deinstallieren der Azure CLI

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. Der Standardinstallationsspeicherort ist das Basisverzeichnis des Benutzers ($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

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.

Installation ohne Python 3

Die Azure CLI unterstützt Python 2.7 seit Version 2.1.0 nicht mehr. Auf Ihrem System ist möglicherweise eine ältere Python-Version als die erforderliche Version 3.6.x installiert. Suchen Sie nach einem python3-Ersatzpaket.

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 nach der Installation mit bash oder zsh nicht ausführen können, löschen Sie den Befehlshash-Cache Ihrer Shell, und überprüfen Sie, ob das Problem behoben wurde.

hash -r

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. Die Position des az Befehls ist ...

 <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 eine*n Systemadministrator*in, um Informationen dazu zu erhalten, welche Hosts und Ports für diese Proxys verwendet werden müssen.

Die Werte in diesen Variablen werden von vielen Linux-Programmen und während des Installationsvorgangs verwendet. 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 wahrscheinlich mit WSL zusammen. Informationen zum Starten einer Linux-VM in Azure finden Sie in der Dokumentation zum Erstellen einer Linux-VM 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 Issues zu WSL, die sich auf Ihr Problem beziehen. 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.

Nächste Schritte

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

Erste Schritte mit Azure CLI 2.0