De Azure CLI installeren in Linux

  • Artikel

In dit artikel wordt uitgelegd hoe u de Azure CLI installeert in Linux. Selecteer het juiste pakketbeheer voor uw distributie in de opties bovenaan de pagina. Het gebruik van pakketbeheer van een Linux-distributie wordt aanbevolen, maar u kunt de Azure CLI handmatig installeren in Linux door de optie Script installeren te selecteren.

De huidige versie van de Azure CLI is 2.59.0. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release. Als u de geïnstalleerde versie wilt zoeken en wilt zien of u wilt bijwerken, voert u az version uit.

Voordat u begint

  • Azure CLI 2.38.1 (uitgebracht op 01 september 2023) is de laatst ondersteunde versie op RHEL 7 en Centos 7 en blijft beveiligingsoplossingen ontvangen tot het einde van de levensduur van de besturingssystemen. Microsoft biedt geen andere updates of bugfixes voor deze distributies.

  • Microsoft blijft Azure CLI en het Linux-installatiescript ontwikkelen en ondersteunen.

  • Gebruik pakketbeheer yum als u een Linux-systeem gebruikt dat geen ondersteuning biedt voor pakketbeheer dnf .

Azure-CLI installeren

Voer de volgende stappen uit om de Azure CLI te installeren:

  1. Importeer de sleutel voor de Microsoft-opslagplaats.

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

  2. Voor RHEL 9 of CentOS Stream 9 voegt u een opslagplaats toe packages-microsoft-com-prod :

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

    Voeg voor RHEL 8 of CentOS Stream 8 opslagplaats toe packages-microsoft-com-prod :

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

    Voeg voor RHEL 7 of CentOS 7 opslagplaats toe 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

  3. Voer de installatie uit met de opdracht dnf install.

    sudo dnf install azure-cli

Specifieke versie installeren

U moet eerst opslagplaatsgegevens configureren azure-cli zoals eerder is weergegeven. Beschikbare versies vindt u in de releaseopmerkingen van Azure CLI.

  1. Beschikbare versies weergeven met de opdracht:

    dnf list --showduplicates azure-cli

  2. Een specifieke versie installeren:

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

Azure CLI bijwerken

Vanaf versie 2.11.0 biedt de Azure CLI een opdracht in het hulpprogramma om bij te werken naar de nieuwste versie.

az upgrade

Met deze opdracht worden ook alle geïnstalleerde extensies standaard bijgewerkt. Zie de referentiepagina voor opdrachten voor meer az upgrade opties. Update voor Azure CLI-versies vóór 2.11.0 door opnieuw te installeren, zoals beschreven in De Azure CLI installeren.

U kunt de Azure CLI ook bijwerken met de dnf update opdracht.

sudo dnf update azure-cli

Azure CLI verwijderen

We zouden het jammer vinden als u besluit om Azure CLI te verwijderen. Voordat u de CLI verwijdert, gebruikt u de az feedback-opdracht om ons te laten weten wat er kan worden verbeterd of opgelost. Ons doel is om Azure CLI zo gebruiksvriendelijk mogelijk te maken en vrij te houden van bugs. Als u een bug vindt, zouden we het waarderen als u dat meldt op GitHub.

  1. Verwijder het pakket van uw systeem.

    sudo dnf remove azure-cli

  2. Als u niet van plan bent om de CLI opnieuw te installeren, verwijdert u de gegevens in de opslagplaats.

    sudo rm /etc/yum.repos.d/azure-cli.repo

  3. Als u geen andere Microsoft-pakketten gebruikt, verwijdert u de ondertekeningssleutel.

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

Gegevens verwijderen

Als u azure CLI niet opnieuw wilt installeren, verwijdert u de bijbehorende gegevens.

rm -rf ~/.azure

Probleemoplossing

Hieronder volgen enkele veelvoorkomende problemen tijdens het installeren met dnf. Als u een probleem ondervindt dat hier niet wordt behandeld, kunt u een probleem indienen op GitHub.

Installeren op RHEL 7.6 of andere systemen zonder Python 3

Als u dat kunt, voert u een upgrade van uw systeem uit naar een versie met officiële ondersteuning voor python 3.6+ het pakket. Anders moet u eerst een python3 pakket installeren en vervolgens Azure CLI zonder afhankelijkheid installeren.

U kunt de volgende opdracht gebruiken om het Azure CLI-installatiescript te downloaden en te installeren met python 3.6 de volgende bron:

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

U kunt dit ook stapsgewijs doen:

Eerst vereist SSL 1.1+ Azure CLI en moet u bouwen openssl 1.1 vanaf de bron voordat u het volgende bouwt python3:

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

Bouw vervolgens Python 3 vanuit de bron:

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

Volg ten slotte stap 1 en 2 van de installatie-instructie om de Azure CLI-opslagplaats toe te voegen. U kunt het pakket nu downloaden en installeren zonder afhankelijkheid.

Notitie

Als de dnf-downloadinvoegtoepassing nog niet is geïnstalleerd, treedt er een command not found fout op bij het uitvoeren van de volgende code. Gebruik dnf install 'dnf-command(download)' dit om de dnf-downloadinvoegtoepassing te installeren.

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

Als alternatief kunt u Python 3 ook installeren met behulp van een andere opslagplaats. Gebruik deze methode als u deze hebt ingesteld python3 , maar nog steeds de fout python3: command not foundkrijgt. Zorg ervoor dat deze is opgenomen in uw pad.

scl enable rh-python36 bash

Proxy blokkeert verbinding

Als u geen verbinding kunt maken met een externe resource vanwege een proxy, controleert u of u de HTTP_PROXY variabelen HTTPS_PROXY in uw shell correct hebt ingesteld. Neem contact op met uw systeembeheerder om te weten welke host(s) en poorten voor deze proxy's moeten worden gebruikt.

De waarden in deze variabelen worden door veel Linux-programma's en tijdens het installatieproces gebruikt. Ga als volgt te werk om deze waarden in te stellen:

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

Belangrijk

Als u zich achter een proxy bevindt, moeten deze shellvariabelen worden ingesteld om verbinding te maken met Azure-services met de CLI. Als u geen basisverificatie gebruikt, is het raadzaam om deze variabelen in uw .bashrc bestand te exporteren. Volg altijd het beveiligingsbeleid van uw bedrijf en de vereisten van uw systeembeheerder.

Mogelijk wilt u deze proxy ook expliciet configureren dnf . Zorg ervoor dat de volgende regels worden weergegeven onder de [main] sectie van /etc/dnf/dnf.conf:

[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

Als u de Ondertekeningssleutel van Microsoft en het pakket uit onze opslagplaats wilt ophalen, moet uw proxy HTTPS-verbindingen met het volgende adres toestaan:

  • https://packages.microsoft.com

Cli kan niet worden geïnstalleerd of uitgevoerd op Windows-subsysteem voor Linux

Omdat Windows-subsysteem voor Linux (WSL) een systeemoproepvertalingslaag boven op het Windows-platform is, kan er een fout optreden bij het installeren of uitvoeren van de Azure CLI. De CLI is afhankelijk van sommige functies die mogelijk een bug in WSL hebben. Als er een fout optreedt, ongeacht hoe u de CLI installeert, is er een goede kans dat het een probleem is met WSL en niet met het CLI-installatieproces.

Ga als volgende te werk om uw WSL-installatie op te lossen en mogelijke problemen op te lossen:

Als u problemen ondervindt bij het installeren of uitvoeren op WSL, kunt u overwegen om de CLI voor Windows te installeren.

Voordat u begint

  • Azure CLI 2.38.1 (uitgebracht op 01 september 2023) is de nieuwste versie die wordt ondersteund op SUSE Linux Enterprise Server (SLES) en OpenSUSE (Leap) en blijft beveiligingsoplossingen ontvangen tot eind juni 2024. Microsoft biedt geen andere updates of bugfixes voor deze distributies.

  • Microsoft blijft de Azure CLI en het Linux-installatiescript ontwikkelen en ondersteunen. SUSE onderhoudt en ondersteunt pakketten die worden geleverd door SUSE/OpenSUSE-opslagplaatsen.

  • In Azure hebben SUSE en OpenSUSE virtuele machines (VM's) op basis van Azure Marketplace-installatiekopieën de Azure CLI al geïnstalleerd.

Azure-CLI installeren

Als u Azure CLI wilt installeren op SUSE/OpenSUSE, kiest u een van de volgende methoden:

  1. Gebruik het Enterprise-pakket van SUSE in de SUSE-/OpenSUSE-opslagplaatsen.

  2. Gebruik de installatiemethode die wordt beschreven op het tabblad 'Installatiescript (any)'.

  3. Installeren vanuit Microsoft-opslagplaatsen

Installeren vanuit SUSE- of OpenSUSE-opslagplaatsen

Het RPM-pakket van de Azure CLI is afhankelijk van het python3 pakket.

sudo zypper install -y azure-cli

Installeren met het installatiescript

U kunt de Azure CLI handmatig installeren op elke versie van Linux met behulp van de optie Script installeren.

Als u met deze methode bijwerkt naar de meest recente versie, moet u eerst de vorige versie verwijderen en alle opslagplaatsen die u mogelijk hebt toegevoegd voor die versie.

Installeren vanuit Microsoft-opslagplaatsen

Volg deze stappen om de meest recente historische versie van de Azure CLI te installeren met behulp van Microsoft-opslagplaatsen.

(Dit pakket is getest met SLES 15 en OpenSUSE Leap 15.1)

  1. curl installeren:

    sudo zypper install -y curl

  2. Importeer de sleutel voor de Microsoft-opslagplaats:

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

  3. Maak gegevens voor lokale azure-cli-opslagplaats:

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli

  4. Werk de index van het zypper-pakket bij en installeer:

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

    Invoer 2 om door te gaan met installeren door enkele van de afhankelijkheden te negeren.

Specifieke versie installeren

U moet eerst opslagplaatsgegevens configureren azure-cli zoals eerder is weergegeven. Beschikbare versies vindt u in de releaseopmerkingen van Azure CLI.

  1. Bekijk de beschikbare versies met behulp van deze opdracht:

    zypper search --details --match-exact azure-cli

  2. Een specifieke versie installeren:

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

Azure CLI bijwerken

Vanaf versie 2.11.0 biedt de Azure CLI een opdracht in het hulpprogramma om bij te werken naar de nieuwste versie.

az upgrade

Met deze opdracht worden ook alle geïnstalleerde extensies standaard bijgewerkt. Zie de referentiepagina voor opdrachten voor meer az upgrade opties. Update voor Azure CLI-versies vóór 2.11.0 door opnieuw te installeren, zoals beschreven in De Azure CLI installeren.

U kunt het pakket ook bijwerken met de zypper update opdracht.

sudo zypper refresh
sudo zypper update azure-cli

Azure CLI verwijderen

We zouden het jammer vinden als u besluit om Azure CLI te verwijderen. Voordat u de CLI verwijdert, gebruikt u de az feedback-opdracht om ons te laten weten wat er kan worden verbeterd of opgelost. Ons doel is om Azure CLI zo gebruiksvriendelijk mogelijk te maken en vrij te houden van bugs. Als u een bug vindt, zouden we het waarderen als u dat meldt op GitHub.

  1. Verwijder het pakket van uw systeem.

    sudo zypper remove -y azure-cli

  2. Als u niet van plan bent om de CLI opnieuw te installeren, verwijdert u de gegevens in de opslagplaats.

    sudo zypper removerepo azure-cli

  3. Als u geen andere Microsoft-pakketten gebruikt, verwijdert u de Ondertekeningssleutel van Microsoft.

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

Gegevens verwijderen

Als u azure CLI niet opnieuw wilt installeren, verwijdert u de bijbehorende gegevens.

rm -rf ~/.azure

Probleemoplossing

Hieronder volgen enkele veelvoorkomende problemen tijdens het installeren met zypper. Als u een probleem ondervindt dat hier niet wordt behandeld, kunt u een probleem indienen op GitHub.

Installeren zonder Python 3

Belangrijk

Het RPM-pakket van de Azure CLI is afhankelijk van het python3 pakket. Op uw systeem kan dit een Python-versie zijn die voorafgaat aan de vereiste van Python 3.6.x. Als dit van invloed is op u, zoekt u een vervangend python3 pakket.

Houd er rekening mee dat Python 2 op 1 januari 2020 het einde van de levensduur (EOL) heeft bereikt en geen updates meer ontvangt. Azure CLI heeft de ondersteuning voor Python 2.7 verwijderd sinds versie 2.1.0. Nieuwere versies van de CLI worden mogelijk niet correct uitgevoerd met Behulp van Python 2.7.

NotImplementedError op OpenSUSE 15 VM

De OpenSUSE 15-VM heeft een vooraf geïnstalleerde Azure CLI met versie 2.0.45, die verouderd is en problemen heeft met az login. Verwijder deze versie samen met de bijbehorende afhankelijkheden voordat u de installatie-instructie volgt om de nieuwste Azure CLI toe te voegen:

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

Als u de Azure CLI hebt bijgewerkt zonder de afhankelijkheden van versie 2.0.45 te verwijderen, kunnen de oude afhankelijkheden van invloed zijn op de nieuwste versie van de Azure CLI. U moet de oude versie terug toevoegen om een koppeling naar de bijbehorende afhankelijkheden te maken en vervolgens samen met de bijbehorende afhankelijkheden te verwijderen azure-cli :

# 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

Installeren op SLES 12 of andere systemen zonder Python 3.6

Op SLES 12 is het standaardpakket python3 3.4 en wordt het niet ondersteund door Azure CLI. U kunt eerst stap 1-3 van de installatie-instructie volgen om de azure-cli opslagplaats toe te voegen. Bouw vervolgens een hogere versie python3 van de bron. Ten slotte kunt u het Azure CLI-pakket downloaden en installeren zonder afhankelijkheid.

U kunt de volgende opdracht gebruiken om Azure CLI te installeren of bij te werken op basis van de bovenstaande stappen. Met het script wordt Python 3.8 geïnstalleerd /usr/local/azcli en wordt azure CLI gebruikt door een alias in te PATH=/usr/local/azcli/bin:$PATH azstellen op az . U kunt het script ook downloaden en wijzigen op basis van uw behoeften. U kunt bijvoorbeeld de Python-versie of installatielocatie wijzigen.

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

Voor de eerste keer installeren moet u de volgende opdracht uitvoeren om de alias te activeren:

source ~/.bashrc

Proxy blokkeert verbinding

Als u geen verbinding kunt maken met een externe resource vanwege een proxy, controleert u of u de HTTP_PROXY variabelen HTTPS_PROXY in uw shell correct hebt ingesteld. Neem contact op met uw systeembeheerder om te weten welke host(s) en poorten voor deze proxy's moeten worden gebruikt.

De waarden in deze variabelen worden door veel Linux-programma's en tijdens het installatieproces gebruikt. Ga als volgt te werk om deze waarden in te stellen:

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

Belangrijk

Als u zich achter een proxy bevindt, moeten deze shellvariabelen worden ingesteld om verbinding te maken met Azure-services met de CLI. Als u geen basisverificatie gebruikt, is het raadzaam om deze variabelen in uw .bashrc bestand te exporteren. Volg altijd het beveiligingsbeleid van uw bedrijf en de vereisten van uw systeembeheerder.

U kunt ook expliciet configureren zypper (via yast2) om deze proxy altijd te gebruiken. Voer hiervoor de yast2 proxy opdracht uit als superuser en vul de informatie in die in het formulier wordt weergegeven. Als u een vensterbeheerder op uw systeem hebt, kunt u ook het Network Services > Proxy deelvenster in het YaST Control Centerdeelvenster gebruiken.

Raadpleeg de documentatie voor de OpenSUSE-proxyconfiguratie voor geavanceerde configuratie of meer informatie

Om de Ondertekeningssleutel van Microsoft op te halen en het pakket op te halen uit onze opslagplaats, moet uw proxy HTTPS-verbindingen met de volgende adressen toestaan:

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

Cli kan niet worden geïnstalleerd of uitgevoerd op Windows-subsysteem voor Linux

Omdat Windows-subsysteem voor Linux (WSL) een systeemoproepvertalingslaag boven op het Windows-platform is, kan er een fout optreden bij het installeren of uitvoeren van de Azure CLI. De CLI is afhankelijk van sommige functies die mogelijk een bug in WSL hebben. Als er een fout optreedt, ongeacht hoe u de CLI installeert, is er een goede kans dat het een probleem is met WSL en niet met het CLI-installatieproces.

Ga als volgende te werk om uw WSL-installatie op te lossen en mogelijke problemen op te lossen:

Als u problemen ondervindt bij het installeren of uitvoeren op WSL, kunt u overwegen om de CLI voor Windows te installeren.

Probleem met SSL-certificaat

Wanneer een certificaat is verbroken of verouderd op een computer, krijgt u mogelijk een foutmelding die aangeeft dat curl de geldigheid van de server niet heeft geverifieerd en daarom geen beveiligde verbinding tot stand kon brengen. Werk uw certificaat bij om het probleem op te lossen.

sudo zypper update-ca-certificates

Voordat u begint

  • Pakketbeheer apt bevat x86_64- en ARM64-pakketten voor de Azure CLI die is getest op de volgende distributies.

    Distributie Versie
    Ubuntu 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish)
    Debian 10 (Buster), 11 (Bullseye), 12 (Boekworm)

  • Ubuntu 20.04 (Focal Fossa) en 20.10 (Groovy Gorilla) bevatten een azure-cli pakket met versie 2.0.81 van de universe opslagplaats. Dit pakket is verouderd en wordt niet aanbevolen. Als dit pakket is geïnstalleerd, verwijdert u het pakket voordat u doorgaat door de opdracht sudo apt remove azure-cli -y && sudo apt autoremove -yuit te voeren. Zie voor meer informatie apt removehet Ubuntu-pakketbeheer of vraag ubuntu.

Azure-CLI installeren

Er zijn twee opties om de Azure CLI op uw systeem te installeren. U kunt een installatiescript downloaden waarmee de installatieopdrachten voor u worden uitgevoerd, of u kunt de installatieopdrachten zelf uitvoeren in een stapsgewijze procedure. Beide methoden worden hier gegeven:

Optie 1: Installeren met één opdracht

De eenvoudigste manier om de Azure CLI te installeren, is via een script dat wordt onderhouden door het Azure CLI-team. Met dit script worden alle installatieopdrachten in één stap uitgevoerd. Dit script wordt rechtstreeks curl gedownload en doorgesluisd om de CLI te bash installeren.

Als u de inhoud van het script zelf wilt inspecteren voordat u het uitvoert, downloadt u het script eerst met behulp curl en inspecteert u het in uw favoriete teksteditor.

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

Optie 2: Stapsgewijze installatie-instructies

Als u liever een stapsgewijs installatieproces uitvoert, voert u de volgende stappen uit om de Azure CLI te installeren.

  1. Haal pakketten op die nodig zijn voor het installatieproces:

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

  2. Download en installeer de Ondertekeningssleutel van Microsoft:

    sudo mkdir -p /etc/apt/keyrings
curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
  sudo gpg --dearmor -o /etc/apt/keyrings/microsoft.gpg
sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
  3. Voeg de Azure CLI-softwareopslagplaats toe: 
    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. Informatie over de opslagplaats bijwerken en het azure-cli pakket installeren:

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

Specifieke versie installeren

Configureer de gegevens van de azure-cli opslagplaats zoals eerder wordt weergegeven. Beschikbare versies vindt u in de releaseopmerkingen van Azure CLI.

  1. Bekijk beschikbare versies van de Azure CLI.

    apt-cache policy azure-cli

  2. Installeer een specifieke versie.

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

    Als u een specifieke versie zonder variabelen wilt installeren, vervangt u de Azure CLI-versie en de Linux-distributienaam die wordt weergegeven:

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

Als u een foutbericht ontvangt dat pakket azure-cli niet kan worden gevonden, is de informatie over de azure-cli opslagplaats niet geconfigureerd. Volg de stappen in optie 2: stapsgewijze installatie-instructies.

Als er een foutbericht wordt weergegeven dat versie x.xx.x-1~distributionName voor azure-cli niet is gevonden, gebruikt lsb_release -cs u om de distributie te vinden die u uitvoert.

Azure CLI bijwerken

Vanaf versie 2.11.0 biedt de Azure CLI een opdracht in het hulpprogramma om bij te werken naar de nieuwste versie.

az upgrade

Met deze opdracht worden ook alle geïnstalleerde extensies standaard bijgewerkt. Zie de referentiepagina voor opdrachten voor meer az upgrade opties. Update voor Azure CLI-versies vóór 2.11.0 door opnieuw te installeren, zoals beschreven in De Azure CLI installeren.

U kunt ook het CLI-pakket bijwerken apt-get upgrade . Met deze opdracht worden alle geïnstalleerde pakketten op uw systeem bijgewerkt waarvoor geen afhankelijkheidswijziging is aangebracht.

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

Als u alleen de CLI wilt upgraden, gebruikt u apt-get install.

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

Azure CLI verwijderen

We zouden het jammer vinden als u besluit om Azure CLI te verwijderen. Voordat u de CLI verwijdert, gebruikt u de az feedback-opdracht om ons te laten weten wat er kan worden verbeterd of opgelost. Ons doel is om Azure CLI zo gebruiksvriendelijk mogelijk te maken en vrij te houden van bugs. Als u een bug vindt, zouden we het waarderen als u dat meldt op GitHub.

  1. Verwijderen met apt-get remove:

    sudo apt-get remove -y azure-cli

  2. Als u de CLI niet opnieuw wilt installeren, verwijdert u de informatie over de Azure CLI-opslagplaats:

    sudo rm /etc/apt/sources.list.d/azure-cli.sources

  3. Als u geen andere pakketten van Microsoft gebruikt, verwijdert u de ondertekeningssleutel:

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

  4. Verwijder overbodige pakketten:

    sudo apt autoremove

Gegevens verwijderen

Als u azure CLI niet opnieuw wilt installeren, verwijdert u de bijbehorende gegevens.

rm -rf ~/.azure

Probleemoplossing

Hieronder volgen enkele veelvoorkomende problemen tijdens het installeren met apt. Als u een probleem ondervindt dat hier niet wordt behandeld, kunt u een probleem indienen op GitHub.

Het azure-cli pakket ondersteunt ARM64-architectuur van CLI-versie 2.46.0.

Geen moduleprobleem op Ubuntu 20.04 (Focal)/WSL

Als u bent geïnstalleerd azure-cliFocal zonder de Azure CLI-softwareopslagplaats toe te voegen in stap 3 van de handmatige installatie-instructies of het gebruik van ons script, kunnen er problemen optreden, zoals geen module met de naam 'decorator' of 'antlr4' omdat het pakket dat u hebt geïnstalleerd, de verouderde azure-cli 2.0.81 is uit de focal/universe opslagplaats. Verwijder deze eerst door uit te voeren sudo apt remove azure-cli -y && sudo apt autoremove -yen volg vervolgens de bovenstaande instructies om het meest recente azure-cli pakket te installeren.

lsb_release retourneert niet de juiste basisdistributieversie

Sommige Ubuntu- of andere Debian-afgeleide distributies (zoals Linux Mint) retourneren mogelijk niet de juiste versienaam van lsb_release. Deze waarde wordt in het installatieproces gebruikt om te bepalen welk pakket moet worden geïnstalleerd. Als u de codenaam weet van de Ubuntu- of Debian-versie waaruit uw distributie is afgeleid, kunt u de AZ_REPO waarde handmatig instellen wanneer u de opslagplaats toevoegt. Zoek anders informatie op voor uw distributie over het bepalen van de naam van de basisdistributiecode en stel deze AZ_REPO in op de juiste waarde.

Geen pakket voor uw distributie

Soms is een bijgewerkt Azure CLI-pakket niet onmiddellijk beschikbaar na een distributieversierelease. De Azure CLI is ontworpen om tolerant te zijn voor toekomstige versies van afhankelijkheden en is afhankelijk van zo weinig mogelijk versies. Als er geen pakket beschikbaar is voor uw basisdistributie, probeert u een pakket voor een eerdere distributie.

Als u een pakket wilt proberen voor een eerdere distributie, stelt u de waarde AZ_REPO handmatig in wanneer u de opslagplaats toevoegt. Gebruik voor Ubuntu-distributies de meest recente jammy opslagplaats:

AZ_REPO="jammy"

Gebruik voor Debian-distributies de meest recente bookworm opslagplaats:

AZ_REPO="bookworm"

Belangrijk

Distributies die zijn uitgebracht voor Ubuntu Bionic en Debian Buster worden niet ondersteund.

De Azure CLI kan niet worden geïnstalleerd met het elementaire besturingssysteem (EOS)

DE AZURE CLI kan niet worden geïnstalleerd omdat lsb_release deze retourneert HERA, wat de naam van de EOS-release is. De oplossing is om het bestand /etc/apt/sources.list.d/azure-cli.sources te herstellen en over te schakelen Suites: hera naar Suites: bionic.

Oorspronkelijke bestandsinhoud:

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

Inhoud van bestand gewijzigd

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

Proxy blokkeert verbinding

Als u geen verbinding kunt maken met een externe resource vanwege een proxy, controleert u of u de HTTP_PROXY variabelen HTTPS_PROXY in uw shell correct hebt ingesteld. Neem contact op met uw systeembeheerder om te weten welke host(s) en poorten voor deze proxy's moeten worden gebruikt.

De waarden in deze variabelen worden door veel Linux-programma's en tijdens het installatieproces gebruikt. Ga als volgt te werk om deze waarden in te stellen:

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

Belangrijk

Als u zich achter een proxy bevindt, moeten deze shellvariabelen worden ingesteld om verbinding te maken met Azure-services met de CLI. Als u geen basisverificatie gebruikt, is het raadzaam om deze variabelen in uw .bashrc bestand te exporteren. Volg altijd het beveiligingsbeleid van uw bedrijf en de vereisten van uw systeembeheerder.

Mogelijk wilt u deze proxy ook expliciet configureren apt . Zorg ervoor dat de volgende regels worden weergegeven in een apt configuratiebestand in /etc/apt/apt.conf.d/. U kunt het beste uw bestaande globale configuratiebestand, een bestaand proxyconfiguratiebestand of een bestaand proxyconfiguratiebestand gebruiken, 40proxiesmaar 99localwel voldoen aan uw systeembeheervereisten.

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

Als uw proxy geen basisverificatie gebruikt, verwijdert u het [username]:[password]@ gedeelte van de proxy-URI. Als u meer informatie nodig hebt voor proxyconfiguratie, raadpleegt u de officiële Ubuntu-documentatie:

Om de Ondertekeningssleutel van Microsoft op te halen en het pakket op te halen uit onze opslagplaats, moet uw proxy HTTPS-verbindingen met het volgende adres toestaan: 'https://packages.microsoft.com.

Cli kan niet worden geïnstalleerd of uitgevoerd op Windows-subsysteem voor Linux

Omdat Windows-subsysteem voor Linux (WSL) een systeemoproepvertalingslaag boven op het Windows-platform is, kan er een fout optreden bij het installeren of uitvoeren van de Azure CLI. De CLI is afhankelijk van sommige functies die mogelijk een bug in WSL hebben. Als er een fout optreedt, ongeacht hoe u de CLI installeert, is er een goede kans dat het een probleem is met WSL en niet met het CLI-installatieproces.

Ga als volgende te werk om uw WSL-installatie op te lossen en mogelijke problemen op te lossen:

Als u problemen ondervindt bij het installeren of uitvoeren op WSL, kunt u overwegen om de CLI voor Windows te installeren.

Azure-CLI installeren

RRPM's worden uitgebracht voor Azure Linux via CBL-Mariner. Het azure-cli pakket ondersteunt ARM64-architectuur van CLI-versie 2.46.0.

Voer de volgende stappen uit om de Azure CLI te installeren:

  1. Installeer de officiële door Microsoft samengestelde set vertrouwde basiscertificaten:

    sudo tdnf install ca-certificates

  2. Azure CLI installeren:

    sudo tdnf install azure-cli

Specifieke versie installeren

Beschikbare versies vindt u in de releaseopmerkingen van Azure CLI.

Beschikbare versies weergeven met de opdracht:

tdnf list azure-cli

Specifieke versie installeren:

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

Azure CLI bijwerken

Werk de Azure CLI bij met de tdnf update opdracht:

sudo tdnf update azure-cli

Azure CLI verwijderen

We zouden het jammer vinden als u besluit om Azure CLI te verwijderen. Voordat u de CLI verwijdert, gebruikt u de az feedback-opdracht om ons te laten weten wat er kan worden verbeterd of opgelost. Ons doel is om Azure CLI zo gebruiksvriendelijk mogelijk te maken en vrij te houden van bugs. Als u een bug vindt, zouden we het waarderen als u dat meldt op GitHub.

Verwijder het pakket uit uw systeem:

sudo tdnf remove azure-cli

Gegevens verwijderen

Als u azure CLI niet opnieuw wilt installeren, verwijdert u de bijbehorende gegevens.

rm -rf ~/.azure

Voordat u begint

We raden u ten zeerste aan de CLI te installeren via pakketbeheer. Met pakketbeheer beschikt u altijd over de nieuwste updates en is de stabiliteit van CLI-onderdelen gegarandeerd. Controleer en kijk of er een pakket voor uw distributie is voordat u handmatig installeert.

Voor de CLI is de volgende software vereist:

Azure CLI installeren of bijwerken

Voor zowel het installeren als bijwerken van de Azure CLI moet het installatiescript opnieuw worden uitgevoerd.

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

Het script kan ook worden gedownload en lokaal worden uitgevoerd. Mogelijk moet u de shell opnieuw starten om de wijzigingen van kracht te laten worden.

Azure CLI verwijderen

We zouden het jammer vinden als u besluit om Azure CLI te verwijderen. Voordat u de CLI verwijdert, gebruikt u de az feedback-opdracht om ons te laten weten wat er kan worden verbeterd of opgelost. Ons doel is om Azure CLI zo gebruiksvriendelijk mogelijk te maken en vrij te houden van bugs. Als u een bug vindt, zouden we het waarderen als u dat meldt op GitHub.

U verwijdert de CLI door de bestanden rechtstreeks te verwijderen van de locatie die tijdens het installeren is gekozen. De standaardinstallatielocatie is de basismap van de gebruiker ($HOME).

  1. Verwijder de geïnstalleerde CLI-bestanden.

    rm -r <install location>/lib/azure-cli
rm <install location>/bin/az

  2. Verwijder de volgende regel uit het bestand $HOME/.bash_profile:

    <install location>/lib/azure-cli/az.completion

  3. Als u bash of zsh gebruikt, moet u de opdrachtcache van de shell opnieuw laden.

    hash -r

Gegevens verwijderen

Als u azure CLI niet opnieuw wilt installeren, verwijdert u de bijbehorende gegevens.

rm -rf ~/.azure

Probleemoplossing

Hieronder volgen enkele veelvoorkomende problemen bij handmatige installatie. Als u een probleem ondervindt dat hier niet wordt behandeld, kunt u een probleem indienen op GitHub.

Installeren zonder Python 3

De Azure CLI heeft de ondersteuning voor Python 2.7 sinds versie 2.1.0 verwijderd. Op uw systeem is er mogelijk een Python-versie die voorafgaat aan de vereiste van Python 3.6.x. Zoek een vervangend python3 pakket.

Fout over verplaatsen van object

Als er een fout wordt geretourneerd van curl met betrekking tot de parameter -L of als in een foutbericht wordt vermeld dat het object is verplaatst, gebruikt u de volledige URL in plaats van de aka.ms-omleiding:

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

Kan de opdracht az niet vinden

Als u de opdracht niet kunt uitvoeren na de installatie met of bashzsh, probeert u de hashcache van de opdracht van uw shell te wissen en te controleren of het probleem is opgelost.

hash -r

Dit probleem kan zich ook voordoen als u de shell na installatie niet opnieuw hebt opgestart. Zorg ervoor dat de locatie van de opdracht az in uw $PATH is. De locatie van de opdracht az is

 <install path>/bin

Proxy blokkeert verbinding

Als u geen verbinding kunt maken met een externe resource vanwege een proxy, controleert u of u de HTTP_PROXY variabelen HTTPS_PROXY in uw shell correct hebt ingesteld. Neem contact op met uw systeembeheerder om te weten welke host(s) en poorten voor deze proxy's moeten worden gebruikt.

De waarden in deze variabelen worden door veel Linux-programma's en tijdens het installatieproces gebruikt. Ga als volgt te werk om deze waarden in te stellen:

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

Belangrijk

Als u zich achter een proxy bevindt, moeten deze shellvariabelen worden ingesteld om verbinding te maken met Azure-services met de CLI. Als u geen basisverificatie gebruikt, is het raadzaam om deze variabelen in uw .bashrc bestand te exporteren. Volg altijd het beveiligingsbeleid van uw bedrijf en de vereisten van uw systeembeheerder.

Als u de installatiescripts wilt ophalen, moet uw proxy HTTPS-verbindingen met de volgende adressen toestaan:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Eindpunten die worden gebruikt door pakketbeheer van uw distributie (indien aanwezig) voor kernpakketten

Cli kan niet worden geïnstalleerd of uitgevoerd op Windows-subsysteem voor Linux

Omdat Windows-subsysteem voor Linux (WSL) een systeemoproepvertalingslaag boven op het Windows-platform is, kan er een fout optreden bij het installeren of uitvoeren van de Azure CLI. De CLI is afhankelijk van sommige functies die mogelijk een bug in WSL hebben. Als er een fout optreedt, ongeacht hoe u de CLI installeert, is er een goede kans dat het een probleem is met WSL en niet met het CLI-installatieproces.

Ga als volgende te werk om uw WSL-installatie op te lossen en mogelijke problemen op te lossen:

Als u problemen ondervindt bij het installeren of uitvoeren op WSL, kunt u overwegen om de CLI voor Windows te installeren.

Volgende stappen

Nu u de Azure CLI hebt geïnstalleerd, kunt u een korte rondleiding volgen om kennis te maken met de functies en veelgebruikte opdrachten.

Aan de slag met de Azure CLI