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. CLI på Linux tillåter körning av olika kommandon via en terminal med hjälp av interaktiva kommandotolks eller ett skript. När du är redo att installera Azure CLI på Linux rekommenderar vi att du använder en Linux-distributions pakethanterare. Välj lämplig pakethanterare för distributionen från alternativen ovan. Om du inte har någon av de listade pakethanterade pakethanterare kan du installera Azure CLI manuellt på Linux genom att välja alternativet Installera skript .

Den aktuella versionen av Azure CLI är 2.40.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.

Översikt

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

Distribution Version
Ubuntu 18.04 LTS (Bionic Beaver), 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish)
Debian 10 (Buster), 11 (Bullseye)

Varning

Du kan fortsätta att använda historiska versioner av Azure CLI på gamla system, men det kommer inte att finnas några uppdateringar eller felkorrigeringar. Överväg att uppgradera till nyare versioner av Ubuntu eller Debian för att använda den senaste Versionen av Azure CLI.

Varning

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. Se Ubuntu-pakethantering eller fråga ubuntu för mer information om apt remove.

Deb-paketet azure-cli stöder inte ARM64-arkitektur.

Installationsalternativ

Det finns två alternativ för att installera Azure CLI i systemet. 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 anges 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 bash installera CLI.

Om du vill granska innehållet i skriptet själv innan du kör det laddar du helt enkelt ned skriptet först med curl och inspekterar det i valfri textredigerare.

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

Alternativ 2: Stegvisa installationsinstruktioner

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 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 information om lagringsplatsen och installera paketet azure-cli :

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

Installera specifik version

Du måste först konfigurera azure-cli lagringsplatsinformation enligt ovan. Tillgängliga versioner finns i Viktig information om 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.

Inga 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 först bort det genom att köra sudo apt remove azure-cli -y && sudo apt autoremove -yoch 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 AZ_REPO härleds från kan du ange värdet manuellt när du lägger till lagringsplatsen. I annat fall letar du upp information för distributionen om hur du fastställer namnet på basdistributionskoden och anger AZ_REPO rätt värde.

Inget paket för distributionen

Ibland kan det ta ett tag efter att en distribution har släppts innan det finns ett Azure CLI-paket tillgängligt för den. 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 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 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 Debian-distributioner använder du den senaste bullseye lagringsplatsen:

AZ_REPO="bullseye"

Distributioner som släppts 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.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 HTTP_PROXY och HTTPS_PROXY korrekt i gränssnittet. Du måste kontakta systemadministratören för att veta vilka värdar och portar som ska användas för dessa proxyservrar.

Dessa värden respekteras av många Linux-program, inklusive de som används i 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 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å 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 antingen din befintliga globala konfigurationsfil, en befintlig proxykonfigurationsfil, 40proxieseller 99local, men följer systemadministrationskraven.

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 fortfarande har problem med att installera eller köra på WSL bör du överväga att installera CLI för Windows.

Uppdatera

CLI tillhandahåller ett kommando i verktyget för att uppdatera till den senaste versionen:

az upgrade

Anteckning

Kommandot az upgrade lades till i version 2.11.0 och fungerar inte med versioner före 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 az upgrade alternativ 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 onödiga paket:

    sudo apt autoremove
    

Översikt

För Linux-distributioner med dnf till exempel RHEL 8 eller CentOS Stream 8 finns det RPM-paket för Azure CLI.

Varning

Från och med Azure CLI 2.39.0 (släpptes den 2022-08-02) släpps inga RPM-paket för RHEL 7 och CentOS 7. Du kan fortsätta att använda historiska versioner av Azure CLI på dessa system, men det kommer inte att finnas några uppdateringar eller felkorrigeringar. Överväg att uppgradera till nyare versioner av RHEL eller CentOS för att använda den senaste Versionen av Azure CLI.

Den aktuella versionen av Azure CLI är 2.40.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.

Viktigt

RPM-paketet för Azure CLI är beroende av paketet python3 . I systemet kan detta vara en Python-version som föregår kravet för 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 sin livslängd den 1 januari 2020 och inte längre tar emot uppdateringar. Azure CLI har tagit bort stödet 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. För RHEL 9 eller CentOS Stream 9 lägger du till packages-microsoft-com-prod lagringsplats:

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

    För RHEL 8 eller CentOS Stream 8 lägger du till packages-microsoft-com-prod lagringsplats:

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

    För RHEL 7 eller CentOS 7 lägger du till 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 specifik version

Du måste först konfigurera azure-cli lagringsplatsinformation enligt ovan. 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
    

Felsökning

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

Installera på RHEL 7.6 eller andra system utan Python 3

Om du kan kan du 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 installera Azure CLI med python 3.6 byggt 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.

Anteckning

Om du inte har dnf-nedladdningsplugin-programmet installerat får du felmeddelandet kommandot hittades inte vid körningen av koden nedan. Använd dnf install 'dnf-command(download)' för att installera dnf download-plugin-programmet.

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

Alternativt kan du även installera Python 3 via ytterligare en lagringsplats. Om du har konfigurerat python3 men fortfarande får ett felmeddelande python3: command not found när du försöker köra cli måste du lägga till det i 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 HTTP_PROXY och HTTPS_PROXY korrekt i gränssnittet. Du måste kontakta systemadministratören för att veta vilka värdar och portar som ska användas för dessa proxyservrar.

Dessa värden respekteras av många Linux-program, inklusive de som används i 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 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å vill konfigurera dnf att använda den här proxyn hela tiden. Kontrollera att följande rader visas under [main] avsnittet 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 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 fortfarande har problem med att installera eller köra på WSL bör du överväga att installera CLI för Windows.

Uppdatera

CLI tillhandahåller ett kommando i verktyget för att uppdatera till den senaste versionen:

az upgrade

Anteckning

Kommandot az upgrade lades till i version 2.11.0 och fungerar inte med versioner före 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 az upgrade alternativ 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

RPM släpps för CBL-Mariner 1.0 och 2.0.

Installera

Installera med tdnf install kommandot :

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

Uppdatera Azure CLI med tdnf update kommandot :

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

Ta bort paketet från systemet:

sudo tdnf remove azure-cli

Ö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.40.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.

Viktigt

RPM-paketet för Azure CLI är beroende av paketet python3 . I systemet kan detta vara en Python-version som föregår kravet för 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 sin livslängd den 1 januari 2020 och inte längre tar emot uppdateringar. Azure CLI har tagit bort stödet 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 vissa av dess beroenden.

Installera specifik version

Du måste först konfigurera azure-cli lagringsplatsinformation enligt ovan. Tillgängliga versioner finns i Viktig information om 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 stöter på ett problem som inte beskrivs här kan du skapa ett ärende på GitHub.

NotImplementedError på en virtuell OpenSUSE 15-dator

Den virtuella OpenSUSE 15-datorn har en förinstallerad Azure CLI med version 2.0.45, den ä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 versionen 2.0.45kan 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 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 3.4 standardpaketet python3 inte 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 /usr/local/azcli och gör att Azure CLI använder det genom att ange aliaset az 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 proxyserver kontrollerar du att du har angett variablerna HTTP_PROXY och HTTPS_PROXY korrekt i gränssnittet. Du måste kontakta systemadministratören för att veta vilka värdar och portar som ska användas för dessa proxyservrar.

Dessa värden respekteras av många Linux-program, inklusive de som används i 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 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 fönsterhanterare tillgänglig i systemet kan du också använda fönstret Network Services > Proxy i YaST Control Center.

Mer information om avancerad konfiguration finns i konfigurationsdokumentationen för 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 fortfarande har problem med att installera eller köra på WSL bör du överväga att installera CLI för Windows.

Problem med SSL-certifikat

När ett certifikat har brutits eller är 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

Uppdatera

CLI tillhandahåller ett kommando i verktyget för att uppdatera till den senaste versionen:

az upgrade

Anteckning

Kommandot az upgrade lades till i version 2.11.0 och fungerar inte med versioner före 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. az upgrade Fler alternativ 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ödet 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 upplever ett problem som inte beskrivs här kan du skapa ett problem på 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 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.

Dessa värden respekteras av många Linux-program, inklusive de som används i 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 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 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 sådana finns) 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 nästan säkert 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. Om du vill hämta den senaste versionen uppdaterar du din Windows 10 installation.
  • Sök efter eventuella öppna problem med WSL som kan åtgärda problemet. Ofta kommer det att finnas förslag på hur du kan kringgå problemet eller information om en version där problemet kommer att åtgärdas.
  • 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 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.