Installieren des Azure CLI unter Linux

Bevor Sie anfangen

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

• Verwenden Sie den yum-Paket-Manager, wenn Sie ein Linux-System nutzen, das den dnf-Paket-Manager nicht unterstützt.

Installieren von Azure CLI

Führen Sie die folgenden Schritte aus, um die Azure CLI zu installieren:

1. Importieren Sie den Microsoft-Repositoryschlüssel. Für RHEL 10 und CentOS Stream 10,

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

   Verwenden Sie für niedrigere Versionen den folgenden Befehl:

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

2. Fügen Sie für RHEL 10 das packages-microsoft-com-prod-Repository hinzu.

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

   Fügen Sie für CentOS Stream 10 das packages-microsoft-com-prod-Repository hinzu.

   sudo dnf install -y https://packages.microsoft.com/config/centos/10/packages-microsoft-prod.rpm
   

   Fügen Sie das Repository für RHEL 9 oder CentOS Stream 9 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 das Repository packages-microsoft-com-prod hinzu:

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

   Fügen Sie für RHEL 7 das Repository azure-cli 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
   

   Vorsicht

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

3. Installieren Sie mit dem dnf install Befehl.

   sudo dnf install azure-cli
   

Installieren einer bestimmten Version

Sie müssen zuerst die azure-cli-Repository-Informationen wie zuvor dargestellt konfigurieren. Verfügbare Versionen finden Sie unter Azure CLI Versionshinweise.

1. Verfügbare Versionen mit dem Befehl anzeigen:

   dnf list --showduplicates azure-cli
   

2. So installieren Sie eine bestimmte Version

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

Azure CLI aktualisieren

Ab Version 2.11.0 stellt die Azure CLI einen In-Tool-Befehl zum Aktualisieren auf die neueste Version bereit.

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. Aktualisieren Sie für Azure CLI Versionen vor 2.11.0, indem Sie es neu installieren, wie in Installieren Sie den Azure CLI beschrieben.

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

sudo dnf update azure-cli

Deinstallieren Azure CLI

Wenn Sie sich entschließen, die Azure CLI zu deinstallieren, tut es uns leid, Sie gehen zu sehen. 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. Wenn Sie einen Fehler gefunden haben, würden wir es schätzen, wenn Sie ein GitHub Problem fileieren.

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 beabsichtigen, Azure CLI neu zu installieren, entfernen Sie dessen Daten.

rm -rf ~/.azure

Problembehandlung

Im Folgenden sind einige häufige Probleme aufgeführt, die bei der Installation mit dnf auftreten. Wenn hier ein Problem nicht behandelt wird, fileieren Sie ein Problem bei GitHub.

Installieren auf RHEL 7.6 oder anderen Systemen ohne Python 3

Wenn möglich, aktualisieren Sie Ihr System auf eine Version mit offizieller Unterstützung für das python 3.6+-Paket. Andernfalls müssen Sie zuerst ein python3-Paket installieren und dann Azure CLI ohne Abhängigkeit installieren.

Sie können den folgenden Befehl verwenden, um das Azure CLI Installationsskript mit python 3.6 aus der Quelle 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:

Zunächst erfordert Azure CLI 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 dann 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 die Schritte 1 und 2 der install-Anweisung aus, um das Azure CLI Repository hinzuzufügen. Nun können Sie das Paket herunterladen und ohne Abhängigkeit installieren.

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

Alternativ können Sie Python 3 auch mit another repo 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. Um diese Werte festzulegen:

# 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]

Möglicherweise möchten Sie auch dnf explizit so konfigurieren, 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

CLI kann nicht auf Windows Subsystem for Linux installiert oder ausgeführt werden.

Da Windows Subsystem for Linux (WSL) eine Übersetzungsebene für Systemaufrufe über der Windows-Plattform ist, tritt möglicherweise ein Fehler auf, wenn Sie versuchen, die Azure CLI zu installieren oder auszufü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 Create a Linux VM in the Azure portal.
• Stellen Sie sicher, dass die neueste Version von WSL ausgeführt wird. Um die neueste Version zu erhalten, aktualisieren Sie Ihre Windows 10 Installation.
• Suchen Sie nach offenen Problemen mit WSL, die Ihr Problem lösen könnten. 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.

Wenn sie weiterhin Probleme beim Installieren oder Ausführen auf WSL haben, sollten Sie installation der CLI für Windows in Betracht ziehen.

Bevor Sie anfangen

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

• SUSE verwaltet und unterstützt Pakete, die von SUSE-/OpenSUSE-Repositorys bereitgestellt werden.

• In Azure haben SUSE- und OpenSUSE-VMs (virtuelle Maschinen), die auf Azure Marketplace Images basieren, die Azure CLI bereits vorinstalliert.

Installieren von Azure CLI

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

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

2. Verwenden Sie die im Tab "Installationsskript (alle)" beschriebene Installationsmethode.

3. Installieren aus Microsoft-Repositorys

Installieren aus SUSE- oder OpenSUSE-Repositorys

Das RPM-Paket des Azure CLI hängt vom python3-Paket ab.

sudo zypper install -y azure-cli

Installieren aus Microsoft-Repositorys

Führen Sie die folgenden Schritte aus, um die neueste historische Version des 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 installieren Sie:

   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 zuerst die azure-cli-Repository-Informationen wie zuvor dargestellt konfigurieren. Verfügbare Versionen finden Sie in den Versionshinweisen 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
   

Azure CLI aktualisieren

Ab Version 2.11.0 stellt die Azure CLI einen In-Tool-Befehl zum Aktualisieren auf die neueste Version bereit.

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. Aktualisieren Sie für Azure CLI Versionen vor 2.11.0, indem Sie es neu installieren, wie in Installieren Sie den Azure CLI beschrieben.

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

sudo zypper refresh
sudo zypper update azure-cli

Deinstallieren Azure CLI

Wenn Sie sich entschließen, die Azure CLI zu deinstallieren, tut es uns leid, Sie gehen zu sehen. 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. Wenn Sie einen Fehler gefunden haben, würden wir es schätzen, wenn Sie ein GitHub Problem fileieren.

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 beabsichtigen, Azure CLI neu zu installieren, entfernen Sie dessen Daten.

rm -rf ~/.azure

Problembehandlung

Im Folgenden sind einige häufige Probleme aufgeführt, die bei der Installation mit zypper auftreten. Wenn hier ein Problem nicht behandelt wird, fileieren Sie ein Problem bei GitHub.

Installieren ohne Python 3

NotImplementedError auf OpenSUSE 15-VM

Der virtuelle Computer OpenSUSE 15 verfügt über eine vorinstallierte Azure CLI mit Version 2.0.45, die veraltet ist und Probleme mit az login aufweist. Entfernen Sie diese Version zusammen mit ihren Abhängigkeiten, bevor Sie der Install-Anweisung folgen, um die neueste Azure CLI hinzuzufügen:

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, können sich die alten Abhängigkeiten auf die neueste Version der Azure CLI auswirken. 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

Auf SLES 12 ist das standardpaket python3 3.4 und wird von Azure CLI nicht unterstützt. Sie können zuerst die Schritte 1 bis 3 der Installationsanweisung ausführen, um das azure-cli Repository hinzuzufügen. Erstellen Sie dann eine höhere Version python3 aus dem Quellcode. Schließlich können Sie das Azure CLI-Paket herunterladen und ohne Abhängigkeit installieren.

Sie können den folgenden Befehl verwenden, um Azure CLI basierend auf den obigen Schritten zu installieren oder zu aktualisieren. Das Skript installiert Python 3.8 unter /usr/local/azcli und konfiguriert Azure CLI, indem es einen Alias von az auf PATH=/usr/local/azcli/bin:$PATH az setzt. Sie können das Skript auch herunterladen und entsprechend Ihren Anforderungen ändern. Sie können beispielsweise 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. Um diese Werte festzulegen:

# 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]

Konfigurieren Sie zypper (über yast2) explizit so, dass dieser Proxy immer verwendet wird. Führen Sie hierfür den yast2 proxy Befehl 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 das Network Services > Proxy-Panel in YaST Control Center verwenden.

Für erweiterte Konfiguration oder weitere Informationen, siehe die 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

CLI kann nicht auf Windows Subsystem for Linux installiert oder ausgeführt werden.

Da Windows Subsystem for Linux (WSL) eine Übersetzungsebene für Systemaufrufe über der Windows-Plattform ist, tritt möglicherweise ein Fehler auf, wenn Sie versuchen, die Azure CLI zu installieren oder auszufü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 Create a Linux VM in the Azure portal.
• Stellen Sie sicher, dass die neueste Version von WSL ausgeführt wird. Um die neueste Version zu erhalten, aktualisieren Sie Ihre Windows 10 Installation.
• Suchen Sie nach offenen Problemen mit WSL, die Ihr Problem lösen könnten. 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.

Wenn sie weiterhin Probleme beim Installieren oder Ausführen auf WSL haben, sollten Sie installation der CLI für Windows in Betracht ziehen.

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

Bevor Sie anfangen

• Der apt Paket-Manager enthält x86_64- und ARM64-Pakete für die Azure CLI, die auf den folgenden Verteilungen getestet wurde.

  Verteilung	Version
  Debian	11 (Bullseye), 12 (Buchwurm)
  Ubuntu	22.04 (Jammy Jellyfish), 24.04 (Noble Numbat)

Installieren von Azure CLI

Es gibt zwei Optionen zum Installieren der Azure CLI auf Ihrem System. 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 des 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 inspizieren möchten, laden Sie es zuerst mit curl herunter und öffnen Sie es in Ihrem bevorzugten Texteditor.

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

Option 2: Schrittweise Installation

Wenn Sie einen schrittweisen Installationsprozess bevorzugen, führen Sie die folgenden Schritte aus, um die Azure CLI zu installieren.

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-Software-Repository 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 azure-cli-Paket.

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

Installieren einer bestimmten Version

Konfigurieren Sie die azure-cli-Repository-Informationen wie zuvor gezeigt. Verfügbare Versionen finden Sie unter Azure CLI Versionshinweise.

1. Zeigen Sie die verfügbaren 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 den angegebenen Namen der Azure CLI Version und der Linux-Verteilung:

   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 Repository-Informationen nicht konfiguriert. Folgen Sie den in Option 2: Schritt-für-Schritt-Installationsanweisung gegebenen Schritten.

Wenn Sie die Fehlermeldung Version x.xx.x-1~distributionName für azure-cli wurde nicht gefunden erhalten, verwenden Sie lsb_release -cs, um herauszufinden, welche Distribution Sie verwenden.

Azure CLI aktualisieren

Ab Version 2.11.0 stellt die Azure CLI einen In-Tool-Befehl zum Aktualisieren auf die neueste Version bereit.

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. Aktualisieren Sie für Azure CLI Versionen vor 2.11.0, indem Sie es neu installieren, wie in Installieren Sie den Azure CLI beschrieben.

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

Um nur die CLI zu aktualisieren, verwenden Sie apt-get install.

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

Deinstallieren Azure CLI

Wenn Sie sich entschließen, die Azure CLI zu deinstallieren, tut es uns leid, Sie gehen zu sehen. 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. Wenn Sie einen Fehler gefunden haben, würden wir es schätzen, wenn Sie ein GitHub Problem fileieren.

1. Deinstallieren Sie sie mit apt-get remove:

   sudo apt-get remove -y azure-cli
   

2. Wenn Sie nicht beabsichtigen, die CLI neu zu installieren, entfernen Sie die Azure CLI Repositoryinformationen:

   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 beabsichtigen, Azure CLI neu zu installieren, entfernen Sie dessen Daten.

rm -rf ~/.azure

Problembehandlung

Im Folgenden sind einige häufige Probleme aufgeführt, die bei der Installation mit apt auftreten. Wenn hier ein Problem nicht behandelt wird, fileieren Sie ein Problem bei GitHub.

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

„lsb_release“ gibt nicht die richtige Basisdistributionsversion zurück

Einige Ubuntu- oder andere Debian-basierte Distributionen (etwa Linux Mint) geben möglicherweise nicht den richtigen Versionsnamen von lsb_release 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 den AZ_REPO Wert manuell festlegen, wenn Sie das Repository hinzufügen. 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 Distribution verfügbar. Die Azure CLI ist so konzipiert, dass sie für zukünftige Versionen von Abhängigkeiten widerstandsfähig ist und von so wenig wie möglich abhängt. 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 neueste jammy-Repository:

AZ_REPO="jammy"

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

AZ_REPO="bookworm"

Elementary OS (EOS) kann die Azure CLI nicht installieren.

EOS kann die Azure CLI nicht installieren, da lsb_release den Wert HERA zurückgibt, welcher der EOS-Releasename ist. Die Lösung besteht darin, die Datei /etc/apt/sources.list.d/azure-cli.sources zu korrigieren und Suites: hera in Suites: bionic zu ändern.

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. Um diese Werte festzulegen:

# 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]

Möglicherweise möchten Sie auch apt explizit so konfigurieren, 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, Ihre vorhandene globale Konfigurationsdatei, eine vorhandene Proxykonfigurationsdatei, 40proxies, oder 99local zu verwenden, beachten Sie dabei jedoch die Anforderungen Ihrer Systemadministration.

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

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

• apt.conf Man-Seite
• 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.`

CLI kann nicht auf Windows Subsystem for Linux installiert oder ausgeführt werden.

Da Windows Subsystem for Linux (WSL) eine Übersetzungsebene für Systemaufrufe über der Windows-Plattform ist, tritt möglicherweise ein Fehler auf, wenn Sie versuchen, die Azure CLI zu installieren oder auszufü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 Create a Linux VM in the Azure portal.
• Stellen Sie sicher, dass die neueste Version von WSL ausgeführt wird. Um die neueste Version zu erhalten, aktualisieren Sie Ihre Windows 10 Installation.
• Suchen Sie nach offenen Problemen mit WSL, die Ihr Problem lösen könnten. 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.

Wenn sie weiterhin Probleme beim Installieren oder Ausführen auf WSL haben, sollten Sie installation der CLI für Windows in Betracht ziehen.

Installieren von Azure CLI

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 die folgenden Schritte aus, um die Azure CLI zu installieren:

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

   sudo tdnf install ca-certificates
   

2. Azure CLI installieren:

   sudo tdnf install azure-cli
   

Installieren einer bestimmten Version

Verfügbare Versionen finden Sie unter Azure CLI Versionshinweise.

Verfügbare Versionen mit dem Befehl anzeigen:

tdnf list azure-cli

So installieren Sie eine bestimmte Version:

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

Azure CLI aktualisieren

Aktualisieren Sie die Azure CLI mit dem Befehl tdnf update:

sudo tdnf update azure-cli

Deinstallieren Azure CLI

Wenn Sie sich entschließen, die Azure CLI zu deinstallieren, tut es uns leid, Sie gehen zu sehen. 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. Wenn Sie einen Fehler gefunden haben, würden wir es schätzen, wenn Sie ein GitHub Problem fileieren.

Entfernen Sie das Paket aus Ihrem System:

sudo tdnf remove azure-cli

Daten entfernen

Wenn Sie nicht beabsichtigen, Azure CLI neu zu installieren, entfernen Sie dessen Daten.

rm -rf ~/.azure