Installera Azure CLI på Linux

  • Artikel

Den här artikeln beskriver hur du installerar Azure CLI på Linux. Välj lämplig pakethanterare för din distribution från alternativen överst på sidan. Du rekommenderas att använda en Linux-distributions pakethanterare, men du kan installera Azure CLI manuellt på Linux genom att välja alternativet Installera skript .

Den aktuella versionen av Azure CLI är 2.59.0. Information om den senaste versionen finns i viktig information. Kör az version för att hitta den installerade versionen och se om du behöver uppdatera.

Innan du börjar

  • Azure CLI 2.38.1 (som släpptes den 1 september 2023) är den senaste versionen som stöds på RHEL 7 och Centos 7 och fortsätter att ta emot säkerhetskorrigeringar fram till slutet av operativsystemens livslängd. Microsoft tillhandahåller inte andra uppdateringar eller felkorrigeringar för dessa distributioner.

  • Microsoft fortsätter att utveckla och stödja Azure CLI och Linux-installationsskriptet.

  • yum Använd pakethanteraren om du använder ett Linux-system som inte stöder dnf pakethanteraren.

Installera Azure CLI

Följ dessa steg för att installera Azure CLI:

  1. Importera Microsoft-lagringsplatsnyckeln.

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

  2. Lägg till packages-microsoft-com-prod lagringsplats för RHEL 9 eller CentOS Stream 9:

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

    Lägg till packages-microsoft-com-prod lagringsplats för RHEL 8 eller CentOS Stream 8:

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

    Lägg till azure-cli lagringsplats för RHEL 7 eller CentOS 7:

    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. Installera med dnf install-kommandot.

    sudo dnf install azure-cli

Installera specifik version

Du måste först konfigurera azure-cli lagringsplatsinformation som du visade tidigare. Tillgängliga versioner finns i Viktig information om Azure CLI.

  1. Så här visar du tillgängliga versioner med kommandot:

    dnf list --showduplicates azure-cli

  2. Så här installerar du en specifik version:

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

Uppdatera Azure CLI

Från och med version 2.11.0 tillhandahåller Azure CLI ett kommando i verktyget för att uppdatera till den senaste versionen.

az upgrade

Detta kommando uppdaterar även alla installerade tillägg som standard. Fler az upgrade alternativ finns på kommandoreferenssidan. För Azure CLI-versioner före 2.11.0 uppdaterar du genom att installera om enligt beskrivningen i Installera Azure CLI.

Du kan också uppdatera Azure CLI med dnf update kommandot .

sudo dnf update azure-cli

Avinstallera Azure CLI

Vi tycker att det är tråkigt om du väljer att avinstallera Azure CLI. Innan du avinstallerar använder du kommandot az feedback för att berätta för oss vad som kan förbättras eller åtgärdas. Vårt mål är att göra Azure CLI så felfritt och användarvänligt som möjligt. Om du har hittat en bugg vill vi gärna att du öppnar ett GitHub-supportärende.

  1. Ta bort paketet från datorn.

    sudo dnf remove azure-cli

  2. Ta bort lagringsinformationen om du inte tänker installera om CLI.

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

  3. Om du inte använder några andra Microsoft-paket tar du bort signeringsnyckeln.

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

Ta bort data

Om du inte planerar att installera om Azure CLI tar du bort dess data.

rm -rf ~/.azure

Felsökning

Här är några vanliga problem som kan uppstå vid installation med dnf. Om du upplever ett problem som inte beskrivs här kan du skapa ett problem på GitHub.

Installera på RHEL 7.6 eller andra system utan Python 3

Om du kan uppgradera systemet till en version med officiellt stöd för python 3.6+ paketet. Annars måste du först installera ett python3 paket och sedan installera Azure CLI utan beroende.

Du kan använda följande kommando för att ladda ned och installera Azure CLI-installationsskriptet med python 3.6 skapat från källa:

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

Du kan också göra det steg för steg:

Först kräver SSL 1.1+ Azure CLI och du måste skapa openssl 1.1 från källan innan du skapar 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

Skapa sedan Python 3 från källan:

PYTHON_VERSION="3.6.9"
PYTHON_SRC_DIR=$(mktemp -d)
wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
cd $PYTHON_SRC_DIR/Python-$PYTHON_VERSION
./configure --prefix=/usr --with-openssl=/usr/local/ssl
make
sudo make install

Följ slutligen steg 1 och 2 i installationsinstruktionen för att lägga till Azure CLI-lagringsplatsen. Nu kan du ladda ned paketet och installera det utan beroende.

Kommentar

Om plugin-programmet dnf download inte redan är installerat visas ett command not found fel när du kör följande kod. Använd dnf install 'dnf-command(download)' för att installera plugin-programmet för nedladdning av dnf.

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

Alternativt kan du även installera Python 3 med hjälp av en annan lagringsplats. Använd den här metoden om du har konfigurerat python3 men fortfarande får felet python3: command not found. Kontrollera att den har inkluderats i din sökväg.

scl enable rh-python36 bash

Proxy blockerar anslutning

Om du inte kan ansluta till en extern resurs på grund av en proxy kontrollerar du att du har angett variablerna HTTP_PROXY och HTTPS_PROXY i gränssnittet korrekt. Du måste kontakta systemadministratören för att veta vilka värdar och portar som ska användas för dessa proxyservrar.

Värdena i dessa variabler används av många Linux-program och under installationsprocessen. Så här anger du följande värden:

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

Viktigt!

Om du är bakom en proxy måste dessa gränssnittsvariabler anges för att ansluta till Azure-tjänster med CLI. Om du inte använder grundläggande autentisering rekommenderar vi att du exporterar dessa variabler i .bashrc filen. Följ alltid företagets säkerhetsprinciper och systemadministratörens krav.

Du kanske också vill konfigurera dnf att alltid använda den här proxyn. Kontrollera att följande rader visas under avsnittet [main] i /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

För att hämta Microsoft-signeringsnyckeln och paketet från vår lagringsplats måste proxyn tillåta HTTPS-anslutningar till följande adress:

  • https://packages.microsoft.com

CLI kan inte installeras eller köras på Windows-undersystem för Linux

Eftersom Windows-undersystem för Linux (WSL) är ett systemanropsöversättningslager ovanpå Windows-plattformen kan det uppstå ett fel när du försöker installera eller köra Azure CLI. CLI förlitar sig på vissa funktioner som kan ha en bugg i WSL. Om du får ett fel oavsett hur du installerar CLI finns det en god chans att det är ett problem med WSL och inte med CLI-installationsprocessen.

Så här felsöker du WSL-installationen och eventuellt löser problem:

  • Om du kan kan du köra en identisk installationsprocess på en Linux-dator eller virtuell dator för att se om den lyckas. Om det gör det är problemet sannolikt relaterat till WSL. Information om hur du startar en virtuell Linux-dator i Azure finns i dokumentationen om att skapa en virtuell Linux-dator.
  • Kontrollera att du kör den senaste versionen av WSL. Uppdatera din Windows 10-installation för att få den senaste versionen.
  • Kontrollera om det finns några öppna problem med WSL som kan lösa problemet. Ofta finns det förslag på hur du kan kringgå problemet eller information om en version där problemet är åtgärdat.
  • Om det inte finns några befintliga problem för ditt problem kan du skapa ett nytt problem med WSL och se till att du tar med så mycket information som möjligt.

Om du fortfarande har problem med att installera eller köra på WSL kan du överväga att installera CLI för Windows.

Innan du börjar

  • Azure CLI 2.38.1 (släpptes den 1 september 2023) är den senaste versionen som stöds på SUSE Linux Enterprise Server (SLES) och OpenSUSE (Leap) och fortsätter att ta emot säkerhetskorrigeringar fram till slutet av juni 2024. Microsoft tillhandahåller inte andra uppdateringar eller felkorrigeringar för dessa distributioner.

  • Microsoft fortsätter att utveckla och stödja Azure CLI och Linux Install-skriptet. SUSE underhåller och stöder paket som tillhandahålls av SUSE/OpenSUSE-lagringsplatser.

  • I Azure har virtuella SUSE- och OpenSUSE-datorer (VM) som baseras på Azure Marketplace-avbildningar redan Azure CLI installerat.

Installera Azure CLI

Om du vill installera Azure CLI på SUSE/OpenSUSE väljer du någon av följande metoder:

  1. Använd Enterprise-paketet som tillhandahålls av SUSE i SUSE/OpenSUSE-lagringsplatserna.

  2. Använd installationsmetoden som beskrivs på fliken "Installera skript (valfritt)".

  3. Installera från Microsoft-lagringsplatser

Installera från SUSE- eller OpenSUSE-lagringsplatser

RPM-paketet i Azure CLI beror på paketet python3 .

sudo zypper install -y azure-cli

Installera med installationsskriptet

Du kan installera Azure CLI manuellt på valfri version av Linux med hjälp av alternativet Installera skript .

Om du uppdaterar till den senaste versionen med den här metoden måste du avinstallera den tidigare versionen först och eventuella lagringsplatser som du kan ha lagt till för den versionen.

Installera från Microsoft-lagringsplatser

Följ dessa steg om du vill installera den senaste historiska versionen av Azure CLI med hjälp av Microsoft-lagringsplatser.

(Det här paketet har testats med SLES 15 och OpenSUSE Leap 15.1)

  1. Installera curl:

    sudo zypper install -y curl

  2. Importera nyckeln för Microsoft-lagringsplatsen:

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

  3. Skapa information om lokal azure-cli-lagringsplats:

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

  4. Uppdatera zypper-paketindexet och installera:

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

    Indata 2 för att fortsätta installationen genom att ignorera vissa av dess beroenden.

Installera specifik version

Du måste först konfigurera azure-cli lagringsplatsinformation som du visade tidigare. Tillgängliga versioner finns i Viktig information om Azure CLI.

  1. Visa tillgängliga versioner med det här kommandot:

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

  2. Så här installerar du en specifik version:

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

Uppdatera Azure CLI

Från och med version 2.11.0 tillhandahåller Azure CLI ett kommando i verktyget för att uppdatera till den senaste versionen.

az upgrade

Detta kommando uppdaterar även alla installerade tillägg som standard. Fler az upgrade alternativ finns på kommandoreferenssidan. För Azure CLI-versioner före 2.11.0 uppdaterar du genom att installera om enligt beskrivningen i Installera Azure CLI.

Du kan också uppdatera paketet med zypper update kommandot .

sudo zypper refresh
sudo zypper update azure-cli

Avinstallera Azure CLI

Vi tycker att det är tråkigt om du väljer att avinstallera Azure CLI. Innan du avinstallerar använder du kommandot az feedback för att berätta för oss vad som kan förbättras eller åtgärdas. Vårt mål är att göra Azure CLI så felfritt och användarvänligt som möjligt. Om du har hittat en bugg vill vi gärna att du öppnar ett GitHub-supportärende.

  1. Ta bort paketet från datorn.

    sudo zypper remove -y azure-cli

  2. Ta bort lagringsinformationen om du inte tänker installera om CLI.

    sudo zypper removerepo azure-cli

  3. Om du inte använder andra Microsoft-paket tar du bort Microsoft-signeringsnyckeln.

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

Ta bort data

Om du inte planerar att installera om Azure CLI tar du bort dess data.

rm -rf ~/.azure

Felsökning

Här är några vanliga problem som kan uppstå vid installation med zypper. Om du upplever ett problem som inte beskrivs här kan du skapa ett problem på GitHub.

Installera utan Python 3

Viktigt!

RPM-paketet i Azure CLI beror på paketet python3 . I systemet kan detta vara en Python-version som föregår kravet på Python 3.6.x. Om detta påverkar dig hittar du ett ersättningspaket python3 .

Tänk på att Python 2 har nått slutet av livet (EOL) den 1 januari 2020 och inte längre får uppdateringar. Azure CLI har tagit bort stödet för Python 2.7 sedan version 2.1.0. Nyare versioner av CLI kanske inte körs korrekt med Python 2.7.

NotImplementedError på en virtuell OpenSUSE 15-dator

Den virtuella OpenSUSE 15-datorn har en förinstallerad Azure CLI med version 2.0.45, som är inaktuell och har problem med az login. Ta bort den här versionen tillsammans med dess beroenden innan du följer installationsinstruktionen för att lägga till den senaste Azure CLI:

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

Om du har uppdaterat Azure CLI utan att ta bort beroendena för version 2.0.45 kan dess gamla beroenden påverka den senaste versionen av Azure CLI. Du måste lägga till den gamla versionen för att länka till dess beroenden och sedan ta bort azure-cli den tillsammans med dess beroenden:

# 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

Installera på SLES 12 eller andra system utan Python 3.6

På SLES 12 är standardpaketet python3 3.4 och stöds inte av Azure CLI. Du kan först följa steg 1–3 i installationsinstruktionen för att lägga till lagringsplatsenazure-cli. Skapa sedan en högre version python3 från källan. Slutligen kan du ladda ned Azure CLI-paketet och installera det utan beroende.

Du kan använda följande kommando för att installera eller uppdatera Azure CLI baserat på stegen ovan. Skriptet installerar Python 3.8 under /usr/local/azcli och gör att Azure CLI använder det genom att ange ett alias az för till PATH=/usr/local/azcli/bin:$PATH az. Du kan också ladda ned skriptet och ändra det efter dina behov. Du kan till exempel ändra Python-versionen eller installationsplatsen.

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

Kom ihåg att köra följande kommando för att aktivera aliaset för första gången:

source ~/.bashrc

Proxy blockerar anslutning

Om du inte kan ansluta till en extern resurs på grund av en proxy kontrollerar du att du har angett variablerna HTTP_PROXY och HTTPS_PROXY i gränssnittet korrekt. Du måste kontakta systemadministratören för att veta vilka värdar och portar som ska användas för dessa proxyservrar.

Värdena i dessa variabler används av många Linux-program och under installationsprocessen. Så här anger du följande värden:

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

Viktigt!

Om du är bakom en proxy måste dessa gränssnittsvariabler anges för att ansluta till Azure-tjänster med CLI. Om du inte använder grundläggande autentisering rekommenderar vi att du exporterar dessa variabler i .bashrc filen. Följ alltid företagets säkerhetsprinciper och systemadministratörens krav.

Du kanske också vill konfigurera zypper (via yast2) att alltid använda den här proxyn. Det gör du genom att yast2 proxy köra kommandot som superanvändare och fylla i informationen som visas i formuläret. Om du har en tillgänglig fönsterhanterare i systemet kan du också använda fönstret Network Services > Proxy i YaST Control Center.

Mer information om avancerad konfiguration finns i dokumentationen för Konfiguration av OpenSUSE-proxy

För att hämta Microsoft-signeringsnyckeln och hämta paketet från vår lagringsplats måste proxyn tillåta HTTPS-anslutningar till följande adresser:

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

CLI kan inte installeras eller köras på Windows-undersystem för Linux

Eftersom Windows-undersystem för Linux (WSL) är ett systemanropsöversättningslager ovanpå Windows-plattformen kan det uppstå ett fel när du försöker installera eller köra Azure CLI. CLI förlitar sig på vissa funktioner som kan ha en bugg i WSL. Om du får ett fel oavsett hur du installerar CLI finns det en god chans att det är ett problem med WSL och inte med CLI-installationsprocessen.

Så här felsöker du WSL-installationen och eventuellt löser problem:

  • Om du kan kan du köra en identisk installationsprocess på en Linux-dator eller virtuell dator för att se om den lyckas. Om det gör det är problemet sannolikt relaterat till WSL. Information om hur du startar en virtuell Linux-dator i Azure finns i dokumentationen om att skapa en virtuell Linux-dator.
  • Kontrollera att du kör den senaste versionen av WSL. Uppdatera din Windows 10-installation för att få den senaste versionen.
  • Kontrollera om det finns några öppna problem med WSL som kan lösa problemet. Ofta finns det förslag på hur du kan kringgå problemet eller information om en version där problemet är åtgärdat.
  • Om det inte finns några befintliga problem för ditt problem kan du skapa ett nytt problem med WSL och se till att du tar med så mycket information som möjligt.

Om du fortfarande har problem med att installera eller köra på WSL kan du överväga att installera CLI för Windows.

Problem med SSL-certifikat

När ett certifikat är brutet eller inaktuellt på en dator kan du få ett fel som anger att curl inte kunde verifiera serverns legitimitet och därför inte kunde upprätta en säker anslutning. Uppdatera certifikatet för att åtgärda problemet.

sudo zypper update-ca-certificates

Innan du börjar

  • Pakethanteraren apt innehåller x86_64- och ARM64-paket för Azure CLI som har testats på följande distributioner.

    Distribution Version
    Ubuntu 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish)
    Debian 10 (Buster), 11 (Bullseye), 12 (Bookworm)

  • Ubuntu 20.04 (Focal Fossa) och 20.10 (Groovy Gorilla) innehåller ett azure-cli paket med version 2.0.81 som tillhandahålls av universe lagringsplatsen. Det här paketet är inaktuellt och rekommenderas inte. Om det här paketet är installerat tar du bort paketet innan du fortsätter genom att köra kommandot sudo apt remove azure-cli -y && sudo apt autoremove -y. Mer information om apt removefinns i Ubuntu-pakethantering eller fråga ubuntu.

Installera Azure CLI

Det finns två alternativ för att installera Azure CLI i systemet. Du kan ladda ned ett installationsskript som kör installationskommandona åt dig, eller så kan du köra installationskommandona själv i en stegvis process. Båda metoderna finns här:

Alternativ 1: Installera med ett kommando

Det enklaste sättet att installera Azure CLI är genom ett skript som underhålls av Azure CLI-teamet. Det här skriptet kör alla installationskommandon i ett steg. Det här skriptet laddas ned via curl och skickas direkt till för att bash installera CLI.

Om du vill granska innehållet i skriptet själv innan du kör det laddar du ned skriptet först med hjälp av curl och inspekterar det i din favorittextredigerare.

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

Alternativ 2: Stegvisa installationsanvisningar

Om du föredrar en stegvis installationsprocess utför du följande steg för att installera Azure CLI.

  1. Hämta paket som behövs för installationsprocessen:

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

  2. Ladda ned och installera Microsoft-signeringsnyckeln:

    sudo mkdir -p /etc/apt/keyrings
curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
  sudo gpg --dearmor -o /etc/apt/keyrings/microsoft.gpg
sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
  3. Lägg till Azure CLI-programvarulagringsplatsen: 
    AZ_DIST=$(lsb_release -cs)
echo "Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: ${AZ_DIST}
Components: main
Architectures: $(dpkg --print-architecture)
Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources

  4. Uppdatera information om lagringsplatsen och installera paketet azure-cli :

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

Installera specifik version

Konfigurera lagringsplatsens azure-cli information som du visade tidigare. Tillgängliga versioner finns i Viktig information om Azure CLI.

  1. Visa tillgängliga versioner av Azure CLI.

    apt-cache policy azure-cli

  2. Installera en specifik version.

    # Obtain the currently installed distribution
AZ_DIST=$(lsb_release -cs)

# Store an Azure CLI version of choice
AZ_VER=2.51.0

# Install a specific version
sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}

    Om du vill installera en specifik version utan variabler ersätter du Azure CLI-versionen och Linux-distributionsnamnet som visas:

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

Om du får felmeddelandet Det går inte att hitta paketet azure-cli azure-cliär lagringsplatsens information inte konfigurerad. Följ stegen i Alternativ 2: Stegvisa installationsanvisningar.

Om du får felmeddelandet Version x.xx.x-1~distributionName för azure-cli hittades inte använder lsb_release -cs du för att hitta den distribution som du kör.

Uppdatera Azure CLI

Från och med version 2.11.0 tillhandahåller Azure CLI ett kommando i verktyget för att uppdatera till den senaste versionen.

az upgrade

Detta kommando uppdaterar även alla installerade tillägg som standard. Fler az upgrade alternativ finns på kommandoreferenssidan. För Azure CLI-versioner före 2.11.0 uppdaterar du genom att installera om enligt beskrivningen i Installera Azure CLI.

Du kan också använda apt-get upgrade för att uppdatera CLI-paketet. Det här kommandot uppgraderar alla installerade paket i systemet som inte har haft någon beroendeändring.

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

Om du bara vill uppgradera CLI använder du apt-get install.

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

Avinstallera Azure CLI

Vi tycker att det är tråkigt om du väljer att avinstallera Azure CLI. Innan du avinstallerar använder du kommandot az feedback för att berätta för oss vad som kan förbättras eller åtgärdas. Vårt mål är att göra Azure CLI så felfritt och användarvänligt som möjligt. Om du har hittat en bugg vill vi gärna att du öppnar ett GitHub-supportärende.

  1. Avinstallera med apt-get remove:

    sudo apt-get remove -y azure-cli

  2. Om du inte planerar att installera om CLI tar du bort azure CLI-lagringsplatsens information:

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

  3. Om du inte använder andra paket från Microsoft tar du bort signeringsnyckeln:

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

  4. Ta bort eventuella onödiga paket:

    sudo apt autoremove

Ta bort data

Om du inte planerar att installera om Azure CLI tar du bort dess data.

rm -rf ~/.azure

Felsökning

Här är några vanliga problem som kan uppstå vid installation med apt. Om du upplever ett problem som inte beskrivs här kan du skapa ett problem på GitHub.

Paketet azure-cli stöder ARM64-arkitektur från CLI version 2.46.0.

Inget modulproblem på Ubuntu 20.04 (Focal)/WSL

Om du installerade azure-cli på utan att lägga till Azure CLI-programvarulagringsplatsen i steg 3 i de manuella installationsanvisningarna eller med hjälp av vårt skript, kan du stöta på Focal problem som att ingen modul med namnet "dekoratör" eller "antlr4" eftersom paketet du installerade är inaktuellt azure-cli 2.0.81 från focal/universe lagringsplatsen. Ta bort det först genom att köra sudo apt remove azure-cli -y && sudo apt autoremove -yoch följ sedan instruktionerna ovan för att installera det senaste azure-cli paketet.

lsb_release returnerar inte rätt basdistributionsversion

Vissa Ubuntu- eller andra Debian-härledda distributioner (till exempel Linux Mint) kanske inte returnerar rätt versionsnamn från lsb_release. Det här värdet används i installationen för att fastställa vilket paket som ska installeras. Om du känner till kodnamnet för den Ubuntu- eller Debianversion som din distribution härleds från kan du ange AZ_REPO värdet manuellt när du lägger till lagringsplatsen. I annat fall letar du upp information för din distribution om hur du fastställer namnet på basdistributionskoden och anger AZ_REPO rätt värde.

Inget paket för distributionen

Ibland är ett uppdaterat Azure CLI-paket inte omedelbart tillgängligt efter en distributionsversion. Azure CLI är utformat för att vara motståndskraftigt mot framtida versioner av beroenden och förlitar sig på så få av dem som möjligt. Om det inte finns något tillgängligt paket för basdistributionen kan du prova ett paket för en tidigare distribution.

Om du vill prova ett paket för en tidigare distribution anger du värdet AZ_REPO för manuellt när du lägger till lagringsplatsen. För Ubuntu-distributioner använder du den senaste jammy lagringsplatsen:

AZ_REPO="jammy"

För Debiandistributioner använder du den senaste bookworm lagringsplatsen:

AZ_REPO="bookworm"

Viktigt!

Distributioner som släpptes före Ubuntu Bionic och Debian Buster stöds inte.

Elementärt operativsystem (EOS) kan inte installera Azure CLI

EOS kan inte installera Azure CLI eftersom lsb_release returnerar HERA, vilket är EOS-versionsnamnet. Lösningen är att åtgärda filen /etc/apt/sources.list.d/azure-cli.sources och ändra Suites: hera till Suites: bionic.

Ursprungligt filinnehåll:

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

Ändrat filinnehåll

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

Proxy blockerar anslutning

Om du inte kan ansluta till en extern resurs på grund av en proxy kontrollerar du att du har angett variablerna HTTP_PROXY och HTTPS_PROXY i gränssnittet korrekt. Du måste kontakta systemadministratören för att veta vilka värdar och portar som ska användas för dessa proxyservrar.

Värdena i dessa variabler används av många Linux-program och under installationsprocessen. Så här anger du följande värden:

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

Viktigt!

Om du är bakom en proxy måste dessa gränssnittsvariabler anges för att ansluta till Azure-tjänster med CLI. Om du inte använder grundläggande autentisering rekommenderar vi att du exporterar dessa variabler i .bashrc filen. Följ alltid företagets säkerhetsprinciper och systemadministratörens krav.

Du kanske också vill konfigurera apt att alltid använda den här proxyn. Kontrollera att följande rader visas i en apt konfigurationsfil i /etc/apt/apt.conf.d/. Vi rekommenderar att du använder antingen din befintliga globala konfigurationsfil, en befintlig proxykonfigurationsfil, 40proxieseller 99local, men följer kraven för systemadministration.

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

Om proxyn inte använder grundläggande autentisering tar du bort[username]:[password]@ delen av proxy-URI:n. Om du behöver mer information för proxykonfiguration kan du läsa den officiella Ubuntu-dokumentationen:

För att hämta Microsoft-signeringsnyckeln och hämta paketet från vår lagringsplats måste proxyn tillåta HTTPS-anslutningar till följande adress: "https://packages.microsoft.com.

CLI kan inte installeras eller köras på Windows-undersystem för Linux

Eftersom Windows-undersystem för Linux (WSL) är ett systemanropsöversättningslager ovanpå Windows-plattformen kan det uppstå ett fel när du försöker installera eller köra Azure CLI. CLI förlitar sig på vissa funktioner som kan ha en bugg i WSL. Om du får ett fel oavsett hur du installerar CLI finns det en god chans att det är ett problem med WSL och inte med CLI-installationsprocessen.

Så här felsöker du WSL-installationen och eventuellt löser problem:

  • Om du kan kan du köra en identisk installationsprocess på en Linux-dator eller virtuell dator för att se om den lyckas. Om det gör det är problemet sannolikt relaterat till WSL. Information om hur du startar en virtuell Linux-dator i Azure finns i dokumentationen om att skapa en virtuell Linux-dator.
  • Kontrollera att du kör den senaste versionen av WSL. Uppdatera din Windows 10-installation för att få den senaste versionen.
  • Kontrollera om det finns några öppna problem med WSL som kan lösa problemet. Ofta finns det förslag på hur du kan kringgå problemet eller information om en version där problemet är åtgärdat.
  • Om det inte finns några befintliga problem för ditt problem kan du skapa ett nytt problem med WSL och se till att du tar med så mycket information som möjligt.

Om du fortfarande har problem med att installera eller köra på WSL kan du överväga att installera CLI för Windows.

Installera Azure CLI

RPM:er släpps för Azure Linux via CBL-Mariner. Paketet azure-cli stöder ARM64-arkitektur från CLI version 2.46.0.

Följ dessa steg för att installera Azure CLI:

  1. Installera den officiella Microsoft-kurerade uppsättningen betrodda rotcertifikat:

    sudo tdnf install ca-certificates

  2. Installera Azure CLI:

    sudo tdnf install azure-cli

Installera specifik version

Tillgängliga versioner finns i Viktig information om Azure CLI.

Så här visar du tillgängliga versioner med kommandot:

tdnf list azure-cli

Så här installerar du en specifik version:

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

Uppdatera Azure CLI

Uppdatera Azure CLI med tdnf update kommandot:

sudo tdnf update azure-cli

Avinstallera Azure CLI

Vi tycker att det är tråkigt om du väljer att avinstallera Azure CLI. Innan du avinstallerar använder du kommandot az feedback för att berätta för oss vad som kan förbättras eller åtgärdas. Vårt mål är att göra Azure CLI så felfritt och användarvänligt som möjligt. Om du har hittat en bugg vill vi gärna att du öppnar ett GitHub-supportärende.

Ta bort paketet från systemet:

sudo tdnf remove azure-cli

Ta bort data

Om du inte planerar att installera om Azure CLI tar du bort dess data.

rm -rf ~/.azure

Innan du börjar

Vi rekommenderar starkt att du installerar CLI med en pakethanterare. Med en pakethanterare får du alltid de senaste uppdateringarna och kan vara säker på att CLI-komponenterna är stabila. Kontrollera om det finns ett paket för distributionen innan du installerar manuellt.

CLI måste ha följande programvara:

Installera eller uppdatera Azure CLI

Både installation och uppdatering av Azure CLI kräver att installationsskriptet körs igen.

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

Skriptet kan också laddas ned och köras lokalt. Du kan behöva starta om gränssnittet för att ändringarna ska börja gälla.

Avinstallera Azure CLI

Vi tycker att det är tråkigt om du väljer att avinstallera Azure CLI. Innan du avinstallerar använder du kommandot az feedback för att berätta för oss vad som kan förbättras eller åtgärdas. Vårt mål är att göra Azure CLI så felfritt och användarvänligt som möjligt. Om du har hittat en bugg vill vi gärna att du öppnar ett GitHub-supportärende.

Avinstallera CLI genom att ta bort filerna direkt från platsen som valts vid installationen. Standardinstallationsplatsen är användarens hemkatalog ($HOME).

  1. Ta bort de installerade CLI-filerna.

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

  2. Ändra filen $HOME/.bash_profile för att ta bort följande rad:

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

  3. Läs in gränssnittets kommandocacheminne om du använder bash eller zsh.

    hash -r

Ta bort data

Om du inte planerar att installera om Azure CLI tar du bort dess data.

rm -rf ~/.azure

Felsökning

Här är några vanliga problem som kan uppstå vid manuell installation. Om du upplever ett problem som inte beskrivs här kan du skapa ett problem på GitHub.

Installera utan Python 3

Azure CLI har tagit bort stödet för Python 2.7 sedan version 2.1.0. I systemet kan det finnas en Python-version som föregår kravet på Python 3.6.x. Hitta ett ersättningspaket python3 .

Fel: curl "Object Moved"

Om curl returnerar ett fel relaterat till -L-parametern, eller ett felmeddelande som innehåller texten ”Object Moved”, provar du att använda den fullständiga URL-adressen i stället för aka.ms-omdirigeringen:

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

Det gick inte att hitta kommandot az

Om du inte kan köra kommandot efter installationen med eller bashzshkan du prova att rensa gränssnittets kommandohashcache och kontrollera om problemet är löst.

hash -r

Det här problemet kan även inträffa om du inte startade om gränssnittet efter installationen. Kontrollera att platsen för kommandot az är i $PATH. az-kommandots plats är

 <install path>/bin

Proxy blockerar anslutning

Om du inte kan ansluta till en extern resurs på grund av en proxy kontrollerar du att du har angett variablerna HTTP_PROXY och HTTPS_PROXY i gränssnittet korrekt. Du måste kontakta systemadministratören för att veta vilka värdar och portar som ska användas för dessa proxyservrar.

Värdena i dessa variabler används av många Linux-program och under installationsprocessen. Så här anger du följande värden:

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

Viktigt!

Om du är bakom en proxy måste dessa gränssnittsvariabler anges för att ansluta till Azure-tjänster med CLI. Om du inte använder grundläggande autentisering rekommenderar vi att du exporterar dessa variabler i .bashrc filen. Följ alltid företagets säkerhetsprinciper och systemadministratörens krav.

För att hämta installationsskripten måste proxyn tillåta HTTPS-anslutningar till följande adresser:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Slutpunkter som används av distributionens pakethanterare (om några) för kärnpaket

CLI kan inte installeras eller köras på Windows-undersystem för Linux

Eftersom Windows-undersystem för Linux (WSL) är ett systemanropsöversättningslager ovanpå Windows-plattformen kan det uppstå ett fel när du försöker installera eller köra Azure CLI. CLI förlitar sig på vissa funktioner som kan ha en bugg i WSL. Om du får ett fel oavsett hur du installerar CLI finns det en god chans att det är ett problem med WSL och inte med CLI-installationsprocessen.

Så här felsöker du WSL-installationen och eventuellt löser problem:

  • Om du kan kan du köra en identisk installationsprocess på en Linux-dator eller virtuell dator för att se om den lyckas. Om det gör det är problemet sannolikt relaterat till WSL. Information om hur du startar en virtuell Linux-dator i Azure finns i dokumentationen om att skapa en virtuell Linux-dator.
  • Kontrollera att du kör den senaste versionen av WSL. Uppdatera din Windows 10-installation för att få den senaste versionen.
  • Kontrollera om det finns några öppna problem med WSL som kan lösa problemet. Ofta finns det förslag på hur du kan kringgå problemet eller information om en version där problemet är åtgärdat.
  • Om det inte finns några befintliga problem för ditt problem kan du skapa ett nytt problem med WSL och se till att du tar med så mycket information som möjligt.

Om du fortfarande har problem med att installera eller köra på WSL kan du överväga att installera CLI för Windows.

Nästa steg

Nu när du har installerat Azure CLI kan du ta en kort rundtur av dess funktioner och vanliga kommandon.

Kom igång med Azure CLI