De Azure CLI installeren in Linux

De Azure CLI is een platformoverschrijdend opdrachtregelprogramma dat lokaal kan worden geïnstalleerd op Linux-computers. U kunt de Azure CLI in Linux gebruiken om verbinding te maken met Azure en beheeropdrachten uit te voeren op Azure-resources. Met de CLI in Linux kunt u verschillende opdrachten uitvoeren via een terminal met behulp van interactieve opdrachtregelprompts of een script. Wanneer u klaar bent om de Azure CLI in Linux te installeren, is het raadzaam om pakketbeheer van een Linux-distributie te gebruiken. Selecteer de juiste pakketbeheerder voor uw distributie in de bovenstaande opties. Als u geen van de vermelde pakketbeheerders hebt, kunt u de Azure CLI handmatig installeren in Linux door de optie Script installeren te selecteren.

De huidige versie van de Azure CLI is 2.39.0. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release. Voer az version uit om uw geïnstalleerde versie te vinden en te zien of u wilt bijwerken.

Overzicht

Pakketbeheer apt bevat een x86_64-pakket voor de Azure CLI die is getest op de volgende distributies.

Distributie	Versie
Ubuntu	18.04 LTS (Bionic Bever), 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish)
Debian	10 (Buster), 11 (Bullseye)

Waarschuwing

U kunt historische versies van Azure CLI blijven gebruiken op oude systemen, maar er zijn geen updates of bugfixes. Overweeg een upgrade uit te voeren naar nieuwere versies van Ubuntu of Debian om de nieuwste Azure CLI te gebruiken.

Waarschuwing

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.

Het azure-cli deb-pakket biedt geen ondersteuning voor ARM64-architectuur.

Opties voor de installatie

Er zijn twee opties om de Azure CLI op uw systeem te installeren. Eerst kunt u één opdracht uitvoeren waarmee een installatiescript wordt gedownload en de installatieopdrachten voor u worden uitgevoerd. Of als u wilt, kunt u de installatieopdrachten zelf uitvoeren in een stapsgewijze procedure. Beide methoden worden hieronder weergegeven.

Optie 1: Installeren met één opdracht

Het Azure CLI-team onderhoudt een script om alle installatieopdrachten in één stap uit te voeren. Dit script wordt rechtstreeks curl gedownload en doorgesluisd om bash de CLI te installeren.

Als u de inhoud van het script zelf wilt inspecteren voordat u het uitvoert, downloadt u het script eerst met behulp en curl 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 wilt uitvoeren, voert u de volgende stappen uit om de Azure CLI te installeren.

1. Pakketten ophalen die nodig zijn voor het installatieproces:

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

2. Download en installeer de Ondertekeningssleutel van Microsoft:

   curl -sL https://packages.microsoft.com/keys/microsoft.asc |
       gpg --dearmor |
       sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
   

3. Voeg de Azure CLI-softwareopslagplaats toe:

   AZ_REPO=$(lsb_release -cs)
   echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" |
       sudo tee /etc/apt/sources.list.d/azure-cli.list
   

4. Werk de gegevens van de opslagplaats bij en installeer het azure-cli pakket:

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

Specifieke versie installeren

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

1. Beschikbare versies weergeven met opdracht:

   apt-cache policy azure-cli
   

2. Specifieke versie installeren:

   sudo apt-get install azure-cli=<version>-1~bullseye
   

Problemen oplossen

Hieronder volgen enkele veelvoorkomende problemen tijdens het installeren met apt. Als u een probleem ondervindt dat hier niet wordt beschreven, meldt u dat op github.

Geen moduleprobleem op Ubuntu 20.04 (Focal)/WSL

Als u de Azure CLI-softwareopslagplaats in stap 3 van de handmatige installatie-instructies of het gebruik van ons script hebt geïnstalleerd azure-cliFocal zonder de Azure CLI-softwareopslagplaats toe te voegen, kunt u problemen ondervinden, zoals de module 'decorator' of 'antlr4' omdat het pakket dat u hebt geïnstalleerd, verouderd 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

Bij bepaalde van Ubuntu of Debian afgeleide distributies, zoals Linux Mint, wordt niet de juiste versienaam van lsb_release geretourneerd. Deze waarde wordt in het installatieproces gebruikt om te bepalen welk pakket moet worden geïnstalleerd. Als u de codenaam van de Ubuntu- of Debian-versie weet waarvan uw distributie is afgeleid, kunt u de AZ_REPO waarde handmatig instellen bij het toevoegen van de opslagplaats. Zoek anders informatie op voor uw distributie over het bepalen van de naam van de basisdistributiecode en stel deze in AZ_REPO op de juiste waarde.

Geen pakket voor uw distributie

Soms kan het enige tijd duren nadat een distributie is uitgebracht voordat er een Azure CLI-pakket beschikbaar is. De Azure CLI die is ontworpen om flexibel te zijn met betrekking tot toekomstige versies van afhankelijkheden en er zo weinig mogelijk afhankelijk van te zijn. Als er geen pakket beschikbaar is voor uw basisdistributie, probeert u een pakket voor een eerdere distributie.

U doet dit door de waarde AZ_REPO handmatig in te stellen bij het toevoegen van de opslagplaats. Gebruik voor Ubuntu-distributies de meest recente jammy opslagplaats:

AZ_REPO="jammy"

Gebruik voor Debian-distributies de meest recente bullseye opslagplaats:

AZ_REPO="bullseye"

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 wordt geretourneerd HERA. Dit is de naam van de RELEASE van DE EOS. De oplossing is om het bestand /etc/apt/sources.list.d/azure-cli.list op te lossen en over te schakelen naar hera mainbionic main.

Oorspronkelijke bestandsinhoud:

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ hera main

Bestandsinhoud gewijzigd

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ bionic main

Proxy blokkeert verbinding

Als u geen verbinding kunt maken met een externe resource vanwege een proxy, moet u ervoor zorgen dat u de HTTP_PROXY en HTTPS_PROXY variabelen in de shell juist hebt ingesteld. Neem contact op met uw systeembeheerder om te weten welke host(s) en poort(en) u voor deze proxy's wilt gebruiken.

Deze waarden worden gerespecteerd door veel Linux-programma's, inclusief programma's die worden gebruikt in het installatieproces. 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 shell-variabelen worden ingesteld om verbinding te maken met Azure-services met de CLI. Als u geen basisverificatie gebruikt, is het raadzaam 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 apt dat deze proxy altijd wordt gebruikt. 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 99localuw systeembeheervereisten volgen.

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:

• apt.conf manpage
• Ubuntu-wiki - apt-get-howto

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

Aangezien 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 fout hebben in WSL. 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.

Problemen met uw WSL-installatie oplossen en mogelijk oplossen:

• Als u dat kunt, voert u een identiek installatieproces uit op een Linux-machine of VM om te zien of dit lukt. Als dit het geval is, is uw probleem bijna zeker gerelateerd aan WSL. Als u een Virtuele Linux-machine in Azure wilt starten, raadpleegt u de documentatie voor het maken van een Virtuele Linux-machine in Azure Portal .
• Zorg ervoor dat u de nieuwste versie van WSL uitvoert. Werk uw Windows 10-installatie bij om de nieuwste versie te downloaden.
• Controleer op openstaande problemen met WSL die uw probleem kunnen verhelpen. Er zijn vaak suggesties voor het omzeilen van het probleem of informatie over een release waar het probleem wordt opgelost.
• Als er geen bestaande problemen zijn voor uw probleem, moet u een nieuw probleem indienen met WSL en ervoor zorgen dat u zoveel mogelijk informatie opneemt.

Als u problemen ondervindt met het installeren of uitvoeren op WSL, kunt u de CLI voor Windows installeren.

Bijwerken

De CLI biedt een opdracht in het hulpprogramma om bij te werken naar de nieuwste versie:

az upgrade

Notitie

De az upgrade opdracht is toegevoegd in versie 2.11.0 en werkt niet met versies vóór 2.11.0. Oudere versies kunnen worden bijgewerkt door opnieuw te installeren zoals beschreven in De Azure CLI installeren.

Met deze opdracht worden ook standaard alle geïnstalleerde extensies bijgewerkt. Raadpleeg de referentiepagina van de opdracht voor meer az upgrade opties.

U kunt ook het CLI-pakket bijwerken apt-get upgrade .

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

Notitie

Deze opdracht voert een upgrade uit voor alle geïnstalleerde pakketten in uw systeem waarvan de afhankelijkheid nog niet is gewijzigd. 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

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 gegevens van de Azure CLI-opslagplaats:

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

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

   sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg
   

4. Verwijder overbodige pakketten:

   sudo apt autoremove
   

Overzicht

Voor Linux-distributies met dnf bijvoorbeeld RHEL 8 of CentOS Stream 8 zijn er RPM-pakketten voor Azure CLI.

Waarschuwing

Vanaf Azure CLI 2.39.0 (uitgebracht op 08-02-2022) worden er geen RPM-pakketten uitgebracht voor RHEL 7 en CentOS 7. U kunt historische versies van Azure CLI op deze systemen blijven gebruiken, maar er zijn geen updates of bugfixes. Overweeg een upgrade uit te voeren naar nieuwere versies van RHEL of CentOS om de nieuwste Azure CLI te gebruiken.

De huidige versie van de Azure CLI is 2.39.0. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release. Voer az version uit om uw geïnstalleerde versie te vinden en te zien of u wilt bijwerken.

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 het einde van de levensduur heeft bereikt op 1 januari 2020 en geen updates meer ontvangt. Azure CLI heeft de ondersteuning voor Python 2.7 sinds versie 2.1.0verwijderd. Nieuwe versies garanderen niet langer dat deze correct worden uitgevoerd met Python 2.7.

Notitie

Gebruik yum Pakketbeheer als u Linux-systemen gebruikt die pakketbeheer niet ondersteunen dnf .

Installeren

1. Importeer de sleutel voor de Microsoft-opslagplaats.

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

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

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

   Voor RHEL 7 of CentOS 7 voegt u een 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 hierboven wordt weergegeven. Beschikbare versies vindt u in de releaseopmerkingen van Azure CLI.

1. Beschikbare versies weergeven met opdracht:

   dnf list --showduplicates azure-cli
   

2. Specifieke versie installeren:

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

Problemen oplossen

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, moet u uw systeem upgraden naar een versie met officiële ondersteuning voor python 3.6+ pakket. Anders moet u eerst een python3 pakket installeren en vervolgens Azure CLI installeren zonder afhankelijkheid.

U kunt de volgende opdracht gebruiken om Azure CLI te installeren met python 3.6 behulp van de 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 vanuit de bron voordat python3u :

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 azure CLI-opslagplaats toe te voegen. U kunt het pakket nu downloaden en installeren zonder afhankelijkheid.

Notitie

Als u de dnf-downloadinvoegtoepassing niet hebt geïnstalleerd, treedt er een opdracht op die niet is gevonden bij het uitvoeren van de onderstaande code. Gebruik dnf install 'dnf-command(download)' deze optie 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 via een extra opslagplaats. Als u deze manier hebt ingesteld python3 , maar nog steeds een foutmelding python3: command not found krijgt bij het uitvoeren van de cli, moet u deze toevoegen aan uw pad.

scl enable rh-python36 bash

Proxy blokkeert verbinding

Als u geen verbinding kunt maken met een externe resource vanwege een proxy, moet u ervoor zorgen dat u de HTTP_PROXY en HTTPS_PROXY variabelen in de shell juist hebt ingesteld. Neem contact op met uw systeembeheerder om te weten welke host(s) en poort(en) u voor deze proxy's wilt gebruiken.

Deze waarden worden gerespecteerd door veel Linux-programma's, inclusief programma's die worden gebruikt in het installatieproces. 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 shell-variabelen worden ingesteld om verbinding te maken met Azure-services met de CLI. Als u geen basisverificatie gebruikt, is het raadzaam 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 dnf dat deze proxy altijd wordt gebruikt. 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

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

Aangezien 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 fout hebben in WSL. 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.

Problemen met uw WSL-installatie oplossen en mogelijk oplossen:

• Als u dat kunt, voert u een identiek installatieproces uit op een Linux-machine of VM om te zien of dit lukt. Als dit het geval is, is uw probleem bijna zeker gerelateerd aan WSL. Als u een Virtuele Linux-machine in Azure wilt starten, raadpleegt u de documentatie voor het maken van een Virtuele Linux-machine in Azure Portal .
• Zorg ervoor dat u de nieuwste versie van WSL uitvoert. Werk uw Windows 10-installatie bij om de nieuwste versie te downloaden.
• Controleer op openstaande problemen met WSL die uw probleem kunnen verhelpen. Er zijn vaak suggesties voor het omzeilen van het probleem of informatie over een release waar het probleem wordt opgelost.
• Als er geen bestaande problemen zijn voor uw probleem, moet u een nieuw probleem indienen met WSL en ervoor zorgen dat u zoveel mogelijk informatie opneemt.

Als u problemen ondervindt met het installeren of uitvoeren op WSL, kunt u de CLI voor Windows installeren.

Bijwerken

De CLI biedt een opdracht in het hulpprogramma om bij te werken naar de nieuwste versie:

az upgrade

Notitie

De az upgrade opdracht is toegevoegd in versie 2.11.0 en werkt niet met versies vóór 2.11.0. Oudere versies kunnen worden bijgewerkt door opnieuw te installeren zoals beschreven in De Azure CLI installeren.

Met deze opdracht worden ook alle geïnstalleerde extensies standaard bijgewerkt. Raadpleeg de referentiepagina van de opdracht voor meer az upgrade opties.

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

sudo dnf update 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
   

Overzicht

RRPM's worden uitgebracht voor CBL-Mariner 1.0 en 2.0.

Installeren

Installeren met de tdnf install opdracht:

sudo tdnf install azure-cli

Specifieke versie installeren

Beschikbare versies vindt u in de releaseopmerkingen van Azure CLI.

Beschikbare versies weergeven met opdracht:

tdnf list azure-cli

Specifieke versie installeren:

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

Bijwerken

Werk de Azure CLI bij met de tdnf update opdracht:

sudo tdnf update 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

Overzicht

Voor Linux-distributies met zypper, zoals openSUSE of SLES, is er een pakket beschikbaar voor Azure CLI. Dit pakket is getest met openSUSE Leap 15.1 en SLES 15.

De huidige versie van de Azure CLI is 2.39.0. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release. Voer az version uit om uw geïnstalleerde versie te vinden en te zien of u deze moet bijwerken.

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 het einde van de levensduur op 1 januari 2020 heeft bereikt en geen updates meer ontvangt. Azure CLI heeft de ondersteuning voor Python 2.7 sinds versie 2.1.0verwijderd. Nieuwe versies garanderen niet langer dat deze correct worden uitgevoerd met Python 2.7.

Installeren

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 hierboven wordt weergegeven. Beschikbare versies vindt u in de releaseopmerkingen van Azure CLI.

1. Beschikbare versies weergeven met opdracht:

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

2. Specifieke versie installeren:

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

Problemen oplossen

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

NotImplementedError op OpenSUSE 15 VM

De OpenSUSE 15-VM heeft een vooraf geïnstalleerde Azure CLI met versie 2.0.45, deze is verouderd en heeft problemen met az login. Verwijder deze 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 Azure CLI hebt bijgewerkt zonder de afhankelijkheden van de versie 2.0.45te verwijderen, kunnen de oude afhankelijkheden van invloed zijn op de nieuwste versie van Azure CLI. U moet de oude versie terug toevoegen om een koppeling te maken naar de afhankelijkheden en vervolgens samen met de bijbehorende afhankelijkheden 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 wordt het standaardpakket python3 niet 3.4 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. Het script wordt geïnstalleerd Python 3.8 onder /usr/local/azcli en gebruikt Azure CLI door een alias in te PATH=/usr/local/azcli/bin:$PATH azstellen op az . U kunt het script ook downloaden en aanpassen aan 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, moet u ervoor zorgen dat u de HTTP_PROXY en HTTPS_PROXY variabelen in uw shell correct hebt ingesteld. Neem contact op met uw systeembeheerder om te weten welke host(s) en poort(en) voor deze proxy's moeten worden gebruikt.

Deze waarden worden gerespecteerd door veel Linux-programma's, inclusief die welke worden gebruikt in het installatieproces. 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 te allen tijde 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 vensterbeheer op uw systeem beschikbaar hebt, kunt u ook het Network Services > Proxy deelvenster in de YaST Control Center.

Raadpleeg de documentatie over 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 systeemaanroepomzettingslaag 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 fout hebben in WSL. 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.

Om uw WSL-installatie op te lossen en mogelijk problemen op te lossen:

• Als u dat kunt, voert u een identiek installatieproces uit op een Linux-machine of VM om te zien of dit lukt. Als dit het geval is, is uw probleem bijna zeker gerelateerd aan WSL. Als u een Virtuele Linux-machine in Azure wilt starten, raadpleegt u de documentatie over het maken van een Virtuele Linux-machine in de Azure-portal .
• Zorg ervoor dat u de nieuwste versie van WSL uitvoert. Werk de Windows 10-installatie bij om de nieuwste versie te downloaden.
• Controleer op openstaande problemen met WSL die uw probleem kunnen verhelpen. Vaak zijn er suggesties voor het oplossen van het probleem, of informatie over een release waarin het probleem wordt opgelost.
• Als er geen bestaande problemen zijn voor uw probleem, meldt u een nieuw probleem aan met WSL en zorgt u ervoor dat u zoveel mogelijk informatie opneemt.

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

Ssl-certificaatprobleem

Wanneer een certificaat is verbroken of verouderd op een computer, ontvangt 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

Bijwerken

De CLI biedt een opdracht in het hulpprogramma om bij te werken naar de nieuwste versie:

az upgrade

Notitie

De az upgrade opdracht is toegevoegd in versie 2.11.0 en werkt niet met versies vóór 2.11.0. Oudere versies kunnen worden bijgewerkt door opnieuw te installeren zoals beschreven in De Azure CLI installeren.

Met deze opdracht worden ook alle geïnstalleerde extensies standaard bijgewerkt. Raadpleeg de referentiepagina van de opdracht voor meer az upgrade opties.

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

sudo zypper refresh
sudo zypper update 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
   

Overzicht

Notitie

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 of er een pakket beschikbaar is voor uw distributie voordat u de CLI handmatig installeert.

Voor de CLI is de volgende software vereist:

• Python 3.6.x, 3.7.x of 3.8.x.
• libffi
• OpenSSL 1.0.2

Belangrijk

De CLI heeft de ondersteuning voor Python 2.7 sinds versie 2.1.0verwijderd. Nieuwe versies garanderen niet langer dat deze correct worden uitgevoerd met Python 2.7.

Installeren of bijwerken

Voor zowel het installeren als het bijwerken van de CLI moet het installatiescript opnieuw worden uitgevoerd. Installeer de CLI met behulp van curl.

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 door te voeren.

Problemen oplossen

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

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 na de installatie de opdracht niet kunt uitvoeren en bash of zsh gebruikt, moet u de hash-cache van opdrachten van de shell wissen. Uitvoeren

hash -r

uit en controleer of het probleem is opgelost.

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, moet u ervoor zorgen dat u de HTTP_PROXY en HTTPS_PROXY variabelen in uw shell correct hebt ingesteld. Neem contact op met uw systeembeheerder om te weten welke host(s) en poort(en) voor deze proxy's moeten worden gebruikt.

Deze waarden worden gerespecteerd door veel Linux-programma's, inclusief die welke worden gebruikt in het installatieproces. 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 systeemaanroepomzettingslaag 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 fout hebben in WSL. 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.

Om uw WSL-installatie op te lossen en mogelijk problemen op te lossen:

• Als u dat kunt, voert u een identiek installatieproces uit op een Linux-machine of VM om te zien of dit lukt. Als dit het geval is, is uw probleem bijna zeker gerelateerd aan WSL. Als u een Virtuele Linux-machine in Azure wilt starten, raadpleegt u de documentatie over het maken van een Virtuele Linux-machine in de Azure-portal .
• Zorg ervoor dat u de nieuwste versie van WSL uitvoert. Werk de Windows 10-installatie bij om de nieuwste versie te downloaden.
• Controleer op openstaande problemen met WSL die uw probleem kunnen verhelpen. Vaak zijn er suggesties voor het oplossen van het probleem, of informatie over een release waarin het probleem wordt opgelost.
• Als er geen bestaande problemen zijn voor uw probleem, meldt u een nieuw probleem aan met WSL en zorgt u ervoor dat u zoveel mogelijk informatie opneemt.

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

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 standaardlocatie voor de installatie is $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

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