De Azure CLI installeren in Linux

Overzicht

Het apt pakketbeheer bevat een x86_64-pakket voor de Azure CLI dat is getest op de volgende distributies.

Opties voor de installatie

Er zijn twee opties om de Azure CLI op uw systeem te installeren. U kunt eerst één opdracht uitvoeren om een installatiescript te downloaden en de installatieopdrachten voor u uit te voeren. Als u dat liever doet, kunt u de installatieopdrachten ook zelf uitvoeren in een stapsgewijs proces. Beide methoden vindt u hieronder.

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 gedownload via curl en rechtstreeks doorspijpt naar bash om de CLI te installeren.

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

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

Optie 2: Stapsgewijs installatie-instructies

Als u de voorkeur geeft aan een stapsgewijs installatieproces, moet u de volgende stappen uitvoeren om de Azure CLI te installeren.

1. Haal de benodigde pakketten op 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 de gegevens azure-cli van de opslagplaats configureren zoals hierboven wordt weergegeven. Beschikbare versies vindt u in de opmerkingen bij de Release van Azure CLI.

1. Beschikbare versies weergeven met de 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 in Ubuntu 20.04 (Focus)/WSL

Als u hebt geïnstalleerd op zonder de Azure CLI-softwareopslagplaats toe te voegen in stap 3 van de handmatige installatie-instructies of met behulp van ons script, kunnen er problemen zijn, zoals geen module met de naam azure-cli Focal 'installator' of 'antlr4' omdat het pakket dat u hebt geïnstalleerd, verouderd is in de azure-cli 2.0.81 focal/universe opslagplaats. Verwijder deze eerst door uit te voer sudo apt remove azure-cli -y && sudo apt autoremove -y en volg de bovenstaande instructies om het meest recente pakket te azure-cli 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 weet van welke codenaam de Ubuntu- of Debian-versie uw distributie is afgeleid, kunt u de waarde handmatig instellen wanneer u de AZ_REPO opslagplaats toevoegt. Zoek anders informatie 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 even duren voordat er een Azure CLI-pakket beschikbaar is nadat een distributie is vrijgegeven. De Azure CLI is ontworpen om flexibel te zijn met betrekking tot toekomstige versies van afhankelijkheden en is afhankelijk van zo weinig mogelijk afhankelijkheden. Als er geen pakket beschikbaar is voor uw basisdistributie, probeert u een pakket voor een eerdere distributie.

Hiervoor stelt u de waarde van handmatig AZ_REPO in wanneer u de opslagplaats toevoegt. Gebruik voor Ubuntu-distributies bionic de opslagplaats en voor Debian-distributies. stretch Distributies die zijn uitgebracht vóór Ubuntu Trusty en Debian Wheezy worden niet ondersteund.

Elementaire besturingssysteem (EOS) kan de Azure CLI niet installeren

EOS kan de Azure Cli niet installeren omdat lsb_release retourneert . Dit is de naam van HERA de EOS-release. De oplossing is om het bestand te herstellen /etc/apt/sources.list.d/azure-cli.list en te wijzigen in hera main bionic main .

Oorspronkelijke bestandsinhoud:

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

Gewijzigde bestandsinhoud

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 variabelen en HTTP_PROXY correct hebt ingesteld in uw HTTPS_PROXY shell. Neem contact op met uw systeembeheerder om te weten welke host(s) en poort(en) u wilt gebruiken voor deze proxies.

Deze waarden worden in acht genomen door veel Linux-programma's, met inbegrip van de waarden die worden gebruikt in het installatieproces. Deze waarden instellen:

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

Mogelijk wilt u ook expliciet configureren om apt deze proxy te allen tijde te gebruiken. Zorg ervoor dat de volgende regels worden weergegeven in een apt configuratiebestand in /etc/apt/apt.conf.d/ . We raden u aan uw bestaande globale configuratiebestand, een bestaand proxyconfiguratiebestand, of , te gebruiken, maar u moet voldoen 40proxies 99local aan uw systeembeheervereisten.

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

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

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

Als u de ondertekeningssleutel van Microsoft wilt ontvangen en het pakket wilt ontvangen 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 vertaallaag voor systeemoproepen boven op het Windows-platform is, kan er een foutbericht worden weergegeven bij het installeren of uitvoeren van de Azure CLI. De CLI is afhankelijk van een aantal functies die mogelijk een fout in WSL hebben. Als er een fout is opgetreden, 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 de WSL-installatie oplossen:

• Voer, indien mogelijk, een identiek installatieproces uit op een Linux-computer of virtuele machine om te zien of dit lukt. Als dit het geval is, is uw probleem bijna zeker gerelateerd aan WSL. Als u een virtuele Linux-VM in Azure wilt starten, bekijkt u de documentatie over het maken van een linux-VM in de Azure-portal.
• Zorg ervoor dat u de nieuwste versie van WSL hebt. Als u de nieuwste versie wilt downloaden, moet u de Windows 10 bijwerken.
• Controleer op openstaande problemen met WSL die uw probleem kunnen oplossen. 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, kunt u een nieuw probleem indienen bij WSL en ervoor zorgen dat u zoveel mogelijk informatie opvraagt.

Als u nog steeds problemen hebt met het installeren of uitvoeren op WSL, kunt u overwegen om de CLI teinstalleren voor Windows .

Bijwerken

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

az upgrade

U kunt ook gebruiken om apt-get upgrade het CLI-pakket bij te werken.

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

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 niet van plan bent om de CLI opnieuw te 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 alle onnodige pakketten:

   sudo apt autoremove
   

Overzicht

Voor Linux-distributies dnf met zoals RHEL, Fedora of CentOS is er een pakket voor de Azure CLI. Dit pakket is getest met RHEL 7.7, RHEL 8, Fedora 24 en hoger, CentOS 7 en CentOS 8.

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

Installeren

1. Importeer de sleutel voor de Microsoft-opslagplaats.

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

2. Maak de vereiste gegevens voor de lokale azure-cli-opslagplaats.

   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 de gegevens azure-cli van de opslagplaats configureren zoals hierboven wordt weergegeven. Beschikbare versies vindt u in de opmerkingen bij de Release van Azure CLI.

1. Beschikbare versies weergeven met de 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 ervaart dat hier niet wordt behandeld, kunt u een probleem indienen op GitHub.

Installeren op RHEL 7.6 of andere systemen zonder Python 3

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

U kunt de volgende opdracht gebruiken om Azure CLI te installeren met python 3.6 gebouwd op basis van de bron:

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

U kunt dit ook stap voor stap doen:

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

$ 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 tot slot stap 1 en 2 van de installatie-instructie om de Azure CLI-opslagplaats toe te voegen. U kunt nu het pakket downloaden en installeren zonder afhankelijkheid.

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

Als alternatief kunt u python 3 ook installeren via een extra repo. Als u op deze manier een foutmelding hebt ingesteld maar nog steeds een foutmelding krijgt bij het uitvoeren van de CLI, moet u deze python3 python3: command not found 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 variabelen en HTTP_PROXY correct hebt ingesteld in uw HTTPS_PROXY shell. Neem contact op met uw systeembeheerder om te weten welke host(s) en poort(en) u wilt gebruiken voor deze proxies.

Deze waarden worden in acht genomen door veel Linux-programma's, met inbegrip van de waarden die worden gebruikt in het installatieproces. Deze waarden instellen:

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

Mogelijk wilt u ook expliciet configureren om dnf deze proxy te allen tijde te gebruiken. 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 wilt ontvangen en het pakket wilt ontvangen 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 vertaallaag voor systeemoproepen boven op het Windows-platform is, kan er een foutbericht worden weergegeven bij het installeren of uitvoeren van de Azure CLI. De CLI is afhankelijk van een aantal functies die mogelijk een fout in WSL hebben. Als er een fout is opgetreden, 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 de WSL-installatie oplossen:

• Voer, indien mogelijk, een identiek installatieproces uit op een Linux-computer of virtuele machine om te zien of dit lukt. Als dit het geval is, is uw probleem bijna zeker gerelateerd aan WSL. Als u een virtuele Linux-VM in Azure wilt starten, bekijkt u de documentatie over het maken van een linux-VM in de Azure-portal.
• Zorg ervoor dat u de nieuwste versie van WSL hebt. Als u de nieuwste versie wilt downloaden, moet u de Windows 10 bijwerken.
• Controleer op openstaande problemen met WSL die uw probleem kunnen oplossen. 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, kunt u een nieuw probleem indienen bij WSL en ervoor zorgen dat u zoveel mogelijk informatie opvraagt.

Als u nog steeds problemen hebt met het installeren of uitvoeren op WSL, kunt u overwegen om de CLI teinstalleren voor Windows .

Bijwerken

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

az upgrade

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

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.30.0. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release. Voer az version uit om de geïnstalleerde versie te vinden en te zien of u moet bijwerken.

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 de installatie door enkele van de afhankelijkheden te negeren.

Specifieke versie installeren

U moet eerst de gegevens azure-cli van de opslagplaats configureren zoals hierboven wordt weergegeven. Beschikbare versies vindt u in de opmerkingen bij de Release van Azure CLI.

1. Beschikbare versies weergeven met de opdracht :

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

2. Een 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 ervaart dat hier niet wordt behandeld, kunt u een probleem indienen op GitHub.

NotImplementedError op OpenSUSE 15 VM

De OpenSUSE 15-VM heeft een vooraf geïnstalleerde Azure CLI met versie , deze 2.0.45 is verouderd en heeft problemen met az login . Verwijder deze samen met de 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 versie te verwijderen, kunnen de oude afhankelijkheden van invloed 2.0.45 zijn op de nieuwste versie van Azure CLI. U moet de oude versie terug toevoegen om deze te koppelen aan de afhankelijkheden en vervolgens samen azure-cli met de afhankelijkheden verwijderen:

# 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

In SLES 12 wordt het python3 standaardpakket niet 3.4 ondersteund door Azure CLI. U kunt eerst stap 1 tot en met 3 van de installatie-instructie volgen om de opslagplaats toe te azure-cli 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 en laat Azure CLI het gebruiken door een alias van in te stellen op /usr/local/azcli az PATH=/usr/local/azcli/bin:$PATH az . U kunt het script ook downloaden en aanpassen 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

Vergeet niet om voor de eerste keer installeren de volgende opdracht uit te voeren 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 variabelen en HTTP_PROXY correct hebt ingesteld in uw HTTPS_PROXY shell. Neem contact op met uw systeembeheerder om te weten welke host(s) en poort(en) u wilt gebruiken voor deze proxies.

Deze waarden worden in acht genomen door veel Linux-programma's, met inbegrip van de waarden die worden gebruikt in het installatieproces. Deze waarden instellen:

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

Mogelijk wilt u ook expliciet configureren zypper (via yast2 ) om deze proxy te allen tijde te gebruiken. Voer om dit te doen de yast2 proxy opdracht uit als superuser en vul de informatie in die wordt weergegeven in het formulier. Als er een vensterbeheer beschikbaar is op uw systeem, kunt u ook het Network Services > Proxy deelvenster in de YaST Control Center gebruiken.

Zie de documentatie over de OpenSUSE-proxyconfiguratie voor geavanceerde configuratie of meer informatie

Als u de ondertekeningssleutel van Microsoft wilt ontvangen en het pakket uit onze opslagplaats wilt ontvangen, 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 vertaallaag voor systeemoproepen boven op het Windows-platform is, kan er een foutbericht worden weergegeven bij het installeren of uitvoeren van de Azure CLI. De CLI is afhankelijk van een aantal functies die mogelijk een fout in WSL hebben. Als er een fout is opgetreden, 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 de WSL-installatie oplossen:

• Voer, indien mogelijk, een identiek installatieproces uit op een Linux-computer of virtuele machine om te zien of dit lukt. Als dit het geval is, is uw probleem bijna zeker gerelateerd aan WSL. Als u een virtuele Linux-VM in Azure wilt starten, bekijkt u de documentatie over het maken van een linux-VM in de Azure-portal.
• Zorg ervoor dat u de nieuwste versie van WSL hebt. Als u de nieuwste versie wilt downloaden, moet u de Windows 10 bijwerken.
• Controleer op openstaande problemen met WSL die uw probleem kunnen oplossen. 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, kunt u een nieuw probleem indienen bij WSL en ervoor zorgen dat u zoveel mogelijk informatie opvraagt.

Als u nog steeds problemen hebt met het installeren of uitvoeren op WSL, kunt u overwegen om de CLI teinstalleren voor Windows .

Probleem met SSL-certificaat

Wanneer een certificaat op een computer defect of verouderd is, kan er een foutbericht worden weergegeven dat curl de juistheid van de server niet kan verifiëren en daarom geen beveiligde verbinding kan maken. 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

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

Voor de CLI is de volgende software vereist:

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

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 ervaart dat hier niet wordt behandeld, kunt u een probleem indienen 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 variabelen en HTTP_PROXY correct hebt ingesteld in uw HTTPS_PROXY shell. Neem contact op met uw systeembeheerder om te weten welke host(s) en poort(en) u wilt gebruiken voor deze proxies.

Deze waarden worden in acht genomen door veel Linux-programma's, met inbegrip van de waarden die worden gebruikt in het installatieproces. Deze waarden instellen:

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

Om de installatiescripts op te halen, 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 het pakketbeheer van uw distributie (indien van de hand) voor kernpakketten

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

Omdat Windows-subsysteem voor Linux (WSL) een vertaallaag voor systeemoproepen boven op het Windows-platform is, kan er een foutbericht worden weergegeven bij het installeren of uitvoeren van de Azure CLI. De CLI is afhankelijk van een aantal functies die mogelijk een fout in WSL hebben. Als er een fout is opgetreden, 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 de WSL-installatie oplossen:

• Voer, indien mogelijk, een identiek installatieproces uit op een Linux-computer of virtuele machine om te zien of dit lukt. Als dit het geval is, is uw probleem bijna zeker gerelateerd aan WSL. Als u een virtuele Linux-VM in Azure wilt starten, bekijkt u de documentatie over het maken van een linux-VM in de Azure-portal.
• Zorg ervoor dat u de nieuwste versie van WSL hebt. Als u de nieuwste versie wilt downloaden, moet u de Windows 10 bijwerken.
• Controleer op openstaande problemen met WSL die uw probleem kunnen oplossen. 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, kunt u een nieuw probleem indienen bij WSL en ervoor zorgen dat u zoveel mogelijk informatie opvraagt.

Als u nog steeds problemen hebt met het installeren of uitvoeren op WSL, kunt u overwegen om de CLI teinstalleren voor Windows .

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