Instalace Azure CLI v Linuxu

Azure CLI je multiplatformní nástroj příkazového řádku, který je možné nainstalovat místně na počítačích s Linuxem. Pomocí Azure CLI v Linuxu se můžete připojit k Azure a spouštět příkazy pro správu prostředků Azure. Rozhraní příkazového řádku v Linuxu umožňuje spouštění různých příkazů prostřednictvím terminálu pomocí interaktivních příkazového řádku nebo skriptu. Až budete připraveni nainstalovat Azure CLI v Linuxu, doporučujeme použít správce balíčků distribuce Linuxu. Z výše uvedených možností vyberte odpovídajícího správce balíčků pro vaši distribuci. Pokud nemáte jednoho z uvedených správců balíčků, můžete Azure CLI nainstalovat ručně v Linuxu výběrem možnosti Nainstalovat skript .

Aktuální verze Azure CLI je 2.39.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 aktualizaci, spusťte příkaz az version.

Přehled

Správce apt balíčků obsahuje balíček x86_64 pro Azure CLI, který byl testován na následujících distribucích.

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

Upozornění

V starých systémech můžete dál používat historické verze Azure CLI, ale nebudou k dispozici žádné aktualizace ani opravy chyb. Zvažte upgrade na novější verze Ubuntu nebo Debian, abyste mohli použít nejnovější Azure CLI.

Upozornění

Ubuntu 20.04 (Focal Fossa) a 20.10 (Groovy Gorilla) zahrnují azure-cli balíček s verzí 2.0.81 , kterou universe poskytuje úložiště. Tento balíček je zastaralý a nedoporučuje se. Pokud je tento balíček nainstalován, před pokračováním spuštěním příkazu sudo apt remove azure-cli -y && sudo apt autoremove -yodeberte balíček . Viz Správa balíčků Ubuntu nebo požádat Ubuntu o další informace o apt remove.

Balíček azure-cli deb nepodporuje architekturu ARM64.

Možnosti instalace

Azure CLI můžete nainstalovat do systému dvěma způsoby. Nejprve můžete spustit jeden příkaz, který stáhne instalační skript a spustí za vás příkazy instalace. Nebo pokud chcete, můžete příkazy instalace spustit sami v podrobném procesu. Obě metody jsou k dispozici níže.

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

Tým Azure CLI udržuje skript pro spuštění všech instalačních příkazů v jednom kroku. Tento skript se stáhne a curl předá přímo k bash instalaci rozhraní příkazového řádku.

Pokud chcete před spuštěním zkontrolovat obsah skriptu sami, jednoduše ho curl nejprve stáhněte 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 Rozhraní příkazového řádku Azure CLI podle 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:

    curl -sL https://packages.microsoft.com/keys/microsoft.asc |
        gpg --dearmor |
        sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
    
  3. Přidejte úložiště softwaru Azure CLI:
    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. 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

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

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

    apt-cache policy azure-cli
    
  2. Instalace konkrétní verze:

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

Řešení potíží

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 potíže, které tady nejsou uvedené, založte problém na Githubu.

Žádný problém s modulem v Ubuntu 20.04 (místně)/WSL

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

lsb_release nevrací správnou základní distribuční verzi.

Některé distribuce odvozené od Ubuntu nebo Debianu, jako je třeba Linux Mint, nevracejí z lsb_release správný název verze. 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

Někdy může být chvíli po vydání distribuce, než bude k dispozici balíček Azure CLI. Azure CLI navržená tak, aby byla odolná s ohledem na budoucí verze závislostí a spoléhá na co nejméně z nich. Pokud pro základní distribuci není k dispozici žádný balíček, zkuste balíček pro dřívější distribuci.

Uděláte to tak, že při přidávání úložiště nastavíte hodnotu AZ_REPO ručně. Pro distribuce Ubuntu použijte nejnovější jammy úložiště:

AZ_REPO="jammy"

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

AZ_REPO="bullseye"

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é. Budete muset kontaktovat správce systému, abyste věděli, jaké hostitele a porty se mají pro tyto proxy servery používat.

Tyto hodnoty respektují mnoho linuxových programů, včetně těch, které se používají v procesu instalace. 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 souboru .bashrc . 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 použití tohoto proxy serveru vždy. 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 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 problémů:

  • 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 téměř jistě 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 budou k dispozici návrhy, jak problém vyřešit, nebo informace o verzi, ve které bude 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.

Aktualizace

Rozhraní příkazového řádku poskytuje příkaz v nástroji pro aktualizaci na nejnovější verzi:

az upgrade

Poznámka

Příkaz az upgrade byl přidán ve verzi 2.11.0 a nebude fungovat s verzemi staršími než 2.11.0. Starší verze je možné aktualizovat přeinstalací, jak je popsáno v tématu Instalace Azure CLI.

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 o příkazech.

Můžete také použít apt-get upgrade k aktualizaci balíčku rozhraní příkazového řádku.

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

Poznámka

Tento příkaz upgraduje všechny balíčky nainstalované v systému, u kterých nedošlo ke změně závislosti. 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

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 nechcete rozhraní příkazového řádku přeinstalovat, odeberte informace o úložišti Azure CLI:

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

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

    sudo apt autoremove
    

Přehled

Pro linuxové distribuce, dnf jako je RHEL 8 nebo CentOS Stream 8, existují balíčky RPM pro Azure CLI.

Upozornění

Od Azure CLI 2.39.0 (vydané 2. 8. 2022) se pro RHEL 7 a CentOS 7 nevyvolá žádné balíčky RPM. V těchto systémech můžete i nadále používat historické verze Azure CLI, ale nebudou k dispozici žádné aktualizace ani opravy chyb. Zvažte upgrade na novější verze RHEL nebo CentOS, abyste mohli používat nejnovější Azure CLI.

Aktuální verze Azure CLI je 2.39.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 aktualizaci, spusťte příkaz az version.

Důležité

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

Mějte na paměti, že Python 2 dosáhl konce životnosti 1. ledna 2020 a už nebude dostávat aktualizace. Azure CLI od verze 2.1.0ukončila podporu Pythonu 2.7. Nové verze už nezaručuje správné spuštění s Pythonem 2.7.

Poznámka

Správce balíčků použijte yum , pokud používáte systémy Linux, které nepodporují dnf správce balíčků.

Instalace

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

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. 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 výše. 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
    

Řešení potíží

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ý, vytvořte problém na GitHubu.

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

Pokud můžete, 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 instalaci Azure CLI s python 3.6 využitím vytvořeného ze 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 také provést krok za krokem:

Nejprve Azure CLI vyžaduje SSL 1.1+ a před sestavením python3je potřeba sestavovat 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

Potom sestavte Python 3 ze zdroje:

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 kroku 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 nemáte nainstalovaný modul plug-in dnf ke stažení, při spuštění následujícího kódu se zobrazí chyba nenalezena. Slouží dnf install 'dnf-command(download)' k instalaci modulu plug-in dnf ke stažení.

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

Jako alternativu můžete také nainstalovat Python 3 prostřednictvím některého dalšího úložiště. Pokud jste nastavili python3 , ale při pokusu o spuštění rozhraní příkazového řádku se stále zobrazuje chyba python3: command not found , musíte ho přidat do 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é. Budete muset kontaktovat správce systému, abyste věděli, jaké hostitele a porty se mají pro tyto proxy servery používat.

Tyto hodnoty respektují mnoho linuxových programů, včetně těch, které se používají v procesu instalace. 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 souboru .bashrc . 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 použití tohoto proxy serveru vždy. 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 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 problémů:

  • 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 téměř jistě 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 budou k dispozici návrhy, jak problém vyřešit, nebo informace o verzi, ve které bude 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.

Aktualizace

Rozhraní příkazového řádku poskytuje příkaz v nástroji pro aktualizaci na nejnovější verzi:

az upgrade

Poznámka

Příkaz az upgrade byl přidán ve verzi 2.11.0 a nebude fungovat s verzemi staršími než 2.11.0. Starší verze je možné aktualizovat opětovnou instalací, jak je popsáno v části Instalace Azure CLI.

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 odkazem na příkaz.

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

sudo dnf update azure-cli

Odinstalace

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
    

Přehled

RPM jsou vydány pro CBL-Mariner 1.0 a 2.0.

Instalace

Nainstalujte pomocí tdnf install příkazu:

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

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

sudo tdnf update azure-cli

Odinstalace

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

Přehled

Pro linuxové distribuce se správcem zypper, jako je třeba openSUSE nebo SLES, je pro Azure CLI k dispozici balíček. Tento balíček byl testován s openSUSE Leap 15.1 a SLES 15.

Aktuální verze Azure CLI je 2.39.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 az version.

Důležité

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

Mějte na paměti, že Python 2 dosáhl konce životnosti 1. ledna 2020 a už nebude dostávat aktualizace. Azure CLI od verze 2.1.0ukončila podporu Pythonu 2.7. Nové verze už nezaručují správné spuštění s Pythonem 2.7.

Instalace

  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 tím, že ignoruje některé jeho závislosti.

Instalace konkrétní verze

Nejprve je nutné nakonfigurovat azure-cli informace o úložišti, jak je znázorněno výše. Dostupné verze najdete v poznámkách k verzi Azure CLI.

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

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

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

Řešení potíží

Tady jsou některé běžné problémy, ke kterým dochází při instalaci s využitím zypper. Pokud se zde setkáte s problémem, napište problém na GitHubu.

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

Virtuální počítač OpenSUSE 15 má předinstalované Rozhraní příkazového řádku Azure s verzí 2.0.45, je zastaralé a má problémy s az login. Před přidáním nejnovějšího rozhraní příkazového řádku Azure CLI odeberte spolu s jeho závislostmi:

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

Pokud jste aktualizovali Azure CLI bez odebrání závislostí verze 2.0.45, jeho staré závislosti můžou mít vliv na nejnovější verzi Azure CLI. Abyste mohli propojit své závislosti, musíte přidat zpět starou verzi a pak ji odebrat azure-cli společně s jejími 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 na SLES 12 nebo jiných systémech bez Pythonu 3.6

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

Pomocí následujícího příkazu můžete nainstalovat nebo aktualizovat Azure CLI na základě výše uvedených kroků. Skript se 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 spustit následující příkaz pro aktivaci aliasu:

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 v prostředí správně nastavili HTTP_PROXY a HTTPS_PROXY proměnné. Budete muset kontaktovat správce systému, abyste věděli, jaké hostitele a porty se mají pro tyto proxy servery používat.

Tyto hodnoty respektují mnoho linuxových programů, včetně těch, které se používají v procesu instalace. 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) používat tento proxy server vždy. Uděláte to tak, že spustíte yast2 proxy příkaz jako superuživatel a vyplníte informace uvedené 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 okně YaST Control Center.

Pokročilé informace o konfiguraci nebo další informace najdete v dokumentaci ke konfiguraci proxy serveru OpenSUSE.

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ím adresům:

  • 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 instalaci rozhraní příkazového řádku, 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 problémů:

  • Pokud můžete, spusťte na počítači nebo virtuálním počítači s Linuxem stejný proces instalace, abyste zjistili, jestli bude úspěšný. Pokud ano, váš problém se téměř určitě týká 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 všechny otevřené problémy se wsL, které by mohly váš problém vyřešit. Často budou k dispozici návrhy, jak problém obejít, nebo informace o verzi, ve které se problém vyřeší.
  • 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 dál 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 certifikát na počítači poškozený nebo zastaralý, může se zobrazit chyba, která značí, že se nepovedlo ověřit důvěryhodnost 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

Aktualizace

Rozhraní příkazového řádku poskytuje příkaz v nástroji pro aktualizaci na nejnovější verzi:

az upgrade

Poznámka

Příkaz az upgrade byl přidán ve verzi 2.11.0 a nebude fungovat s verzemi staršími než 2.11.0. Starší verze je možné aktualizovat přeinstalací, jak je popsáno v tématu Instalace Azure CLI.

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 o příkazech.

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

sudo zypper refresh
sudo zypper update azure-cli

Odinstalace

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
    

Přehled

Poznámka

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 zahájením ruční instalace se podívejte, jestli je k dispozici balíček pro vaši distribuci.

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

Důležité

Rozhraní příkazového řádku od verze 2.7 ukončilo podporu Pythonu 2.1.02.7 . Nové verze už nezaručuje správné spuštění s Pythonem 2.7.

Instalace nebo aktualizace

Instalace i aktualizace rozhraní příkazového řádku vyžaduje opětovné spuštění instalačního skriptu. Nainstalujte CLI spuštěním příkazu curl.

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

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

Řešení potíží

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ý, vytvořte problém na GitHubu.

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 po dokončení instalace a použití bash nebo zsh nemůžete tento příkaz spustit, vymažte mezipaměť příkazu hash ve vašem prostředí. Spustit

hash -r

a podívejte se, jestli se problém vyřeší.

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é. Budete muset kontaktovat správce systému, abyste věděli, jaké hostitele a porty se mají pro tyto proxy servery používat.

Tyto hodnoty respektují mnoho linuxových programů, včetně těch, které se používají v procesu instalace. 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 souboru .bashrc . 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 problémů:

  • 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 téměř jistě 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 budou k dispozici návrhy, jak problém vyřešit, nebo informace o verzi, ve které bude 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.

Odinstalace

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í umístění instalace je $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

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.