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čuje se použít správce balíčků distribuce Linuxu.

Aktuální verze Azure CLI je 2.84.0. Informace o nejnovější verzi najdete v poznámkách 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.2 (vydaná 21. června 2024) je poslední podporovaná verze na RHEL 7 a Centos 7. Společnost Microsoft už neposkytuje aktualizace ani opravy chyb pro tyto distribuce.

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

Instalace Azure CLI

Chcete-li nainstalovat Azure CLI, postupujte takto:

1. Naimportujte klíč úložiště Microsoftu. Pro RHEL 10 a CentOS Stream 10,

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

   V případě nižších verzí použijte následující příkaz:

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

2. Pro RHEL 10 přidejte packages-microsoft-com-prod úložiště:

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

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

   sudo dnf install -y https://packages.microsoft.com/config/centos/10/packages-microsoft-prod.rpm
   

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

   Upozornění

   Konec životnosti CentOS 7 (EOL) byl 30. června 2024. Informace o podporovaných prostředích Azure CLI najdete v tématu Azure CLI životní cyklus podpory

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 Azure CLI poznámkách k verzi.

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

Počínaje verzí 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. Pro Azure CLI verze starší než 2.11.0 aktualizujte tak, že přeinstalujete podle popisu v Instalujte Azure CLI.

Můžete také aktualizovat Azure CLI příkazem dnf update.

sudo dnf update azure-cli

Odinstalování Azure CLI

Pokud se rozhodnete odinstalovat Azure CLI, je nám líto, že jste na cestách. 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 zajistit, aby Azure CLI bez chyb a uživatelsky přívětivý. Pokud jste našli chybu, oceníme ji, pokud souborujete problém s GitHub.

1. Odeberte balíček ze 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
   

Odstraňte data

Pokud nechcete přeinstalovat Azure CLI, odeberte jeho data.

rm -rf ~/.azure

Řešení problémů

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ý, nahlaste problém na GitHub.

Instalace na RHEL 7.6 nebo jiných systémech bez Python 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 balíček python3 a pak nainstalovat Azure CLI bez závislosti.

Následující příkaz můžete použít ke stažení a instalaci instalačního skriptu Azure CLI pomocí příkazu python 3.6 sestaveného ze zdroje:

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 openssl 1.1 je potřeba sestavit python3 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 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 podle kroků 1 a 2 instalační instrukce přidejte úložiště Azure CLI. Balíček si teď můžete stáhnout a nainstalovat bez závislosti.

Poznámka:

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

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

Alternativou je také instalace Python 3 pomocí oteřové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 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é příkazové řádce správně nastavili proměnné HTTP_PROXY a HTTPS_PROXY. 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ěchto proměnných jsou používány mnoha programy na Linuxu a během 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 shellové proměnné nastaveny pro připojení ke službám Azure pomocí CLI. 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 následující řádky se zobrazí pod sekcí [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 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

CLI nelze nainstalovat ani spustit na Windows Subsystem for Linux

Vzhledem k tomu, že Windows Subsystem for 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é vlastnosti, které mohou obsahovat 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.

cs-CZ: Pro řešení potíží s instalací WSL a případné odstranění 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 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 portálu Azure.
• Ujistěte se, že používáte nejnovější verzi WSL. Pokud chcete získat nejnovější verzi, aktualizovat 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 spouštěním ve WSL, zvažte instalaci rozhraní příkazového řádku pro Windows.

Než začnete

• Azure CLI 2.38.2 (vydaná 21. června 2024) je nejnovější podporovaná verze na SUSE Linux Enterprise Serveru (SLES) a OpenSUSE (Leap). Společnost Microsoft už neposkytuje aktualizace ani opravy chyb pro tyto distribuce.

• 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 Azure Marketplace imagích nainstalované Azure CLI.

Instalace Azure CLI

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ě „Instalační skript (jakýkoli)”.

3. Instalace z úložišť Microsoftu

Instalace z úložišť SUSE nebo OpenSUSE

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

sudo zypper install -y azure-cli

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 údaje 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
   

   Zadejte 2 pro pokračování instalace a ignorování některých jejich 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 Azure CLI poznámkách k verzi.

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

Počínaje verzí 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. Pro Azure CLI verze starší než 2.11.0 aktualizujte tak, že přeinstalujete podle popisu v Instalujte Azure CLI.

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

sudo zypper refresh
sudo zypper update azure-cli

Odinstalujte Azure CLI

Pokud se rozhodnete odinstalovat Azure CLI, je nám líto, že jste na cestách. 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 zajistit, aby Azure CLI bez chyb a uživatelsky přívětivý. Pokud jste našli chybu, oceníme ji, pokud souborujete problém s GitHub.

1. Odeberte balíček ze 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
   

Odstraňte data

Pokud nechcete přeinstalovat Azure CLI, odeberte jeho data.

rm -rf ~/.azure

Řešení problémů

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ý, nahlaste problém na GitHub.

Instalace bez Python 3

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 Python, která předchází požadavku Python 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 ukončila podporu Pythonu 2.7 od verze 2.1.0. Novější verze rozhraní příkazového řádku nemusí správně běžet pomocí Python 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 provedením následujícího příkazu Install odeberte tuto verzi spolu se závislostmi a přidejte nejnovější Azure CLI:

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

Pokud jste aktualizovali Azure CLI bez odebrání závislostí verze 2.0.45, mohou její staré závislosti ovlivnit nejnovější verzi Azure CLI. Abyste propojili závislosti, musíte přidat zpět starou verzi a poté odstranit azure-cli spolu s jeho 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

Instalujte na SLES 12 nebo jiné systémy bez Pythonu 3.6

Na SLES 12 je výchozí balíček python3 3.4 a Azure CLI 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.

Následující příkaz můžete použít k instalaci nebo aktualizaci Azure CLI na základě výše uvedených kroků. Skript nainstaluje Python 3.8 do /usr/local/azcli a Azure CLI ho použije 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 Python verzi 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 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é příkazové řádce správně nastavili proměnné HTTP_PROXY a HTTPS_PROXY. 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ěchto proměnných jsou používány mnoha programy na Linuxu a během 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 shellové proměnné nastaveny pro připojení ke službám Azure pomocí CLI. 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 (přes yast2), aby vždy používal tento proxy server. Aby se tak stalo, spusťte příkaz yast2 proxy jako superuživatel a vyplňte tyto informace zobrazené ve formuláři. Pokud máte ve svém systému k dispozici správce oken, můžete také použít podokno Network Services > Proxy v 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

CLI nelze nainstalovat ani spustit na Windows Subsystem for Linux

Vzhledem k tomu, že Windows Subsystem for 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é vlastnosti, které mohou obsahovat 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.

cs-CZ: Pro řešení potíží s instalací WSL a případné odstranění 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 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 portálu Azure.
• Ujistěte se, že používáte nejnovější verzi WSL. Pokud chcete získat nejnovější verzi, aktualizovat 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 spouš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 balíčků apt obsahuje balíčky x86_64 a ARM64 pro Azure CLI, které byly testovány na následujících distribucích.

  Distribuce	Verze
  Debian	11 (Bullseye), 12 (Bookworm)
  Ubuntu	22.04 (Jammy Jellyfish), 24.04 (Noble Numbat)

Instalace Azure CLI

Existují dvě možnosti instalace Azure CLI do systému. 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 instalace 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 prostřednictvím curl a přímo se zpracuje do bash pro 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 apt-transport-https ca-certificates curl gnupg lsb-release
   

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řidat úložiště softwaru Azure CLI:

   AZ_DIST=$(lsb_release -cs)
   echo "Types: deb
   URIs: https://packages.microsoft.com/repos/azure-cli/
   Suites: ${AZ_DIST}
   Components: main
   Architectures: $(dpkg --print-architecture)
   Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources
   

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 Azure CLI poznámkách k verzi.

1. Zobrazte dostupné verze 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 verzi Azure CLI a název distribuce 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

Počínaje verzí 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. Pro Azure CLI verze starší než 2.11.0 aktualizujte tak, že přeinstalujete podle popisu v Instalujte 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

Odinstalujte Azure CLI

Pokud se rozhodnete odinstalovat Azure CLI, je nám líto, že jste na cestách. 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 zajistit, aby Azure CLI bez chyb a uživatelsky přívětivý. Pokud jste našli chybu, oceníme ji, pokud souborujete problém s GitHub.

1. Odinstalace pomocí apt-get remove:

   sudo apt-get remove -y azure-cli
   

2. Pokud neplánujete znovu instalovat rozhraní příkazového řádku, odeberte informace o úložišti Azure CLI:

   sudo rm /etc/apt/sources.list.d/azure-cli.sources
   

3. Pokud nepoužíváte jiné balíčky od Microsoftu, odeberte podpisový klíč:

   sudo rm /etc/apt/keyrings/microsoft.gpg
   

4. Odeberte všechny nepotřebné balíčky:

   sudo apt autoremove
   

Odstraňte data

Pokud nechcete přeinstalovat Azure CLI, odeberte jeho data.

rm -rf ~/.azure

Řešení problémů

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ý, nahlaste problém na GitHub.

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

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

Někdy není aktualizovaný balíček Azure CLI po vydání verze distribuce okamžitě dostupný. Azure CLI je navržená tak, aby byla odolná vůči budoucím verzím 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.

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

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

Původní obsah souboru:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Upravený obsah souboru

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Proxy 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é příkazové řádce správně nastavili proměnné HTTP_PROXY a HTTPS_PROXY. 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ěchto proměnných jsou používány mnoha programy na Linuxu a během 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 shellové proměnné nastaveny pro připojení ke službám Azure pomocí CLI. 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 souboru apt v /etc/apt/apt.conf.d/. 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:

• manuálová stránka apt.conf
• Wiki Ubuntu – apt-get howto

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.

CLI nelze nainstalovat ani spustit na Windows Subsystem for Linux

Vzhledem k tomu, že Windows Subsystem for 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é vlastnosti, které mohou obsahovat 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.

cs-CZ: Pro řešení potíží s instalací WSL a případné odstranění 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 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 portálu Azure.
• Ujistěte se, že používáte nejnovější verzi WSL. Pokud chcete získat nejnovější verzi, aktualizovat 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 spouštěním ve WSL, zvažte instalaci rozhraní příkazového řádku pro Windows.

Instalace Azure CLI

RPM jsou vydávány pro Azure Linux prostřednictvím CBL-Mariner. Balíček azure-cli podporuje architekturu ARM64 od verze rozhraní příkazového řádku 2.46.0.

Chcete-li 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 Azure CLI poznámkách k verzi.

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 příkazem tdnf update:

sudo tdnf update azure-cli

Odinstalujte Azure CLI

Pokud se rozhodnete odinstalovat Azure CLI, je nám líto, že jste na cestách. 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 zajistit, aby Azure CLI bez chyb a uživatelsky přívětivý. Pokud jste našli chybu, oceníme ji, pokud souborujete problém s GitHub.

Odeberte balíček ze systému:

sudo tdnf remove azure-cli

Odstraňte data

Pokud nechcete přeinstalovat Azure CLI, odeberte jeho data.

rm -rf ~/.azure

Další kroky

Teď, když jste nainstalovali Azure CLI, si projděte jeho funkce a běžné příkazy.

Začněte s Azure CLI