Instalace Azure CLI v Linuxu

Přehled

aptSprávce balíčků obsahuje balíček x86_64 pro rozhraní příkazového řádku Azure CLI, který byl testován v následujících distribucích.

Možnosti instalace

Existují dvě možnosti, jak nainstalovat rozhraní příkazového řádku Azure CLI do systému. Nejdřív můžete spustit jediný příkaz, který stáhne instalační skript a spustí pro vás příkazy pro instalaci. Nebo pokud chcete, můžete spustit instalační příkazy sami v rámci podrobného procesu. Obě metody jsou uvedené 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 přes a přesměruje curl přímo na bash k instalaci rozhraní příkazového řádku.

Pokud chcete před spuštěním zkontrolovat obsah skriptu sami, jednoduše Stáhněte skript nejprve pomocí curl a zkontrolujte jej 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 upřednostňujete podrobný proces instalace, proveďte následující kroky a nainstalujte rozhraní příkazového řádku Azure CLI.

1. Získání balíčků potřebných 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řidat ú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
   

Nainstalovat specifickou verzi

Nejdřív je nutné nakonfigurovat azure-cli informace o úložišti, jak je uvedeno výše. Dostupné verze najdete v poznámkách k verzi Azure CLI.

1. Postup 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 na Ubuntu 20,04 (ohnisko)/WSL

Pokud jste nainstalovali azure-cli aplikaci Focal 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 ' dekoratér ' nebo ' antlr4 ', protože balíček, který jste nainstalovali, je zastaralý azure-cli 2.0.81 z focal/universe úložiště. Odeberte ji nejprve spuštěním sudo apt remove azure-cli -y && sudo apt autoremove -y a pak postupujte podle pokynů uvedených výše a nainstalujte nejnovější azure-cli balíček.

lsb_release nevrátí správnou verzi základní distribuce.

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, na kterou je vaše distribuce odvozená, můžete AZ_REPO hodnotu nastavit ručně při přidávání úložiště. V opačném případě vyhledejte informace pro vaši distribuci, jak určit název základního distribučního kódu a nastavit AZ_REPO na správnou hodnotu.

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

Někdy se může stát, že po uvolnění distribuce ještě předtím, než bude k dispozici balíček Azure CLI. Rozhraní příkazového řádku Azure je navržené tak, aby bylo odolné vůči budoucím verzím závislostí a bylo co nejvíce závislé. Pokud není k dispozici žádný balíček pro základní distribuci, zkuste balíček pro předchozí distribuci.

Pokud to chcete provést, nastavte AZ_REPO při přidávání úložištěhodnotu ručně. Pro Ubuntu distribuce použijte bionic úložiště a pro Debian distribuce použijte stretch . Distribuce vydaná před Ubuntuem trustu a Debian Wheezy nejsou podporovány.

Základní operační systém (EOS): Nepodařilo se nainstalovat rozhraní příkazového řádku Azure CLI.

EOS nemůže nainstalovat rozhraní příkazového řádku Azure lsb_release , protože 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 proměnné a HTTP_PROXY HTTPS_PROXY . Budete se muset obrátit na správce systému a vědět, jaké hostitele a porty pro tyto porty použít.

Tyto hodnoty respektuje řada 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]

Je také možné, že budete chtít explicitně nakonfigurovat apt na používání tohoto proxy serveru. Ujistěte se, že se v konfiguračním souboru v nástroji vyskytují následující řádky apt /etc/apt/apt.conf.d/ . Doporučujeme použít buď existující globální konfigurační soubor, existující konfigurační soubor proxy serveru, 40proxies nebo 99local , ale postupovat podle požadavků 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, přečtěte si oficiální dokumentaci k Ubuntu:

• apt. conf Manpage
• Ubuntu wiki – apt – získat postupy

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

• https://packages.microsoft.com

rozhraní příkazového řádku se nepodařilo 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 Windowsou platformou, může při pokusu o instalaci nebo spuštění rozhraní příkazového řádku Azure dojít k chybě. Rozhraní CLI spoléhá na některé funkce, které mohou mít chybu v WSL. Pokud dojde k chybě bez ohledu na způsob instalace rozhraní příkazového řádku, je velmi pravděpodobné, že se jedná o problém s WSL, a ne s procesem instalace CLI.

Řešení potíží s instalací WSL a možné problémy vyřešit:

• Pokud je to možné, spusťte na počítači se systémem Linux nebo na virtuálním počítači identický proces instalace, abyste viděli, zda bylo úspěšné. Pokud k tomu dojde, váš problém je téměř jistě v souvislosti s WSL. Pokud chcete spustit virtuální počítač se systémem Linux v Azure, přečtěte si článek Vytvoření virtuálního počítače se systémem Linux v dokumentaci k 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.
• Vyhledejte všechny otevřené problémy s WSL, které by mohly vyřešit váš problém. Často se budou zobrazovat návrhy, jak tento problém obejít, nebo informace o vydání, kde bude problém vyřešen.
• Pokud se problém nevyřeší, zaznamenejte si Nový problém s WSL a ujistěte se, že jste zahrnuli co nejvíce informací.

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

Aktualizace

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

az upgrade

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

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

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 neplánujete rozhraní příkazového řádku znovu nainstalovat, 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

U distribucí pro Linux, jako je dnf RHEL, Fedora nebo CentOS, je k dispozici balíček pro rozhraní příkazového řádku Azure CLI. Tento balíček byl testován pomocí RHEL 7,7, RHEL 8, Fedora 24 a vyšší, CentOS 7 a CentOS 8.

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

Instalace

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

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

2. Vytvořte informace místního úložiště azure-cli.

   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
   

Nainstalovat specifickou verzi

Nejdřív je nutné nakonfigurovat azure-cli informace o úložišti, jak je uvedeno výše. Dostupné verze najdete v poznámkách k verzi Azure CLI.

1. Postup 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 se setkáte s problémem, který zde není popsaný, zapište problém na GitHub.

Instalace na RHEL 7,6 nebo jiné systémy bez Pythonu 3

Pokud můžete, upgradujte systém na verzi s oficiální podporou python 3.6+ balíčku. V opačném případě je třeba nejprve nainstalovat python3 balíček a pak nainstalovat rozhraní příkazového řádku Azure CLI bez závislosti.

K instalaci rozhraní příkazového řádku Azure pomocí python 3.6 sestavené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 provést také krok za krokem:

Nejdřív Azure CLI vyžaduje SSL 1.1+ a před sestavením musíte vytvořit openssl 1.1 ze zdroje 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

Pak vytvořte 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 kroků 1 a 2 pokynů k instalaci a přidejte úložiště CLI Azure. Balíček si teď můžete stáhnout a nainstalovat bez závislosti.

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

Alternativně můžete Python 3 nainstalovat také pomocí nějakého dalšího úložiště. Tímto způsobem, pokud jste nastavili, python3 ale python3: command not found při pokusu o spuštění CLI stále dochází k chybě, je potřeba ho přidat do své 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 proměnné a HTTP_PROXY HTTPS_PROXY . Budete se muset obrátit na správce systému a vědět, jaké hostitele a porty pro tyto porty použít.

Tyto hodnoty respektuje řada 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]

Je také možné, že budete chtít explicitně nakonfigurovat dnf na používání tohoto proxy serveru. Ujistěte se, že se v části okna zobrazují následující řádky [main] /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í proxy umožňovat připojení HTTPS k následující adrese:

• https://packages.microsoft.com

rozhraní příkazového řádku se nepodařilo 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 Windowsou platformou, může při pokusu o instalaci nebo spuštění rozhraní příkazového řádku Azure dojít k chybě. Rozhraní CLI spoléhá na některé funkce, které mohou mít chybu v WSL. Pokud dojde k chybě bez ohledu na způsob instalace rozhraní příkazového řádku, je velmi pravděpodobné, že se jedná o problém s WSL, a ne s procesem instalace CLI.

Řešení potíží s instalací WSL a možné problémy vyřešit:

• Pokud je to možné, spusťte na počítači se systémem Linux nebo na virtuálním počítači identický proces instalace, abyste viděli, zda bylo úspěšné. Pokud k tomu dojde, váš problém je téměř jistě v souvislosti s WSL. Pokud chcete spustit virtuální počítač se systémem Linux v Azure, přečtěte si článek Vytvoření virtuálního počítače se systémem Linux v dokumentaci k 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.
• Vyhledejte všechny otevřené problémy s WSL, které by mohly vyřešit váš problém. Často se budou zobrazovat návrhy, jak tento problém obejít, nebo informace o vydání, kde bude problém vyřešen.
• Pokud se problém nevyřeší, zaznamenejte si Nový problém s WSL a ujistěte se, že jste zahrnuli co nejvíce informací.

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

Aktualizace

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

az upgrade

Pomocí příkazu můžete také aktualizovat rozhraní příkazového řádku Azure dnf update .

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é jiné balíčky společnosti Microsoft, 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

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.30.0. Informace o nejnovější verzi najdete v tématu Poznámky k verzi. Pokud chcete zjistit nainstalovanou verzi a zjistit, jestli potřebujete aktualizaci, spusťte příkaz az version.

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í instalace ignorováním některých jeho závislostí.

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 nastane problém, který tu není probýzen, zakašte problém na GitHub.

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í , je zastaralé a 2.0.45 má problémy s az login . Před přidáním nejnovější verze Azure CLI postupujte podle pokynů k instalaci a odeberte ho společně s jeho závislostmi:

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

Pokud jste aktualizovali Azure CLI bez odebrání závislostí verze , mohly by její staré závislosti ovlivnit 2.0.45 nejnovější verzi Azure CLI. Je potřeba přidat zpět starou verzi, abyste propojují její závislosti, a pak 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é systémy bez Pythonu 3.6

Na SLES 12 je výchozí balíček a Azure python3 3.4 CLI ho nepodporuje. Nejprve můžete postupovat podle kroku 1 až 3 pokynů k instalaci a přidat azure-cli úložiště. Pak ze zdroje sestavte python3 vyšší verzi. 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 se nainstaluje v Python 3.8 rámci a /usr/local/azcli nastaví alias az na . PATH=/usr/local/azcli/bin:$PATH az Můžete si také stáhnout skript a upravit ho 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

Nezapomeňte spustit následující příkaz pro aktivaci aliasu při první instalaci:

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 proměnné a HTTP_PROXY HTTPS_PROXY . Budete se muset obrátit na správce systému a vědět, jaké hostitele a porty pro tyto porty použít.

Tyto hodnoty respektuje řada 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]

Můžete také explicitně nakonfigurovat zypper (prostřednictvím yast2 ) tak, aby se tento proxy server mohl používat za všech okolností. Pokud to chcete udělat, yast2 proxy spusťte příkaz jako superuživatel a vyplňte informace uvedené ve formuláři. Pokud máte v systému k dispozici správce oken, můžete také použít Network Services > Proxy podokno v . YaST Control Center

Pokročilou 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řilo 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 Windowsou platformou, může při pokusu o instalaci nebo spuštění rozhraní příkazového řádku Azure dojít k chybě. Rozhraní CLI spoléhá na některé funkce, které mohou mít chybu v WSL. Pokud dojde k chybě bez ohledu na způsob instalace rozhraní příkazového řádku, je velmi pravděpodobné, že se jedná o problém s WSL, a ne s procesem instalace CLI.

Řešení potíží s instalací WSL a možné problémy vyřešit:

• Pokud je to možné, spusťte na počítači se systémem Linux nebo na virtuálním počítači identický proces instalace, abyste viděli, zda bylo úspěšné. Pokud k tomu dojde, váš problém je téměř jistě v souvislosti s WSL. Pokud chcete spustit virtuální počítač se systémem Linux v Azure, přečtěte si článek Vytvoření virtuálního počítače se systémem Linux v dokumentaci k 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.
• Vyhledejte všechny otevřené problémy s WSL, které by mohly vyřešit váš problém. Často se budou zobrazovat návrhy, jak tento problém obejít, nebo informace o vydání, kde bude problém vyřešen.
• Pokud se problém nevyřeší, zaznamenejte si Nový problém s WSL a ujistěte se, že jste zahrnuli co nejvíce informací.

Pokud budete mít nadále problémy s instalací nebo spouštěním na 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 oznamující, že službě Curl se nepodařilo ověřit legitimitu serveru, a proto nebylo možné navázat zabezpečené připojení. Aktualizujte certifikát a problém opravte.

sudo zypper update-ca-certificates

Aktualizace

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

az upgrade

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 jiné balíčky Microsoftu používat nechcete, 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

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

• Python 3.6. x, 3.7. x nebo 3.8. x.
• libffi
• OpenSSL 1.0.2

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 se setkáte s problémem, který zde není popsaný, zapište problém na GitHub.

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 proměnné a HTTP_PROXY HTTPS_PROXY . Budete se muset obrátit na správce systému a vědět, jaké hostitele a porty pro tyto porty použít.

Tyto hodnoty respektuje řada 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]

Aby bylo možné získat instalační skripty, musí proxy umožňovat 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ů distribuce (pokud existují) pro základní balíčky

rozhraní příkazového řádku se nepodařilo 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 Windowsou platformou, může při pokusu o instalaci nebo spuštění rozhraní příkazového řádku Azure dojít k chybě. Rozhraní CLI spoléhá na některé funkce, které mohou mít chybu v WSL. Pokud dojde k chybě bez ohledu na způsob instalace rozhraní příkazového řádku, je velmi pravděpodobné, že se jedná o problém s WSL, a ne s procesem instalace CLI.

Řešení potíží s instalací WSL a možné problémy vyřešit:

• Pokud je to možné, spusťte na počítači se systémem Linux nebo na virtuálním počítači identický proces instalace, abyste viděli, zda bylo úspěšné. Pokud k tomu dojde, váš problém je téměř jistě v souvislosti s WSL. Pokud chcete spustit virtuální počítač se systémem Linux v Azure, přečtěte si článek Vytvoření virtuálního počítače se systémem Linux v dokumentaci k 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.
• Vyhledejte všechny otevřené problémy s WSL, které by mohly vyřešit váš problém. Často se budou zobrazovat návrhy, jak tento problém obejít, nebo informace o vydání, kde bude problém vyřešen.
• Pokud se problém nevyřeší, zaznamenejte si Nový problém s WSL a ujistěte se, že jste zahrnuli co nejvíce informací.

Pokud budete mít nadále problémy s instalací nebo spouštěním na 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