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.70.0. Informationen zur neuesten Version finden Sie in den Versionshinweisen. Führen Sie az version aus, um die installierte Version zu ermitteln und festzustellen, ob Sie eine Aktualisierung benötigen.
Bevor Sie beginnen
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 die Azure CLI weiter und unterstützt auch das Linux-Installationsskript.
Verwenden Sie den
yum
-Paket-Manager, wenn Sie ein Linux-System nutzen, das dendnf
-Paket-Manager nicht unterstützt.
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 das Repository
packages-microsoft-com-prod
hinzu: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
Achtung
CentOS 7 End Of Life (EOL) war 30. Juni 2024. Informationen zu unterstützten Azure CLI-Umgebungen finden Sie unter Azure CLI-Supportlebenszyklus
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 in den Versionshinweisen für die Azure CLI.
Verfügbare Versionen mit dem Befehl anzeigen:
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 auf die neueste Version zu aktualisieren.
az upgrade
Mit diesem Befehl werden standardmäßig auch alle installierten Erweiterungen aktualisiert. Für weitere az upgrade
-Optionen, siehe die Befehlsreferenzseite. Für Azure CLI-Versionen vor 2.11.0 müssen Sie das Tool neu installieren, um es zu aktualisieren, wie unter "Installieren der Azure CLI" beschrieben.
Sie können die Azure CLI auch mit dem dnf update
-Befehl aktualisieren.
sudo dnf update azure-cli
Deinstallieren der Azure CLI
Wenn Sie sich entscheiden, die Azure CLI zu deinstallieren, tut es uns leid, Sie verlieren zu müssen. 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. Wenn Sie einen Fehler entdeckt haben, wären wir Ihnen dankbar, wenn Sie ein GitHub-Issue 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
Im Folgenden sind einige häufige Probleme aufgeführt, die bei der Installation mit dnf
auftreten. Falls ein Problem auftritt, das hier nicht behandelt wird, erstellen Sie ein GitHub-Problem.
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 und dann die Azure CLI ohne Abhängigkeiten installieren.
Sie können den folgenden Befehl verwenden, um das aus dem Quellcode erstellte Azure-CLI-Installationsskript 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:
Zuerst erfordert die Azure CLI SSL 1.1+
, und Sie müssen openssl 1.1
aus dem Quellcode 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 die Schritte 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 Plugin noch nicht installiert ist, treten Sie auf einen command not found
-Fehler beim Ausführen des folgenden Codes. Verwenden Sie dnf install 'dnf-command(download)'
zum Installieren des dnf-download-Plugins.
sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm
Alternativ können Sie Python 3 auch über ein anderes Repository 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 .bashrc
Datei exportieren.
Berücksichtigen Sie dabei immer die Sicherheitsrichtlinien Ihres Unternehmens und die Anforderungen Ihres Systemadministrators.
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
Die CLI kann auf dem Windows-Subsystem für Linux nicht installiert oder ausgeführt werden.
Da das Windows-Subsystem für Linux (WSL) eine Übersetzungsebene für Systemaufrufe auf der Windows-Plattform ist, können Sie auf einen Fehler stoßen, 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 zum Erstellen einer Linux-VM im 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, erstellen Sie ein neues Problem mit WSL, und stellen Sie sicher, dass Sie so viele Informationen wie möglich angeben.
Wenn beim Installieren oder Ausführen auf dem WSL weiterhin Probleme auftreten, erwägen Sie die Installation der CLI für Windows.
Bevor Sie beginnen
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-Repositories bereitgestellte Enterprise-Paket.
Verwenden Sie die im Tab "Installationsskript (alle)" beschriebene Installationsmethode.
Installieren aus Microsoft-Repositories
Installieren aus SUSE- oder OpenSUSE-Repositorys
Das RPM-Paket der Azure CLI ist von dem 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 Installationsskript-Option 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
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 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 zunächst die azure-cli
-Repository-Informationen wie zuvor gezeigt konfigurieren. Verfügbare Versionen finden Sie in den Versionshinweisen zur 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 bietet die Azure CLI einen internen Befehl, um auf die neueste Version zu aktualisieren.
az upgrade
Mit diesem Befehl werden standardmäßig auch alle installierten Erweiterungen aktualisiert. Für weitere az upgrade
-Optionen sehen Sie die Befehlsreferenzseite an. Für Azure CLI-Versionen vor 2.11.0 aktualisieren Sie, indem Sie es wie unter Installieren der Azure CLI beschrieben neu installieren.
Sie können das Paket auch mit dem zypper update
-Befehl 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 könnte. Unser Ziel ist eine fehlerfreie und benutzerfreundliche Azure CLI. Wenn Sie einen Fehler gefunden haben, wären wir Ihnen dankbar, wenn Sie ein GitHub-Issue 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, erstellen Sie ein Issue auf GitHub.
Installation ohne Python 3
Wichtig
Das RPM-Paket der Azure CLI hängt vom python3
-Paket ab. Auf Ihrem System handelt es sich dabei möglicherweise um eine ältere Python-Version als die erforderliche Version 3.6.x. Sollte das Auswirkungen auf Sie haben, suchen Sie nach einem Ersatzpaket python3
.
Denken Sie daran, dass Python 2 am 1. Januar 2020 ausgelaufen ist und keine Updates mehr erhält. Die Unterstützung der Azure CLI für Python 2.7 wurde seit Version 2.1.0 eingestellt. Neuere Versionen der CLI werden mit Python 2.7 möglicherweise nicht ordnungsgemäß ausgeführt.
NotImplementedError unter OpenSUSE 15 VM
Auf der OpenSUSE 15-VM ist die Azure CLI in Version 2.0.45 vorinstalliert, die veraltet ist und Probleme mit az login
aufweist. Entfernen Sie diese Version mit den zugehörigen Abhängigkeiten, bevor Sie die Installationsanweisung befolgen, um die neueste Version der 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, 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
# 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 Standard-python3
-Paket Version 3.4 und wird von der 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. 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 veranlasst die Azure CLI, diese zu verwenden, indem es den Alias az
auf PATH=/usr/local/azcli/bin:$PATH az
festlegt. 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, vergewissern Sie sich, dass Sie die HTTP_PROXY
und HTTPS_PROXY
Variablen 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]
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, diese Variablen in Ihrer .bashrc
-Datei zu 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 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
Die CLI kann auf dem Windows-Subsystem für Linux nicht installiert oder ausgeführt werden.
Da das Windows-Subsystem für Linux (WSL) eine Übersetzungsebene für Systemaufrufe auf der Windows-Plattform ist, können Fehler auftreten, 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. Um eine Linux-VM in Azure zu starten, siehe die Dokumentation zum erstellen einer Linux-VM im 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.
- Prüfen Sie, ob es offene Probleme mit WSL gibt, die Ihr Problem möglicherweise lösen. Häufig finden Sie Vorschläge, wie Sie das Problem umgehen, bzw. Informationen zu einem Release, in dem das Problem behoben wird.
- Wenn es noch keinen bestehenden Eintrag für Ihr Problem gibt, erstellen Sie ein neues Problem bei WSL, und geben Sie dabei möglichst viele Details an.
Sollten beim Installieren oder Ausführen auf dem WSL weiterhin Probleme auftreten, erwägen Sie die Installation der CLI für Windows.
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 beginnen
Der
apt
-Paket-Manager enthält x86_64- und ARM64-Pakete für die Azure-Befehlszeilenschnittstelle (Azure CLI), die mit den folgenden Distributionen getestet wurden.Verteilung Version Debian 11 (Bullseye), 12 (Buchwurm) Ubuntu 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish), 24.04 (Noble Numbat) 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 Befehl `sudo apt remove azure-cli -y && sudo apt autoremove -y`, bevor Sie fortfahren. Weitere Informationen zuapt remove
finden Sie in der Ubuntu-Paketverwaltung oder bei Ask 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 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 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 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
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 Release-Hinweise.
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
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.
Aktualisieren der Azure CLI
Ab Version 2.11.0 bietet die Azure CLI einen Befehl im Tool, um auf die neueste Version zu aktualisieren.
az upgrade
Mit diesem Befehl werden standardmäßig auch alle installierten Erweiterungen aktualisiert. Für weitere az upgrade
-Optionen sehen Sie sich die Befehlsreferenzseite an. Für Azure CLI-Versionen vor der Version 2.11.0 müssen Sie das Tool gemäß der Beschreibung unter "Installieren der Azure CLI" 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
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 der Azure CLI
Wenn Sie sich entscheiden, die Azure CLI zu deinstallieren, bedauern wir es sehr, Sie gehen zu sehen. Verwenden Sie vor der Deinstallation den az feedback
-Befehl, um uns mitzuteilen, was verbessert oder repariert werden muss. Unser Ziel ist eine fehlerfreie und benutzerfreundliche Azure CLI. Wenn Sie einen Fehler gefunden haben, wären wir Ihnen dankbar, wenn Sie ein GitHub-Issue melden.
Deinstallieren 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
Hier sind einige häufige Probleme, die bei der Installation mit apt
auftreten. Falls ein Problem auftritt, das hier nicht behandelt wird, melden Sie es auf GitHub.
Das azure-cli-Paket unterstützt die ARM64-Architektur ab der CLI-Version 2.46.0.
Kein Modulproblem unter Ubuntu 20.04 (Focal) / WSL
Wenn Sie azure-cli
auf Focal
installiert haben, ohne das Azure CLI-Softwarerepository in Schritt 3 der Anweisungen zur manuellen Installation hinzuzufügen oder unser Skript zu verwenden, könnten Probleme auftreten, wie zum Beispiel kein Modul mit dem Namen 'decorator' oder 'antlr4'. Dies liegt daran, dass das von Ihnen installierte Paket eine veraltete Version von azure-cli 2.0.81
aus dem focal/universe
Repository ist. Entfernen Sie es zunächst, indem Sie
„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 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 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 neueste 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.
Elementary OS (EOS) scheitert bei der Installation der Azure-Befehlszeilenschnittstelle.
Die Installation der Azure CLI schlägt fehl, weil lsb_release
HERA
zurückgibt, was der Name des EOS-Releases 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. 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 Basic-Authentifizierung verwenden, wird empfohlen, dass Sie diese Variablen in Ihrer .bashrc
Datei 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, 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 Anleitung
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 über der Windows-Plattform. Daher kann möglicherweise ein Fehler auftreten, 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. Um eine Linux-VM in Azure zu starten, finden Sie Informationen 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 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 keine bestehende Anfrage für Ihr Problem, erstellen Sie eine neue Anfrage bei WSL und fügen Sie möglichst viele Informationen hinzu.
Sollten weiterhin Probleme bei der Installation oder Ausführung unter WSL auftreten, erwägen Sie die Installation der CLI für Windows.
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 CLI-Version 2.46.0.
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 in den Azure CLI-Versionshinweisen.
Mit dem Befehl können Sie verfügbare Versionen anzeigen.
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 tdnf update
-Befehl:
sudo tdnf update azure-cli
Deinstallieren der Azure CLI
Es tut uns leid, dass Sie sich entschieden haben, die Azure CLI zu deinstallieren. 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 Ticket auf GitHub erstellen.
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
Bevor Sie beginnen
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 – Für weitere Informationen siehe Support-Life-Cycle – 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, dass Sie sich entschieden haben, die Azure CLI zu deinstallieren. 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. Wenn Sie einen Fehler gefunden haben, wären wir Ihnen dankbar, wenn Sie ein GitHub-Issue 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 Ihre
$HOME/.bash_profile
Datei, indem Sie die folgende Zeile entfernen:<install location>/lib/azure-cli/az.completion
Wenn Sie
bash
oderzsh
verwenden, laden Sie 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 Sie ein Problem feststellen, das hier nicht behandelt wird, melden Sie es bitte auf GitHub.
Installation ohne Python 3
Die Azure CLI hat die Unterstützung für Python 2.7 seit Version 2.1.0 eingestellt.
Auf Ihrem System ist möglicherweise eine ältere Python-Version als die erforderliche Version 3.6.x installiert.
Suchen Sie ein Ersatzpaket für das python3
.
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, versuchen Sie, den Befehlshash-Cache Ihrer Shell zu löschen, 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 az
-Befehl in Ihrem $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. Zum Festlegen dieser Werte:
# 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 Basic Authentifizierung verwenden, wird empfohlen, dass Sie diese Variablen in Ihrer .bashrc
Datei 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 Übersetzungsschicht für Systemaufrufe, die auf der Windows-Plattform läuft. Daher kann es vorkommen, dass ein Fehler auftritt, 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. Um eine Linux-VM in Azure zu starten, siehe die Dokumentation 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 Ihr Problem möglicherweise lösen. 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 Informationen an.
Sollten beim Installieren oder Ausführen unter WSL weiterhin Probleme auftreten, 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