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.67.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, denyum
-Paket-Manager.
Installieren der Azure-Befehlszeilenschnittstelle
Führen Sie zum Installieren der Azure-CLI die folgenden Schritte aus:
Importieren Sie den Microsoft-Repositoryschlüssel.
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
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
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.
So zeigen Sie verfügbare Versionen mit dem Befehl an:
dnf list --showduplicates azure-cli
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.
Entfernen Sie das Paket aus Ihrem System.
sudo dnf remove azure-cli
Entfernen Sie die Repositoryinformationen, wenn Sie nicht planen, die CLI neu zu installieren.
sudo rm /etc/yum.repos.d/azure-cli.repo
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:
Verwenden Sie das von SUSE in den SUSE-/OpenSUSE-Repositorys bereitgestellte Enterprise-Paket.
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.)
Installieren Sie
curl
:sudo zypper install -y curl
Importieren Sie den Microsoft-Repositoryschlüssel:
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
Erstellen Sie lokale
azure-cli
-Repositoryinformationen:sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
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.
Zeigen Sie die verfügbaren Versionen mit diesem Befehl an:
zypper search --details --match-exact azure-cli
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.
Entfernen Sie das Paket aus Ihrem System.
sudo zypper remove -y azure-cli
Entfernen Sie die Repositoryinformationen, wenn Sie nicht planen, die CLI neu zu installieren.
sudo zypper removerepo azure-cli
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 11 (Bullseye), 12 (Buchwurm) Ubuntu 20.04 (Focal Fossa) und 20.10 (Groovy Gorilla) enthalten ein
azure-cli
-Paket mit der Version2.0.81
, das imuniverse
-Repository verfügbar ist. Dieses Paket ist veraltet und wird nicht empfohlen. Falls dieses Paket installiert ist, entfernen Sie es mit dem Befehlsudo apt remove azure-cli -y && sudo apt autoremove -y
, bevor Sie fortfahren. Weitere Informationen zuapt 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.
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
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
- 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
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.
Zeigen Sie verfügbare Versionen der Azure CLI an.
apt-cache policy azure-cli
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.
Deinstallieren Sie sie mit
apt-get remove
:sudo apt-get remove -y azure-cli
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
Wenn Sie keine anderen Pakete von Microsoft verwenden, entfernen Sie den Signaturschlüssel:
sudo rm /etc/apt/keyrings/microsoft.gpg
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:
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:
Installieren Sie den offiziellen von Microsoft kuratierten Satz vertrauenswürdiger Stammzertifikate:
sudo tdnf install ca-certificates
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).
Entfernen Sie die installierten CLI-Dateien.
rm -r <install location>/lib/azure-cli rm <install location>/bin/az
Ändern Sie die Datei
$HOME/.bash_profile
, indem Sie die folgende Zeile entfernen:<install location>/lib/azure-cli/az.completion
Laden Sie bei Verwendung von
bash
oderzsh
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.