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.67.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.2 (uitgebracht op 21 juni 2024) is de laatste versie die wordt ondersteund op RHEL 7 en Centos 7. Microsoft biedt geen updates of bugfixes meer 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:
Importeer de sleutel voor de Microsoft-opslagplaats.
CentOS 7 End Of Life (EOL) was 30 juni 2024. Zie de ondersteuningslevenscyclus van Azure CLI voor informatie over door Azure CLI ondersteunde omgevingen
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.
Beschikbare versies weergeven met de opdracht:
dnf list --showduplicates azure-cli
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.
Verwijder het pakket van uw systeem.
sudo dnf remove azure-cli
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
Als u geen andere Microsoft-pakketten gebruikt, verwijdert u de ondertekeningssleutel.
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:
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.
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:
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 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, heeft uw probleem waarschijnlijk betrekking op 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 waarmee uw probleem kan worden opgelost.
Er zijn vaak suggesties voor het omzeilen van het probleem of informatie over een release waar het probleem is opgelost.
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.2 (uitgebracht op 21 juni 2024) is de nieuwste versie die wordt ondersteund op SUSE Linux Enterprise Server (SLES) en OpenSUSE (Leap). Microsoft biedt geen updates of bugfixes meer 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:
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)
curl installeren:
sudo zypper install -y curl
Importeer de sleutel voor de Microsoft-opslagplaats:
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.
Bekijk de beschikbare versies met behulp van deze opdracht:
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.
Verwijder het pakket van uw systeem.
sudo zypper remove -y azure-cli
Als u niet van plan bent om de CLI opnieuw te installeren, verwijdert u de gegevens in de opslagplaats.
sudo zypper removerepo azure-cli
Als u geen andere Microsoft-pakketten gebruikt, verwijdert u de Ondertekeningssleutel van Microsoft.
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.
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:
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.
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 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, heeft uw probleem waarschijnlijk betrekking op 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 waarmee uw probleem kan worden opgelost.
Er zijn vaak suggesties voor het omzeilen van het probleem of informatie over een release waar het probleem is opgelost.
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.
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.
Configureer de gegevens van de azure-cli opslagplaats zoals eerder wordt weergegeven. Beschikbare versies vindt u in de releaseopmerkingen van Azure CLI.
Bekijk beschikbare versies van de Azure CLI.
apt-cache policy azure-cli
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.
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.
Verwijderen met apt-get remove:
sudo apt-get remove -y azure-cli
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
Als u geen andere pakketten van Microsoft gebruikt, verwijdert u de ondertekeningssleutel:
sudo rm /etc/apt/keyrings/microsoft.gpg
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:
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.
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 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, heeft uw probleem waarschijnlijk betrekking op 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 waarmee uw probleem kan worden opgelost.
Er zijn vaak suggesties voor het omzeilen van het probleem of informatie over een release waar het probleem is opgelost.
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 het installatiescript voor de Azure CLI is de volgende software vereist:
Het installatiescript werkt alleen op Python 3.8.x, 3.9.x of 3.10.x. Dit installatiescript werkt niet in Python 3.11.x of nieuwere versies.
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).
Verwijder de volgende regel uit het bestand $HOME/.bash_profile:
<install location>/lib/azure-cli/az.completion
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:
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 az opdracht 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:
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 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, heeft uw probleem waarschijnlijk betrekking op 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 waarmee uw probleem kan worden opgelost.
Er zijn vaak suggesties voor het omzeilen van het probleem of informatie over een release waar het probleem is opgelost.
De bron voor deze inhoud vindt u op GitHub, waar u ook problemen en pull-aanvragen kunt maken en controleren. Bekijk onze gids voor inzenders voor meer informatie.
Azure CLI-feedback
Azure CLI is een open source project. Selecteer een koppeling om feedback te geven:
Implementeer en pas een SUSE Linux Enterprise Server (SLES) op virtuele Azure-machines (VM) toe met behulp van YaST-beheerprogramma's en zypper-pakketbeheerprogramma's om RPM-pakketten toe te voegen. Meer informatie over hoe SUSE-groepen pakketten en pakketafhankelijkheden afstemmen om ervoor te zorgen dat u de nieuwste updates en versies uitvoert. Oefen met behulp van YaST en zypper om een LAMP-stack te installeren op een Azure-VM van SLES.