Installera Azure CLI på Linux

Azure CLI är ett plattformsoberoende kommandoradsverktyg som kan installeras lokalt på Linux-datorer. Du kan använda Azure CLI på Linux för att ansluta till Azure och köra administrativa kommandon på Azure-resurser. Med CLI på Linux kan du köra olika kommandon via en terminal med hjälp av interaktiva kommandoradsuppmanningar eller ett skript. När du är redo att installera Azure CLI på Linux rekommenderar vi att du använder pakethanteraren för en Linux-distribution. Välj lämplig pakethanterare för distributionen från alternativen ovan. Om du inte har någon av pakethanterarena i listan kan du manuellt installera Azure CLI på Linux genom att välja alternativet Installera skript.

Den aktuella versionen av Azure CLI är 2.31.0. Information om den senaste versionen finns i viktig information. Om du vill hitta den installerade versionen och se om du behöver uppdatera kör du az version.

Översikt

Pakethanteraren apt innehåller ett x86_64 för Azure CLI som har testats på följande distributioner.

Distribution Version
Ubuntu 14.04 LTS (Trusty Tahir), 16.04 LTS (Xenial Xerus), 18.04 LTS (Bionic Gren), 20.04 LTS (Fossa), 20.10 (GroovyFält)
Debian Debian 8 (), Debian 9 (Stretch), Debian 10 (Debian 10)

Varning

Ubuntu 20.04 (Focal Fossa) och 20.10 (Groovy Ubuntu) innehåller ett paket med version som tillhandahålls av azure-cli 2.0.81 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 .

azure-cliDeb-paketet stöder inte ARM64-arkitekturen.

Installationsalternativ

Det finns två alternativ för att installera Azure CLI på datorn. Först kan du köra ett enda kommando som laddar ned ett installationsskript och kör installationskommandona åt dig. Eller om du vill kan du köra installationskommandona själv i en steg-för-steg-process. Båda metoderna finns nedan.

Alternativ 1: Installera med ett kommando

Azure CLI-teamet har ett skript för att köra alla installationskommandon i ett enda steg. Det här skriptet laddas ned via curl och skickas direkt till för att installera bash CLI.

Om du vill granska innehållet i skriptet själv innan du kör det laddar du bara ned skriptet först med och inspekterar curl 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 de paket som behövs för installationsprocessen:

    sudo apt-get update
    sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. Ladda ned och installera Microsoft-signeringsnyckeln:

    curl -sL https://packages.microsoft.com/keys/microsoft.asc |
        gpg --dearmor |
        sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
    
  3. Lägg till Azure CLI-programvarulagringsplatsen:
    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. Uppdatera lagringsplatsinformationen och installera azure-cli paketet:

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

Installera en specifik version

Du måste först konfigurera azure-cli lagringsplatsinformationen enligt ovan. Tillgängliga versioner finns i Versionsanteckningar för Azure CLI.

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

    apt-cache policy azure-cli
    
  2. Så här installerar du en specifik version:

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

Felsökning

Här är några vanliga problem som kan uppstå vid installation med apt. Om du stöter på ett problem som inte beskrivs här kan du öppna ett ärende på github.

Inget modulproblem på Ubuntu 20.04 (Fokus)/WSL

Om du har installerat 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å problem som att ingen modul med namnet azure-cli Focal "decorator" eller "antlr4" är det paket som du har installerat är inaktuellt från lagringsplatsen. azure-cli 2.0.81 focal/universe Ta bort den först genom att köra sudo apt remove azure-cli -y && sudo apt autoremove -y och följ sedan anvisningarna ovan för att installera det senaste azure-cli paketet.

lsb_release returnerar inte rätt basdistributionsversion

Vissa Ubuntu- eller 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 Ubuntu- eller Debian-versionen som distributionen härleds från kan du ange värdet manuellt när AZ_REPO du lägger till lagringsplatsen. Annars kan du leta upp information för din distribution om hur du fastställer namnet på basdistributionskoden och AZ_REPO anger rätt värde.

Inget paket för distributionen

Ibland kan det ta en stund efter att en distribution har släppts innan det finns ett Azure CLI-paket tillgängligt för den. Azure CLI har utformats 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 paket tillgängligt för basdistributionen kan du prova ett paket för en tidigare distribution.

Det gör du genom att ange värdet för manuellt AZ_REPO när du lägger till lagringsplatsen. För Ubuntu-distributioner använder bionic du lagringsplatsen och för Debian-distributioner använder du stretch . Distributioner som släppts före Ubuntu Trusty och Debian Ubuntuezy stöds inte.

Elementär OS (EOS) kan inte installera Azure CLI

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

Ursprungligt filinnehåll:

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

Ändrat filinnehåll

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

Proxy blockerar anslutning

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

Dessa värden respekteras av många Linux-program, inklusive de som används i installationsprocessen. Så här anger du dessa 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 proxyserver 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å uttryckligen vill konfigurera apt att använda den här proxyn hela tiden. Kontrollera att följande rader visas i en apt konfigurationsfil i /etc/apt/apt.conf.d/ . Vi rekommenderar att du använder din befintliga globala konfigurationsfil, en befintlig proxykonfigurationsfil, 40proxies eller , men följer 99local systemadministrationskraven.

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

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

För att kunna 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 översättningslager för systemanrop ovanpå Windows-plattformen kan det hända att du får ett fel när du försöker installera eller köra Azure CLI. CLI är beroende av vissa funktioner som kan ha en bugg i WSL. Om du får ett fel oavsett hur du installerar CLI är det en god risk 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 det går kan du köra en identisk installationsprocess på en Linux-dator eller virtuell dator för att se om den lyckas. I så fall är problemet nästan relaterat till WSL. Om du vill starta en virtuell Linux-dator i Azure kan du läsa dokumentationen om att skapa en virtuell Linux-dator i Azure Portal.
  • Kontrollera att du kör den senaste versionen av WSL. För att få den senaste versionen uppdaterar du Windows 10 installation.
  • Kontrollera om det finns öppna problem med WSL som kan lösa problemet. Det finns ofta förslag på hur du kan lösa problemet eller information om en version där problemet kommer att åtgärdas.
  • Om det inte finns några befintliga problem med ditt problem kan du öppna ett nytt problem med WSL och se till att du inkluderar så mycket information som möjligt.

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

Uppdatera

CLI innehåller ett verktygskommando för att uppdatera till den senaste versionen:

az upgrade

Anteckning

Kommandot lades till i version 2.11.0 och fungerar inte med versioner före az upgrade 2.11.0. Äldre versioner kan uppdateras genom att installera om enligt beskrivningen i Installera Azure CLI.

Det här kommandot uppdaterar också alla installerade tillägg som standard. Fler alternativ az upgrade finns på kommandoreferenssidan.

Du kan också använda apt-get upgrade för att uppdatera CLI-paketet.

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

Anteckning

Med det här kommandot uppgraderas alla installerade paket på datorn som ingen beroendeändring gjorts för. 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

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 informationen om Azure CLI-lagringsplatsen:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Om du inte använder några andra paket från Microsoft tar du bort signeringsnyckeln:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg
    
  4. Ta bort eventuella paket som inte behövers:

    sudo apt autoremove
    

Översikt

För dnf Linux-distributioner med till exempel RHEL, Fedora eller CentOS finns det ett paket för Azure CLI. Det här paketet har testats med RHEL 7.7, RHEL 8, Fedora 24 och senare, CentOS 7 och CentOS 8.

Den aktuella versionen av Azure CLI är 2.31.0. Information om den senaste versionen finns i viktig information. Om du vill hitta den installerade versionen och se om du behöver uppdatera kör du az version.

Viktigt

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

Tänk på att Python 2 har nått slutet av sin livscykel den 1 januari 2020 och kommer inte längre att ta emot uppdateringar. Azure CLI har släppt stöd för Python 2.7 sedan version 2.1.0 . Nya versioner garanterar inte längre att de körs korrekt med Python 2.7.

Anteckning

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

Installera

  1. Importera Microsoft-lagringsplatsnyckeln.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. Skapa information om lokal azure-cli-lagringsplats.

    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 en specifik version

Du måste först konfigurera azure-cli lagringsplatsens information enligt vad som visas ovan. Tillgängliga versioner finns i Versionsanteckningar för 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
    

Felsökning

Här är några vanliga problem som kan uppstå vid installation med dnf. Om du får problem som inte tas upp här kan du öppna ett ärende 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 paket python3 och sedan installera Azure CLI utan beroende.

Du kan använda följande kommando för att installera Azure CLI med python 3.6 skapad från källan:

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ör det första kräver Azure CLI SSL 1.1+ och du måste bygga från källan innan du skapar openssl 1.1 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.

Anteckning

Om du inte har installerat plugin-programmet dnf download får du ett felmeddelande om att kommandot inte hittades när koden nedan körs. Använd dnf install 'dnf-command(download)' för att installera dnf-nedladdnings-plugin-programmet.

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

Alternativt kan du även installera Python 3 via ytterligare lagringsplatsen. Om du har ställt in men fortfarande får ett felmeddelande när du försöker köra cli måste du lägga till det i python3 python3: command not found sökvägen.

$ scl enable rh-python36 bash

Proxy blockerar anslutning

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

Dessa värden respekteras av många Linux-program, inklusive de som används i installationsprocessen. Så här anger du dessa 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 proxyserver 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å uttryckligen vill konfigurera att dnf använda den här proxyn hela tiden. 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 kunna 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 översättningslager för systemanrop ovanpå Windows-plattformen kan det hända att du får ett fel när du försöker installera eller köra Azure CLI. CLI är beroende av vissa funktioner som kan ha en bugg i WSL. Om du får ett fel oavsett hur du installerar CLI är det en god risk 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 det går kan du köra en identisk installationsprocess på en Linux-dator eller virtuell dator för att se om den lyckas. I så fall är problemet nästan relaterat till WSL. Om du vill starta en virtuell Linux-dator i Azure kan du läsa dokumentationen om att skapa en virtuell Linux-dator i Azure Portal.
  • Kontrollera att du kör den senaste versionen av WSL. För att få den senaste versionen uppdaterar du Windows 10 installation.
  • Kontrollera om det finns öppna problem med WSL som kan lösa problemet. Det finns ofta förslag på hur du kan lösa problemet eller information om en version där problemet kommer att åtgärdas.
  • Om det inte finns några befintliga problem med ditt problem kan du öppna ett nytt problem med WSL och se till att du inkluderar så mycket information som möjligt.

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

Uppdatera

CLI innehåller ett verktygskommando för att uppdatera till den senaste versionen:

az upgrade

Anteckning

Kommandot lades till i version 2.11.0 och fungerar inte med versioner före az upgrade 2.11.0. Äldre versioner kan uppdateras genom att installera om enligt beskrivningen i Installera Azure CLI.

Det här kommandot uppdaterar också alla installerade tillägg som standard. Fler alternativ az upgrade finns på kommandoreferenssidan.

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

sudo dnf update azure-cli

Avinstallera

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
    

Översikt

För Linux-distributioner med zypper, till exempel openSUSE eller SLES, finns det ett paket för Azure CLI. Det här paketet har testats med openSUSE Leap 15.1 och SLES 15.

Den aktuella versionen av Azure CLI är 2.31.0. Information om den senaste versionen finns i viktig information. Om du vill hitta den installerade versionen och se om du behöver uppdatera kör du az version.

Viktigt

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

Tänk på att Python 2 har nått slutet av sin livscykel den 1 januari 2020 och kommer inte längre att ta emot uppdateringar. Azure CLI har släppt stöd för Python 2.7 sedan version 2.1.0 . Nya versioner garanterar inte längre att de körs korrekt med Python 2.7.

Installera

  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 några av dess beroenden.

Installera specifik version

Du måste först konfigurera azure-cli lagringsplatsens information enligt ovan. Tillgängliga versioner finns i Versionsanteckningar för Azure CLI.

  1. Så här visar du tillgängliga versioner med 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
    

Felsökning

Här är några vanliga problem som kan uppstå vid installation med zypper. Om du får problem som inte tas upp här kan du öppna ett ärende GitHub.

NotImplementedError på openSUSE 15 VM

Den virtuella OpenSUSE 15-datorn har en förinstallerad Azure CLI med version , den 2.0.45 är inaktuell och har problem med az login . Ta bort den 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 kan dess gamla beroenden påverka 2.0.45 den senaste versionen av Azure CLI. Du måste lägga till tillbaka den gamla versionen för att länka till dess beroenden och sedan ta azure-cli bort 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 stöds python3 och stöds 3.4 inte standardpaketet av Azure CLI. Du kan först följa steg 1–3 i installationsinstruktionen för att lägga till lagringsplatsen. azure-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 installeras Python 3.8 under och gör så att Azure CLI använder det genom att ange ett alias för till /usr/local/azcli az 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 proxyserver kontrollerar du att du har angett variablerna och korrekt HTTP_PROXY HTTPS_PROXY i gränssnittet. Du måste kontakta systemadministratören för att få veta vilka värdar och portar som ska användas för dessa proxy.

Dessa värden respekteras av många Linux-program, inklusive de som används i installationsprocessen. Så här anger du dessa 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 proxyserver 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å uttryckligen vill konfigurera zypper (via yast2 ) att använda den här proxyn hela tiden. 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å Network Services > Proxy använda fönstret i YaST Control Center .

Avancerad konfiguration eller mer information finns i konfigurationsdokumentationen för OpenSUSE Proxy

För att kunna hämta Microsofts signeringsnyckel 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 översättningslager för systemanrop ovanpå Windows-plattformen kan det hända att du får ett fel när du försöker installera eller köra Azure CLI. CLI är beroende av vissa funktioner som kan ha en bugg i WSL. Om du får ett fel oavsett hur du installerar CLI är det en god risk 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 det går kan du köra en identisk installationsprocess på en Linux-dator eller virtuell dator för att se om den lyckas. I så fall är problemet nästan relaterat till WSL. Om du vill starta en virtuell Linux-dator i Azure kan du läsa dokumentationen om att skapa en virtuell Linux-dator i Azure Portal.
  • Kontrollera att du kör den senaste versionen av WSL. För att få den senaste versionen uppdaterar du Windows 10 installation.
  • Kontrollera om det finns öppna problem med WSL som kan lösa problemet. Det finns ofta förslag på hur du kan lösa problemet eller information om en version där problemet kommer att åtgärdas.
  • Om det inte finns några befintliga problem med ditt problem kan du öppna ett nytt problem med WSL och se till att du inkluderar så mycket information som möjligt.

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

SSL-certifikatproblem

När ett certifikat är brutet eller inaktuellt på en dator kan du få ett felmeddelande som anger att curl inte kunde verifiera serverns äkthet 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

Uppdatera

CLI innehåller ett verktygskommando för att uppdatera till den senaste versionen:

az upgrade

Anteckning

Kommandot lades till i version 2.11.0 och fungerar inte med versioner före az upgrade 2.11.0. Äldre versioner kan uppdateras genom att installera om enligt beskrivningen i Installera Azure CLI.

Det här kommandot uppdaterar också alla installerade tillägg som standard. Fler alternativ az upgrade finns på kommandoreferenssidan.

Du kan också uppdatera paketet med zypper update kommandot .

sudo zypper refresh
sudo zypper update azure-cli

Avinstallera

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
    

Översikt

Anteckning

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 något paket för din distribution innan du installerar manuellt.

CLI måste ha följande programvara:

Viktigt

CLI har släppt stöd för Python 2.7 sedan version 2.1.0 . Nya versioner garanterar inte längre att de körs korrekt med Python 2.7.

Installera eller uppdatera

Både installation och uppdatering av CLI kräver att installationsskriptet körs på nytt. Installera CLI genom att köra curl.

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 vissa ändringar ska börja gälla.

Felsökning

Här är några vanliga problem som kan uppstå vid manuell installation. Om du får problem som inte tas upp här kan du öppna ett ärende GitHub.

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 och använder bash eller zsh så kan du behöva rensa cacheminnet för gränssnittets kommando-hash Kör

hash -r

och kontrollera om problemet är löst.

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 proxyserver kontrollerar du att du har angett variablerna och korrekt HTTP_PROXY HTTPS_PROXY i gränssnittet. Du måste kontakta systemadministratören för att få veta vilka värdar och portar som ska användas för dessa proxy.

Dessa värden respekteras av många Linux-program, inklusive de som används i installationsprocessen. Så här anger du dessa 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 proxyserver 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 kunna hämta installationsskripten måste proxyservern 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 det finns 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 översättningslager för systemanrop ovanpå Windows-plattformen kan det hända att du får ett fel när du försöker installera eller köra Azure CLI. CLI är beroende av vissa funktioner som kan ha en bugg i WSL. Om du får ett fel oavsett hur du installerar CLI är det en god risk 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 det går kan du köra en identisk installationsprocess på en Linux-dator eller virtuell dator för att se om den lyckas. I så fall är problemet nästan relaterat till WSL. Om du vill starta en virtuell Linux-dator i Azure kan du läsa dokumentationen om att skapa en virtuell Linux-dator i Azure Portal.
  • Kontrollera att du kör den senaste versionen av WSL. För att få den senaste versionen uppdaterar du Windows 10 installation.
  • Kontrollera om det finns öppna problem med WSL som kan lösa problemet. Det finns ofta förslag på hur du kan lösa problemet eller information om en version där problemet kommer att åtgärdas.
  • Om det inte finns några befintliga problem med ditt problem kan du öppna ett nytt problem med WSL och se till att du inkluderar så mycket information som möjligt.

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

Avinstallera

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. Standardplatsen för installation är $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

Nästa steg

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