Instalace Azure CLI v Linuxu

Tento článek vysvětluje, jak nainstalovat Azure CLI v Linuxu. V horní části stránky vyberte odpovídajícího správce balíčků pro vaši distribuci. Doporučujeme použít správce balíčků distribuce Linuxu, ale azure CLI můžete nainstalovat ručně v Linuxu výběrem možnosti Instalovat skript .

Aktuální verze Azure CLI je 2.57.0. Informace o nejnovější verzi najdete v tématu Poznámky k verzi. Pokud chcete najít nainstalovanou verzi a zjistit, jestli potřebujete aktualizovat, spusťte příkaz az version.

Než začnete

  • Azure CLI 2.38.1 (vydaná 1. září 2023) je nejnovější podporovaná verze na RHEL 7 a Centos 7 a Bude dál dostávat opravy zabezpečení až do konce životnosti operačních systémů. Microsoft neposkytuje pro tyto distribuce další aktualizace ani opravy chyb.

  • Microsoft nadále vyvíjí a podporuje Azure CLI a instalační skript pro Linux.

  • yum Pokud používáte linuxový systém, který správce balíčků nepodporujednf, použijte správce balíčků.

Instalace rozhraní příkazového řádku Azure

Pokud chcete nainstalovat Azure CLI, postupujte takto:

  1. Naimportujte klíč úložiště Microsoftu.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. Pro RHEL 9 nebo CentOS Stream 9 přidejte packages-microsoft-com-prod úložiště:

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

    Pro RHEL 8 nebo CentOS Stream 8 přidejte packages-microsoft-com-prod úložiště:

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

    Pro RHEL 7 nebo CentOS 7 přidejte azure-cli úložiště:

    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. K instalaci použijte příkaz dnf install.

    sudo dnf install azure-cli
    

Instalace konkrétní verze

Nejprve musíte nakonfigurovat azure-cli informace o úložišti, jak je znázorněno dříve. Dostupné verze najdete v poznámkách k verzi Azure CLI.

  1. Zobrazení dostupných verzí pomocí příkazu:

    dnf list --showduplicates azure-cli
    
  2. Instalace konkrétní verze:

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

Aktualizace Azure CLI

Od verze 2.11.0 poskytuje Azure CLI příkaz v nástroji pro aktualizaci na nejnovější verzi.

az upgrade

Tento příkaz také ve výchozím nastavení aktualizuje všechna nainstalovaná rozšíření. Další az upgrade možnosti najdete na stránce s referenčními informacemi k příkazům. V případě verzí Azure CLI starších než 2.11.0 proveďte aktualizaci opětovnou instalací, jak je popsáno v části Instalace Azure CLI.

Azure CLI můžete také aktualizovat pomocí dnf update příkazu.

sudo dnf update azure-cli

Odinstalace Azure CLI

Pokud se rozhodnete odinstalovat Azure CLI, bude nám líto, že odcházíte. Před odinstalací použijte příkaz az feedback a dejte nám vědět, co můžeme zlepšit nebo opravit. Naším cílem je, aby rozhraní příkazového řádku Azure bylo bezchybné a uživatelsky přívětivé. Pokud jste narazili na chybu, uvítáme, když založíte problém na GitHubu.

  1. Odeberte balíček z vašeho systému.

    sudo dnf remove azure-cli
    
  2. Pokud neplánujete rozhraní příkazového řádku znovu nainstalovat, odeberte informace o úložišti.

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. Pokud nepoužíváte žádné další balíčky Microsoftu, odeberte podpisový klíč.

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

Odebrání dat

Pokud nemáte v úmyslu přeinstalovat Azure CLI, odeberte jeho data.

rm -rf ~/.azure

Řešení problému

Tady jsou některé běžné problémy, ke kterým dochází při instalaci s využitím dnf. Pokud narazíte na problém, který tady není popsaný, zapište problém na GitHubu.

Instalace na RHEL 7.6 nebo jiných systémech bez Pythonu 3

Pokud máte možnost, upgradujte systém na verzi s oficiální podporou python 3.6+ balíčku. Jinak musíte nejprve nainstalovat python3 balíček a pak nainstalovat Azure CLI bez závislosti.

K stažení a instalaci instalačního skriptu Azure CLI s python 3.6 využitím vytvořeného zdroje můžete použít následující příkaz:

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

Můžete to udělat také krok za krokem:

Nejprve Azure CLI vyžaduje SSL 1.1+ a před sestavením python3je potřeba sestavit openssl 1.1 ze zdroje:

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

Pak ze zdroje sestavte Python 3:

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

Nakonec postupujte podle kroků 1 a 2 pokynů k instalaci a přidejte úložiště Azure CLI. Balíček si teď můžete stáhnout a nainstalovat bez závislosti.

Poznámka:

Pokud modul plug-in dnf ke stažení ještě není nainstalovaný, při spuštění následujícího kódu dojde command not found k chybě. Slouží dnf install 'dnf-command(download)' k instalaci modulu plug-in pro stahování dnf.

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

Jako alternativu můžete python 3 nainstalovat také pomocí jiného úložiště. Tuto metodu použijte, pokud jste nastavili python3 , ale stále dochází k chybě python3: command not found. Ujistěte se, že je součástí vaší cesty.

scl enable rh-python36 bash

Proxy server blokuje připojení

Pokud se kvůli proxy serveru nemůžete připojit k externímu prostředku, ujistěte se, že jste ve svém prostředí správně nastavili HTTP_PROXY proměnné a HTTPS_PROXY proměnné. Musíte se obrátit na správce systému, abyste věděli, jaké hostitele a porty se mají pro tyto proxy servery používat.

Hodnoty v těchtoproměnných Nastavení těchto hodnot:

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

Důležité

Pokud se nacházíte za proxy serverem, musí být tyto proměnné prostředí nastavené pro připojení ke službám Azure pomocí rozhraní příkazového řádku. Pokud nepoužíváte základní ověřování, doporučujeme tyto proměnné exportovat do .bashrc souboru. Vždy dodržujte zásady zabezpečení vaší firmy a požadavky správce systému.

Můžete také chtít explicitně nakonfigurovat dnf , aby vždy používal tento proxy server. Ujistěte se, že v [main] části /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

Aby bylo možné získat podpisový klíč Microsoftu a balíček z našeho úložiště, musí váš proxy server povolit připojení HTTPS k následující adrese:

  • https://packages.microsoft.com

Rozhraní příkazového řádku se nepodaří nainstalovat nebo spustit na Subsystém Windows pro Linux

Vzhledem k tomu, že Subsystém Windows pro Linux (WSL) je vrstva překladu volání systému nad platformou Windows, může dojít k chybě při pokusu o instalaci nebo spuštění Azure CLI. Rozhraní příkazového řádku spoléhá na některé funkce, které můžou mít chybu ve WSL. Pokud dojde k chybě bez ohledu na to, jak rozhraní příkazového řádku instalujete, existuje dobrá šance, že se jedná o problém s WSL, a ne s procesem instalace rozhraní příkazového řádku.

Řešení potíží s instalací WSL a případnou řešením potíží:

  • Pokud je to možné, spusťte na počítači nebo virtuálním počítači s Linuxem stejný proces instalace, abyste zjistili, jestli je úspěšný. Pokud ano, váš problém pravděpodobně souvisí s WSL. Pokud chcete spustit virtuální počítač s Linuxem v Azure, přečtěte si dokumentaci k vytvoření virtuálního počítače s Linuxem na webu Azure Portal .
  • Ujistěte se, že používáte nejnovější verzi WSL. Pokud chcete získat nejnovější verzi, aktualizujte instalaci Windows 10.
  • Zkontrolujte případné otevřené problémy se službou WSL, které by mohly váš problém vyřešit. Často existují návrhy, jak problém obejít, nebo informace o verzi, ve které je problém opravený.
  • Pokud pro váš problém neexistují žádné problémy, vytvořte nový problém s WSL a ujistěte se, že zahrnete co nejvíce informací.

Pokud máte i nadále problémy s instalací nebo spuštěním ve WSL, zvažte instalaci rozhraní příkazového řádku pro Windows.

Než začnete

  • Azure CLI 2.38.1 (vydané 1. září 2023) je nejnovější podporovaná verze pro SUSE Linux Enterprise Server (SLES) a OpenSUSE (Leap) a bude dál dostávat opravy zabezpečení až do konce června 2024. Microsoft neposkytuje pro tyto distribuce další aktualizace ani opravy chyb.

  • Microsoft nadále vyvíjí a podporuje Azure CLI a instalační skript pro Linux. SUSE udržuje a podporuje balíčky poskytované úložišti SUSE/OpenSUSE.

  • V Azure už mají virtuální počítače SUSE a OpenSUSE založené na imagích Azure Marketplace nainstalované Rozhraní příkazového řádku Azure CLI.

Instalace rozhraní příkazového řádku Azure

Pokud chcete nainstalovat Azure CLI na SUSE/OpenSUSE, zvolte jednu z následujících metod:

  1. Použijte balíček Enterprise poskytovaný SUSE v úložištích SUSE/OpenSUSE.

  2. Použijte metodu instalace popsanou na kartě Install script (any).

  3. Instalace z úložišť Microsoftu

Instalace z úložišť SUSE nebo OpenSUSE

Balíček RPM azure CLI závisí na python3 balíčku.

sudo zypper install -y azure-cli

Instalace pomocí instalačního skriptu

Azure CLI můžete ručně nainstalovat na libovolnou verzi Linuxu pomocí možnosti Instalovat skript .

Pokud aktualizujete na nejnovější verzi pomocí této metody, nezapomeňte nejprve odinstalovat předchozí verzi a všechna úložiště, která jste pro tuto verzi přidali.

Instalace z úložišť Microsoftu

Pokud chcete nainstalovat nejnovější historickou verzi Azure CLI pomocí úložišť Microsoftu, postupujte takto.

(Tento balíček byl testován s využitím SLES 15 a OpenSUSE Leap 15.1)

  1. Nainstalujte curl:

    sudo zypper install -y curl
    
  2. Naimportujte klíč úložiště Microsoftu:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  3. Vytvořte informace místního úložiště azure-cli:

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
    
  4. Aktualizujte index balíčku zypper a instalujte:

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

    Vstup 2 pro pokračování v instalaci ignorováním některých jeho závislostí.

Instalace konkrétní verze

Nejprve musíte nakonfigurovat azure-cli informace o úložišti, jak je znázorněno dříve. Dostupné verze najdete v poznámkách k verzi Azure CLI.

  1. K zobrazení dostupných verzí použijte tento příkaz:

    zypper search --details --match-exact azure-cli
    
  2. Instalace konkrétní verze:

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

Aktualizace Azure CLI

Od verze 2.11.0 poskytuje Azure CLI příkaz v nástroji pro aktualizaci na nejnovější verzi.

az upgrade

Tento příkaz také ve výchozím nastavení aktualizuje všechna nainstalovaná rozšíření. Další az upgrade možnosti najdete na stránce s referenčními informacemi k příkazům. V případě verzí Azure CLI starších než 2.11.0 proveďte aktualizaci opětovnou instalací, jak je popsáno v části Instalace Azure CLI.

Balíček můžete také aktualizovat pomocí zypper update příkazu.

sudo zypper refresh
sudo zypper update azure-cli

Odinstalace Azure CLI

Pokud se rozhodnete odinstalovat Azure CLI, bude nám líto, že odcházíte. Před odinstalací použijte příkaz az feedback a dejte nám vědět, co můžeme zlepšit nebo opravit. Naším cílem je, aby rozhraní příkazového řádku Azure bylo bezchybné a uživatelsky přívětivé. Pokud jste narazili na chybu, uvítáme, když založíte problém na GitHubu.

  1. Odeberte balíček z vašeho systému.

    sudo zypper remove -y azure-cli
    
  2. Pokud neplánujete rozhraní příkazového řádku znovu nainstalovat, odeberte informace o úložišti.

    sudo zypper removerepo azure-cli
    
  3. Pokud nepoužíváte jiné balíčky Microsoftu, odeberte podpisový klíč Microsoftu.

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

Odebrání dat

Pokud nemáte v úmyslu přeinstalovat Azure CLI, odeberte jeho data.

rm -rf ~/.azure

Řešení problému

Tady jsou některé běžné problémy, ke kterým dochází při instalaci s využitím zypper. Pokud narazíte na problém, který tady není popsaný, zapište problém na GitHubu.

Instalace bez Pythonu 3

Důležité

Balíček RPM azure CLI závisí na python3 balíčku. Ve vašem systému to může být verze Pythonu, která předchází požadavku Pythonu 3.6.x. Pokud vás to ovlivní, vyhledejte náhradní python3 balíček.

Mějte na paměti, že Python 2 dosáhl konce životnosti (EOL) 1. ledna 2020 a už nebude dostávat aktualizace. Azure CLI od verze 2.1.0 ukončila podporu Pythonu 2.7. Novější verze rozhraní příkazového řádku nemusí správně běžet pomocí Pythonu 2.7.

NotImplementedError na virtuálním počítači OpenSUSE 15

Virtuální počítač OpenSUSE 15 má předinstalované Azure CLI s verzí 2.0.45, která je zastaralá a má problémy s az login. Před přidáním nejnovější verze Azure CLI odeberte tuto verzi spolu se závislostmi před provedením pokynů k instalaci :

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

Pokud jste aktualizovali Azure CLI bez odebrání závislostí verze 2.0.45, můžou její staré závislosti ovlivnit nejnovější verzi Azure CLI. Abyste mohli propojit jeho závislosti, musíte přidat zpět starou verzi a pak ji odebrat azure-cli společně se závislostmi:

# 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

Instalace do SLES 12 nebo jiných systémů bez Pythonu 3.6

Na SLES 12 je výchozí python3 balíček 3.4 a Azure CLI ho nepodporuje. Nejprve můžete postupovat podle kroku 1 až 3 instrukce instalace a přidat azure-cli úložiště. Potom ze zdroje vytvořte vyšší verzi python3 . Nakonec si můžete stáhnout balíček Azure CLI a nainstalovat ho bez závislosti.

K instalaci nebo aktualizaci Azure CLI na základě výše uvedených kroků můžete použít následující příkaz. Skript nainstaluje Python 3.8 v rámci /usr/local/azcli Azure CLI a použije ho nastavením aliasu az na PATH=/usr/local/azcli/bin:$PATH az. Skript si také můžete stáhnout a upravit podle svých potřeb. Můžete například změnit verzi Pythonu nebo umístění instalace.

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

Při první instalaci nezapomeňte spuštěním následujícího příkazu aktivovat alias:

source ~/.bashrc

Proxy server blokuje připojení

Pokud se kvůli proxy serveru nemůžete připojit k externímu prostředku, ujistěte se, že jste ve svém prostředí správně nastavili HTTP_PROXY proměnné a HTTPS_PROXY proměnné. Musíte se obrátit na správce systému, abyste věděli, jaké hostitele a porty se mají pro tyto proxy servery používat.

Hodnoty v těchtoproměnných Nastavení těchto hodnot:

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

Důležité

Pokud se nacházíte za proxy serverem, musí být tyto proměnné prostředí nastavené pro připojení ke službám Azure pomocí rozhraní příkazového řádku. Pokud nepoužíváte základní ověřování, doporučujeme tyto proměnné exportovat do .bashrc souboru. Vždy dodržujte zásady zabezpečení vaší firmy a požadavky správce systému.

Můžete také chtít explicitně nakonfigurovat zypper (prostřednictvím yast2) vždy používat tento proxy server. Uděláte to tak, že příkaz spustíte yast2 proxy jako superuživatele a vyplníte informace zobrazené ve formuláři. Pokud máte ve svém systému k dispozici správce oken, můžete také použít Network Services > Proxy podokno v podokně YaST Control Center.

Další informace o pokročilé konfiguraci najdete v dokumentaci ke konfiguraci proxy serveru OpenSUSE.

Pokud chcete získat podpisový klíč Microsoftu a získat balíček z našeho úložiště, musí váš proxy server povolit připojení HTTPS na následující adresy:

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

Rozhraní příkazového řádku se nepodaří nainstalovat nebo spustit na Subsystém Windows pro Linux

Vzhledem k tomu, že Subsystém Windows pro Linux (WSL) je vrstva překladu volání systému nad platformou Windows, může dojít k chybě při pokusu o instalaci nebo spuštění Azure CLI. Rozhraní příkazového řádku spoléhá na některé funkce, které můžou mít chybu ve WSL. Pokud dojde k chybě bez ohledu na to, jak rozhraní příkazového řádku instalujete, existuje dobrá šance, že se jedná o problém s WSL, a ne s procesem instalace rozhraní příkazového řádku.

Řešení potíží s instalací WSL a případnou řešením potíží:

  • Pokud je to možné, spusťte na počítači nebo virtuálním počítači s Linuxem stejný proces instalace, abyste zjistili, jestli je úspěšný. Pokud ano, váš problém pravděpodobně souvisí s WSL. Pokud chcete spustit virtuální počítač s Linuxem v Azure, přečtěte si dokumentaci k vytvoření virtuálního počítače s Linuxem na webu Azure Portal .
  • Ujistěte se, že používáte nejnovější verzi WSL. Pokud chcete získat nejnovější verzi, aktualizujte instalaci Windows 10.
  • Zkontrolujte případné otevřené problémy se službou WSL, které by mohly váš problém vyřešit. Často existují návrhy, jak problém obejít, nebo informace o verzi, ve které je problém opravený.
  • Pokud pro váš problém neexistují žádné problémy, vytvořte nový problém s WSL a ujistěte se, že zahrnete co nejvíce informací.

Pokud máte i nadále problémy s instalací nebo spuštěním ve WSL, zvažte instalaci rozhraní příkazového řádku pro Windows.

Problém s certifikátem SSL

Pokud je na počítači poškozený nebo zastaralý certifikát, může se zobrazit chyba, která značí, že se nepovedlo ověřit oprávněnost serveru, a proto se nepodařilo navázat zabezpečené připojení. Aktualizujte certifikát, aby se problém opravil.

sudo zypper update-ca-certificates

Než začnete

  • Správce apt balíčků obsahuje balíčky x86_64 a ARM64 pro Azure CLI, které byly testovány na následujících distribucích.

    Distribuce Verze
    Ubuntu 20.04 LTS (Fokální fossa), 22.04 (Jammy Jellyfish)
    Debian 10 (Buster), 11 (Bullseye), 12 (Bookworm)
  • Ubuntu 20.04 (Focal Fossa) a 20.10 (Groovy Gorilla) obsahují azure-cli balíček s verzí 2.0.81 poskytovanou úložištěm universe . Tento balíček je zastaralý a nedoporučuje se. Pokud je tento balíček nainstalován, odeberte balíček před pokračováním spuštěním příkazu sudo apt remove azure-cli -y && sudo apt autoremove -y. Další informace o apt removesprávěbalíčků Ubuntu nebo se zeptejte ubuntu.

Instalace rozhraní příkazového řádku Azure

V systému můžete nainstalovat Azure CLI dvěma způsoby. Můžete si stáhnout instalační skript, který spustí instalační příkazy za vás, nebo můžete spustit instalační příkazy sami v podrobném procesu. Obě metody jsou k dispozici zde:

Možnost 1: Instalace pomocí jednoho příkazu

Nejjednodušší způsob, jak nainstalovat Azure CLI, je prostřednictvím skriptu spravovaného týmem Azure CLI. Tento skript spustí všechny instalační příkazy v jednom kroku. Tento skript se stáhne a curl předá přímo k bash instalaci rozhraní příkazového řádku.

Pokud si chcete před spuštěním prohlédnout obsah skriptu sami, stáhněte si nejprve skript pomocí curl a prohlédněte si ho ve svém oblíbeném textovém editoru.

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

Možnost 2: Podrobné pokyny k instalaci

Pokud dáváte přednost podrobnému procesu instalace, nainstalujte Azure CLI provedením následujících kroků.

  1. Získejte balíčky potřebné pro proces instalace:

    sudo apt-get update
    sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. Stáhněte a nainstalujte podpisový klíč Microsoftu:

    sudo mkdir -p /etc/apt/keyrings
    curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
        gpg --dearmor |
        sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null
    sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
    
  3. Přidejte úložiště softwaru Azure CLI:
    AZ_DIST=$(lsb_release -cs)
    echo "deb [arch=`dpkg --print-architecture` signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/azure-cli/ $AZ_DIST main" |
        sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. Aktualizujte informace o úložišti a nainstalujte azure-cli balíček:

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

Instalace konkrétní verze

Nakonfigurujte informace o azure-cli úložišti, jak je znázorněno dříve. Dostupné verze najdete v poznámkách k verzi Azure CLI.

  1. Zobrazení dostupných verzí Azure CLI

    apt-cache policy azure-cli
    
  2. Nainstalujte konkrétní verzi.

    # 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
    

    Pokud chcete nainstalovat konkrétní verzi bez proměnných, nahraďte uvedený název distribuce Azure CLI a Linuxu:

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

Pokud se zobrazí chybová zpráva Nepodařilo se najít balíček azure-cli, informace o azure-cli úložišti nejsou nakonfigurovány. Postupujte podle kroků uvedených v možnosti 2: Podrobné pokyny k instalaci.

Pokud se zobrazí chybová zpráva Verze x.xx.x-1~distributionName pro azure-cli nebyla nalezena, použijte lsb_release -cs k vyhledání spuštěné distribuce.

Aktualizace Azure CLI

Od verze 2.11.0 poskytuje Azure CLI příkaz v nástroji pro aktualizaci na nejnovější verzi.

az upgrade

Tento příkaz také ve výchozím nastavení aktualizuje všechna nainstalovaná rozšíření. Další az upgrade možnosti najdete na stránce s referenčními informacemi k příkazům. V případě verzí Azure CLI starších než 2.11.0 proveďte aktualizaci opětovnou instalací, jak je popsáno v části Instalace Azure CLI.

Můžete také použít apt-get upgrade k aktualizaci balíčku rozhraní příkazového řádku. Tento příkaz upgraduje všechny nainstalované balíčky ve vašem systému, které neměly změnu závislostí.

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

Pokud chcete upgradovat jenom rozhraní příkazového řádku, použijte apt-get install.

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

Odinstalace Azure CLI

Pokud se rozhodnete odinstalovat Azure CLI, bude nám líto, že odcházíte. Před odinstalací použijte příkaz az feedback a dejte nám vědět, co můžeme zlepšit nebo opravit. Naším cílem je, aby rozhraní příkazového řádku Azure bylo bezchybné a uživatelsky přívětivé. Pokud jste narazili na chybu, uvítáme, když založíte problém na GitHubu.

  1. Odinstalace pomocí apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Pokud neplánujete přeinstalovat rozhraní příkazového řádku, odeberte informace o úložišti Azure CLI:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Pokud nepoužíváte jiné balíčky od Microsoftu, odeberte podpisový klíč:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg
    
  4. Odeberte všechny nepotřebné balíčky:

    sudo apt autoremove
    

Odebrání dat

Pokud nemáte v úmyslu přeinstalovat Azure CLI, odeberte jeho data.

rm -rf ~/.azure

Řešení problému

Tady jsou některé běžné problémy, ke kterým dochází při instalaci s využitím apt. Pokud narazíte na problém, který tady není popsaný, zapište problém na GitHubu.

Balíček azure-cli podporuje architekturu ARM64 z rozhraní příkazového řádku verze 2.46.0.

Žádný problém s modulem na Ubuntu 20.04 (centrální)/WSL

Pokud jste nainstalovali azure-cliFocal bez přidání softwarového úložiště Azure CLI v kroku 3 pokynů k ruční instalaci nebo pomocí našeho skriptu, můžete narazit na problémy, jako je například žádný modul s názvem dekorátor nebo antlr4, protože balíček, který jste nainstalovali, je azure-cli 2.0.81 zastaralý z focal/universe úložiště. Nejprve ho odeberte spuštěním sudo apt remove azure-cli -y && sudo apt autoremove -ya pak podle výše uvedených pokynů nainstalujte nejnovější azure-cli balíček.

lsb_release nevrací správnou základní verzi distribuce.

Některé distribuce odvozené od Debianu (například Linux Mint) nemusí vrátit správný název verze z lsb_release. Tato hodnota se používá v procesu instalace pro určení balíčku k instalaci. Pokud znáte název kódu verze Ubuntu nebo Debian, ze které je vaše distribuce odvozena, můžete hodnotu nastavit AZ_REPO ručně při přidávání úložiště. V opačném případě vyhledejte informace o tom, jak určit název základního distribučního kódu a nastavit AZ_REPO správnou hodnotu.

Žádný balíček pro vaši distribuci

V některých případech není aktualizovaný balíček Azure CLI okamžitě k dispozici po vydání verze distribuce. Rozhraní příkazového řádku Azure je navržené tak, aby bylo odolné vůči budoucím verzím závislostí a spoléhá na ně co nejvíce. Pokud pro základní distribuci není k dispozici žádný balíček, zkuste balíček pro dřívější distribuci.

Pokud chcete vyzkoušet balíček pro dřívější distribuci, nastavte hodnotu AZ_REPO ručně při přidávání úložiště. Pro distribuce Ubuntu použijte nejnovější jammy úložiště:

AZ_REPO="jammy"

Pro distribuce Debianu použijte nejnovější bookworm úložiště:

AZ_REPO="bookworm"

Důležité

Distribuce vydané před Ubuntu Bionic a Debian Buster nejsou podporovány.

Základní operační systém (EOS) se nepodaří nainstalovat Azure CLI

EOS se nepovede nainstalovat Azure CLI, protože lsb_release se vrátí HERA, což je název verze EOS. Řešením je opravit soubor /etc/apt/sources.list.d/azure-cli.list a změnit hera main na bionic main.

Původní obsah souboru:

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

Upravený obsah souboru

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

Proxy server blokuje připojení

Pokud se kvůli proxy serveru nemůžete připojit k externímu prostředku, ujistěte se, že jste ve svém prostředí správně nastavili HTTP_PROXY proměnné a HTTPS_PROXY proměnné. Musíte se obrátit na správce systému, abyste věděli, jaké hostitele a porty se mají pro tyto proxy servery používat.

Hodnoty v těchtoproměnných Nastavení těchto hodnot:

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

Důležité

Pokud se nacházíte za proxy serverem, musí být tyto proměnné prostředí nastavené pro připojení ke službám Azure pomocí rozhraní příkazového řádku. Pokud nepoužíváte základní ověřování, doporučujeme tyto proměnné exportovat do .bashrc souboru. Vždy dodržujte zásady zabezpečení vaší firmy a požadavky správce systému.

Můžete také chtít explicitně nakonfigurovat apt , aby vždy používal tento proxy server. Ujistěte se, že následující řádky se zobrazí v konfiguračním apt souboru v /etc/apt/apt.conf.d/souboru . Doporučujeme použít buď existující globální konfigurační soubor, existující konfigurační soubor proxy serveru, 40proxiesnebo 99local, ale dodržovat požadavky na správu systému.

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

Pokud váš proxy server nepoužívá základní ověřování, odeberte[username]:[password]@ část identifikátoru URI proxy serveru. Pokud potřebujete další informace o konfiguraci proxy serveru, projděte si oficiální dokumentaci k Ubuntu:

Aby bylo možné získat podpisový klíč Microsoftu a získat balíček z našeho úložiště, musí váš proxy server povolit připojení HTTPS k následující adrese:https://packages.microsoft.com.

Rozhraní příkazového řádku se nepodaří nainstalovat nebo spustit na Subsystém Windows pro Linux

Vzhledem k tomu, že Subsystém Windows pro Linux (WSL) je vrstva překladu volání systému nad platformou Windows, může dojít k chybě při pokusu o instalaci nebo spuštění Azure CLI. Rozhraní příkazového řádku spoléhá na některé funkce, které můžou mít chybu ve WSL. Pokud dojde k chybě bez ohledu na to, jak rozhraní příkazového řádku instalujete, existuje dobrá šance, že se jedná o problém s WSL, a ne s procesem instalace rozhraní příkazového řádku.

Řešení potíží s instalací WSL a případnou řešením potíží:

  • Pokud je to možné, spusťte na počítači nebo virtuálním počítači s Linuxem stejný proces instalace, abyste zjistili, jestli je úspěšný. Pokud ano, váš problém pravděpodobně souvisí s WSL. Pokud chcete spustit virtuální počítač s Linuxem v Azure, přečtěte si dokumentaci k vytvoření virtuálního počítače s Linuxem na webu Azure Portal .
  • Ujistěte se, že používáte nejnovější verzi WSL. Pokud chcete získat nejnovější verzi, aktualizujte instalaci Windows 10.
  • Zkontrolujte případné otevřené problémy se službou WSL, které by mohly váš problém vyřešit. Často existují návrhy, jak problém obejít, nebo informace o verzi, ve které je problém opravený.
  • Pokud pro váš problém neexistují žádné problémy, vytvořte nový problém s WSL a ujistěte se, že zahrnete co nejvíce informací.

Pokud máte i nadále problémy s instalací nebo spuštěním ve WSL, zvažte instalaci rozhraní příkazového řádku pro Windows.

Instalace rozhraní příkazového řádku Azure

RpM se vydávají pro Azure Linux prostřednictvím CBL-Mariner. Balíček azure-cli podporuje architekturu ARM64 z rozhraní příkazového řádku verze 2.46.0.

Pokud chcete nainstalovat Azure CLI, postupujte takto:

  1. Nainstalujte oficiální kurátorovaný sadu důvěryhodných kořenových certifikátů Microsoftu:

    sudo tdnf install ca-certificates
    
  2. Instalace Azure CLI:

    sudo tdnf install azure-cli
    

Instalace konkrétní verze

Dostupné verze najdete v poznámkách k verzi Azure CLI.

Zobrazení dostupných verzí pomocí příkazu:

tdnf list azure-cli

Instalace konkrétní verze:

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

Aktualizace Azure CLI

Aktualizujte Azure CLI pomocí tdnf update příkazu:

sudo tdnf update azure-cli

Odinstalace Azure CLI

Pokud se rozhodnete odinstalovat Azure CLI, bude nám líto, že odcházíte. Před odinstalací použijte příkaz az feedback a dejte nám vědět, co můžeme zlepšit nebo opravit. Naším cílem je, aby rozhraní příkazového řádku Azure bylo bezchybné a uživatelsky přívětivé. Pokud jste narazili na chybu, uvítáme, když založíte problém na GitHubu.

Odeberte balíček ze systému:

sudo tdnf remove azure-cli

Odebrání dat

Pokud nemáte v úmyslu přeinstalovat Azure CLI, odeberte jeho data.

rm -rf ~/.azure

Než začnete

Důrazně doporučujeme k instalaci rozhraní příkazového řádku použít správce balíčků. Správce balíčků zajišťuje, že vždycky získáte nejnovější aktualizace a zaručuje stabilitu komponent rozhraní příkazového řádku. Před ruční instalací zkontrolujte a zkontrolujte, jestli pro vaši distribuci existuje balíček.

Rozhraní příkazového řádku vyžaduje následující software:

Instalace nebo aktualizace Azure CLI

Instalace i aktualizace Azure CLI vyžaduje opětovné spuštění instalačního skriptu.

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

Tento skript se také dá stáhnout a spustit místně. Možná budete muset restartovat prostředí, aby se změny projevily.

Odinstalace Azure CLI

Pokud se rozhodnete odinstalovat Azure CLI, bude nám líto, že odcházíte. Před odinstalací použijte příkaz az feedback a dejte nám vědět, co můžeme zlepšit nebo opravit. Naším cílem je, aby rozhraní příkazového řádku Azure bylo bezchybné a uživatelsky přívětivé. Pokud jste narazili na chybu, uvítáme, když založíte problém na GitHubu.

Rozhraní příkazového řádku můžete odinstalovat přímým odstraněním souborů z umístění zvolené při instalaci. Výchozím umístěním instalace je domovský adresář uživatele ($HOME).

  1. Odeberte nainstalované soubory rozhraní příkazového řádku.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. Upravte soubor $HOME/.bash_profile pro odebrání následujícího řádku:

    <install location>/lib/azure-cli/az.completion
    
  3. Při použití bash nebo zsh znovu načtěte mezipaměť příkazů prostředí.

    hash -r
    

Odebrání dat

Pokud nemáte v úmyslu přeinstalovat Azure CLI, odeberte jeho data.

rm -rf ~/.azure

Řešení problému

Toto jsou některé běžné problémy, které se vyskytují během ruční instalace. Pokud narazíte na problém, který tady není popsaný, zapište problém na GitHubu.

Instalace bez Pythonu 3

Azure CLI ukončila podporu Pythonu 2.7 od verze 2.1.0. Ve vašem systému může existovat verze Pythonu, která předchází požadavku Pythonu 3.6.x. Vyhledejte náhradní python3 balíček.

curl – chyba Object Moved (Objekt byl přesunut)

Pokud se curl zobrazí chybu související s parametrem -L nebo chybovou zprávu obsahující text „Object Moved“ (Objekt byl přesunut), zkuste místo přesměrování aka.ms použít úplnou adresu URL:

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

Příkaz az se nenašel

Pokud příkaz po instalaci nejde spustit nebo bashzshzkuste vymazat mezipaměť hash příkazů prostředí a zkontrolujte, jestli se problém nevyřeší.

hash -r

K tomuto problému může také dojít, pokud jste po instalaci nerestartovali vaše prostředí. Ověřte, že umístění příkazu az je v $PATH. Umístění příkazu az je

 <install path>/bin

Proxy server blokuje připojení

Pokud se kvůli proxy serveru nemůžete připojit k externímu prostředku, ujistěte se, že jste ve svém prostředí správně nastavili HTTP_PROXY proměnné a HTTPS_PROXY proměnné. Musíte se obrátit na správce systému, abyste věděli, jaké hostitele a porty se mají pro tyto proxy servery používat.

Hodnoty v těchtoproměnných Nastavení těchto hodnot:

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

Důležité

Pokud se nacházíte za proxy serverem, musí být tyto proměnné prostředí nastavené pro připojení ke službám Azure pomocí rozhraní příkazového řádku. Pokud nepoužíváte základní ověřování, doporučujeme tyto proměnné exportovat do .bashrc souboru. Vždy dodržujte zásady zabezpečení vaší firmy a požadavky správce systému.

Aby bylo možné získat instalační skripty, musí proxy server povolit připojení HTTPS k následujícím adresám:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Koncové body používané správcem balíčků vaší distribuce (pokud existuje) pro základní balíčky

Rozhraní příkazového řádku se nepodaří nainstalovat nebo spustit na Subsystém Windows pro Linux

Vzhledem k tomu, že Subsystém Windows pro Linux (WSL) je vrstva překladu volání systému nad platformou Windows, může dojít k chybě při pokusu o instalaci nebo spuštění Azure CLI. Rozhraní příkazového řádku spoléhá na některé funkce, které můžou mít chybu ve WSL. Pokud dojde k chybě bez ohledu na to, jak rozhraní příkazového řádku instalujete, existuje dobrá šance, že se jedná o problém s WSL, a ne s procesem instalace rozhraní příkazového řádku.

Řešení potíží s instalací WSL a případnou řešením potíží:

  • Pokud je to možné, spusťte na počítači nebo virtuálním počítači s Linuxem stejný proces instalace, abyste zjistili, jestli je úspěšný. Pokud ano, váš problém pravděpodobně souvisí s WSL. Pokud chcete spustit virtuální počítač s Linuxem v Azure, přečtěte si dokumentaci k vytvoření virtuálního počítače s Linuxem na webu Azure Portal .
  • Ujistěte se, že používáte nejnovější verzi WSL. Pokud chcete získat nejnovější verzi, aktualizujte instalaci Windows 10.
  • Zkontrolujte případné otevřené problémy se službou WSL, které by mohly váš problém vyřešit. Často existují návrhy, jak problém obejít, nebo informace o verzi, ve které je problém opravený.
  • Pokud pro váš problém neexistují žádné problémy, vytvořte nový problém s WSL a ujistěte se, že zahrnete co nejvíce informací.

Pokud máte i nadále problémy s instalací nebo spuštěním ve WSL, zvažte instalaci rozhraní příkazového řádku pro Windows.

Další kroky

Teď máte rozhraní Azure CLI nainstalované a můžete si v krátkosti projít jeho funkce a běžné příkazy.