Instalace Azure CLI pomocí aptInstall Azure CLI with apt

Pokud používáte distribuci, která se dodává s apt, jako je Ubuntu nebo Debian, je k x86_64 balíček pro Azure CLI k dispozici.If you are running a distribution that comes with apt, such as Ubuntu or Debian, there's an x86_64 package available for the Azure CLI. Tento balíček prošel testováním s využitím a platí pro:This package has been tested with and is supported for:

  • Ubuntu trusty, xenial, artful, bionic a discoUbuntu trusty, xenial, artful, bionic, and disco
  • Debian wheezy, jessie a stretchDebian wheezy, jessie, and stretch

Aktuální verze rozhraní příkazového řádku je 2.0.67.The current version of the CLI is 2.0.67. Informace o nejnovější verzi najdete v tématu Poznámky k verzi.For information about the latest release, see the release notes. Pokud chcete zjistit nainstalovanou verzi a najdete v Pokud je potřeba aktualizovat, spustit az --version.To find your installed version and see if you need to update, run az --version.

Poznámka

Balíček pro rozhraní příkazového řádku Azure nainstaluje vlastní překladač Pythonu a nepoužívá systém Python.The package for Azure CLI installs its own Python interpreter, and does not use the system Python.

InstalaceInstall

Nabízíme dva způsoby, jak nainstalovat Azure CLI s distribucích podporujících apt: Jako skriptu All-in-one, který spouští příkazy instalace pro vás a pokyny, které můžete spouštět jako podrobný postup sami.We offer two ways to install the Azure CLI with distributions that support apt: As an all-in-one script that runs the install commands for you, and instructions that you can run as a step-by-step process on your own.

Instalace pomocí jednoho příkazuInstall with one command

Nabízíme a udržovat skript, který spustí všechny příkazy instalace v jednom kroku.We offer and maintain a script which runs all of the installation commands in one step. Spustit s použitím curl a přímo do kanálu bash, nebo tento skript stáhnout do souboru a zkontrolovat před spuštěním.Run it by using curl and pipe directly to bash, or download the script to a file and inspect it before running.

Důležité

Tento skript je jenom ověřit pro Ubuntu 16.04 + a Debian 8 +.This script is only verified for Ubuntu 16.04+ and Debian 8+. Nemusí fungovat na jiné distribuce.It may not work on other distributions. Pokud používáte odvozené distribuce například Linux Mint, postupujte podle pokynů pro ruční instalaci a proveďte všechny nezbytné řešení potíží.If you're using a derived distribution such as Linux Mint, follow the manual install instructions and perform any necessary troubleshooting.

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

Postup ruční instalaceManual install instructions

Pokud nechcete, aby ke spuštění skriptu jako superuživatele, postupujte podle těchto kroků ruční instalace rozhraní příkazového řádku Azure.If you don't want to run a script as superuser, follow these manual steps to install the Azure CLI.

  1. Získání balíčků, které jsou pro proces instalace:Get packages needed for the install process:

    sudo apt-get update
    sudo apt-get install curl apt-transport-https lsb-release gnupg
    
  2. Stáhněte a nainstalujte Microsoft podpisový klíč:Download and install the Microsoft signing key:

    curl -sL https://packages.microsoft.com/keys/microsoft.asc | \
        gpg --dearmor | \
        sudo tee /etc/apt/trusted.gpg.d/microsoft.asc.gpg > /dev/null
    
  3. Přidání úložiště softwarových rozhraní příkazového řádku Azure:Add the Azure CLI software repository:
    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íčku:Update repository information and install the azure-cli package:

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

Ke spuštění Azure CLI využijte příkaz az.Run the Azure CLI with the az command. Chcete-li přihlásit, použijte az login příkazu.To sign in, use the az login command.

  1. Spusťte příkaz login.Run the login command.

    az login
    

    Pokud rozhraní příkazového řádku může spustit výchozí prohlížeč, udělá to a načte přihlašovací stránku.If the CLI can open your default browser, it will do so and load a sign-in page.

    V opačném případě musíte otevřít stránku prohlížeče a postupovat podle pokynů v příkazovém řádku. Po přechodu na https://aka.ms/devicelogin v prohlížeči zadejte autorizační kód.Otherwise, you need to open a browser page and follow the instructions on the command line to enter an authorization code after navigating to https://aka.ms/devicelogin in your browser.

  2. Přihlaste se pomocí přihlašovacích údajů vašeho účtu v prohlížeči.Sign in with your account credentials in the browser.

Další informace o různých metodách ověřování najdete v tématu Přihlášení pomocí Azure CLI.To learn more about different authentication methods, see Sign in with Azure CLI.

Řešení potížíTroubleshooting

Tady jsou některé běžné problémy, ke kterým dochází při instalaci s využitím apt.Here are some common problems seen when installing with apt. Pokud narazíte na potíže, které tady nejsou uvedené, založte problém na Githubu.If you experience a problem not covered here, file an issue on github.

lsb_release nevrátí verze správné základní distribucelsb_release does not return the correct base distribution version

Některé distribuce odvozené od Ubuntu nebo Debianu, jako je třeba Linux Mint, nevracejí z lsb_release správný název verze.Some Ubuntu- or Debian-derived distributions such as Linux Mint may not return the correct version name from lsb_release. Tato hodnota se používá v procesu instalace pro určení balíčku k instalaci.This value is used in the install process to determine the package to install. Pokud znáte název kódu vaší distribuci pochází z verze Ubuntu nebo Debian, můžete nastavit AZ_REPO hodnotu ručně při přidání úložiště.If you know the code name of the Ubuntu or Debian version your distribution is derived from, you can set the AZ_REPO value manually when adding the repository. V opačném případě vyhledání informací pro vaši distribuci o tom, jak určit název kódu základní distribuce a nastavte AZ_REPO na správnou hodnotu.Otherwise, look up information for your distribution on how to determine the base distribution code name and set AZ_REPO to the correct value.

Žádný balíček pro vaši distribuciNo package for your distribution

V některých případech může být nějakou dobu po distribuci vydání předtím, než je k dispozici pro něj balíček rozhraní příkazového řádku Azure.Sometimes it may be a while after a distribution is released before there's an Azure CLI package available for it. Rozhraní příkazového řádku Azure má odolné proti chybám s ohledem na budoucí verze závislosti a Spolehněte se na jako málo z nich nejvíce.The Azure CLI designed to be resilient with regards to future versions of dependencies and rely on as few of them as possible. Pokud není k dispozici pro vaši distribuci základní žádný balíček, zkuste balíček pro starší distribuce.If there's no package available for your base distribution, try a package for an earlier distribution.

Chcete-li to provést, nastavte hodnotu AZ_REPO ručně, pokud přidání úložiště.To do this, set the value of AZ_REPO manually when adding the repository. Pro Ubuntu pomocí rozdělení bionic úložiště, a použijte distribuce Debian stretch.For Ubuntu distributions use the bionic repository, and for Debian distributions use stretch. Distribuce vydané před Ubuntu Trusty a Debian Wheezy nejsou podporovány.Distributions released before Ubuntu Trusty and Debian Wheezy are not supported.

Blokuje připojení proxy serverProxy blocks connection

Pokud nemůžete se připojit k externí prostředku z důvodu proxy server, ujistěte se, že jste správně nastavili HTTP_PROXY a HTTPS_PROXY proměnné v prostředí.If you're unable to connect to an external resource due to a proxy, make sure that you've correctly set the HTTP_PROXY and HTTPS_PROXY variables in your shell. Je potřeba obraťte se na správce systému, aby vědět, co hostitele a porty pro tyto servery proxy.You will need to contact your system administrator to know what host(s) and port(s) to use for these proxies.

Tyto hodnoty budou dodržovat i v mnoha aplikacích systému Linux, včetně těch, které se používají v procesu instalace.These values are respected by many Linux programs, including those which are used in the install process. Chcete-li nastavit tyto hodnoty:To set these values:

# 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 jste za proxy serverem, tyto proměnné prostředí musí být nastavena pro připojení ke službám Azure pomocí rozhraní příkazového řádku.If you are behind a proxy, these shell variables must be set to connect to Azure services with the CLI. Pokud nepoužíváte základního ověřování, doporučujeme pro export tyto proměnné ve vaší .bashrc souboru.If you are not using basic auth, it's recommended to export these variables in your .bashrc file. Vždy postupujte podle zásad zabezpečení pro vaši firmu a požadavky na správce systému.Always follow your business' security policies and the requirements of your system administrator.

Můžete také explicitně nakonfigurovat apt vůbec používat tento proxy server vyprší.You may also want to explicitly configure apt to use this proxy at all times. Ujistěte se, že tyto řádky se zobrazí v apt konfiguračním souboru v /etc/apt/apt.conf.d/.Make sure that the following lines appear in an apt configuration file in /etc/apt/apt.conf.d/. Doporučujeme použít buď existující globální konfiguračním souboru, existující konfigurační soubor proxy, 40proxies, nebo 99local, ale podle svých požadavků na systém pro správu.We recommend using either your existing global configuration file, an existing proxy configuration file, 40proxies, or 99local, but follow your system administration requirements.

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í, odebrat [username]:[password]@ část identifikátor URI proxy serveru.If your proxy does not use basic auth, remove the [username]:[password]@ portion of the proxy URI. Pokud potřebujete další informace o konfiguraci proxy serveru, najdete v oficiální dokumentaci k Ubuntu:If you require more information for proxy configuration, see the official Ubuntu documentation:

Pokud chcete získat klíč podpisu společnosti Microsoft a získat balíček z našeho úložiště, váš proxy server je potřeba povolit připojení prostřednictvím protokolu HTTPS na adresu:In order to get the Microsoft signing key and get the package from our repository, your proxy needs to allow HTTPS connections to the following address:

  • https://packages.microsoft.com

Rozhraní příkazového řádku se nepodaří nainstalovat nebo spustit v subsystému Windows pro LinuxCLI fails to install or run on Windows Subsystem for Linux

Protože subsystém Windows pro Linux (WSL) je vrstva překlad volání systému založené na platformě Windows, může dojít k chybě při pokusu o instalaci nebo spuštění rozhraní příkazového řádku Azure.Since Windows Subsystem for Linux (WSL) is a system call translation layer on top of the Windows platform, you might experience an error when trying to install or run the Azure CLI. Rozhraní příkazového řádku se spoléhá na několik funkcí, které mohou mít chybu ve WSL.The CLI relies on some features that may have a bug in WSL. Pokud dochází k chybě bez ohledu na to, jak nainstalovat rozhraní příkazového řádku, je velmi pravděpodobné, protože představuje problém s WSL a nikoli se procesu instalace rozhraní příkazového řádku.If you experience an error no matter how you install the CLI, there's a good chance it's an issue with WSL and not with the CLI install process.

Řešení potíží s vaší instalací WSL a případně vyřešit problémy:To troubleshoot your WSL installation and possibly resolve issues:

  • Pokud je to možné, spusťte na počítači s Linuxem nebo virtuální počítač a zjistěte, jestli bude úspěšný identické instalační proces.If you can, run an identical install process on a Linux machine or VM to see if it succeeds. Pokud ano, vaše potíže téměř jistě související s WSL.If it does, your issue is almost certainly related to WSL. Spustit virtuální počítač s Linuxem v Azure, najdete v článku vytvoření virtuálního počítače s Linuxem na webu Azure Portal dokumentaci.To start a Linux VM in Azure, see the create a Linux VM in the Azure Portal documentation.
  • Ujistěte se, že používáte nejnovější verzi WSL.Make sure that you're running the latest version of WSL. Chcete-li získat nejnovější verzi aktualizovat instalaci Windows 10.To get the latest version, update your Windows 10 installation.
  • Vyhledat všechny hlásit problémy s WSL, která může vyřešit váš problém.Check for any open issues with WSL which might address your problem. Často bude návrhy k tomu, jak vyřešit problém nebo informace o vydané verzi Pokud bude problém vyřešen.Often there will be suggestions on how to work around the problem, or information about a release where the issue will be fixed.
  • Pokud zde nejsou žádné existující problémy na váš problém souboru nového problému s WSL a ujistěte se, že složku zahrnujete co nejvíce informací.If there are no existing issues for your problem, file a new issue with WSL and make sure that you include as much information as possible.

Pokud budete mít problémy při instalaci nebo spuštění ve WSL, zvažte instalace rozhraní příkazového řádku pro Windows.If you continue to have issues installing or running on WSL, consider installing the CLI for Windows.

AktualizaceUpdate

K aktualizaci balíčku CLI použijte apt-get upgrade.Use apt-get upgrade to update the CLI package.

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.This command upgrades all of the installed packages on your system that have not had a dependency change. Pokud chcete upgradovat jenom rozhraní příkazového řádku, použijte apt-get install.To upgrade the CLI only, use apt-get install.

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

OdinstalaceUninstall

Pokud se rozhodnete odinstalovat Azure CLI, bude nám líto, že odcházíte.If you decide to uninstall the Azure CLI, we're sorry to see you go. Před odinstalací použijte příkaz az feedback a dejte nám vědět, co můžeme zlepšit nebo opravit.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. Naším cílem je, aby rozhraní příkazového řádku Azure bylo bezchybné a uživatelsky přívětivé.Our goal is to make the Azure CLI bug-free and user-friendly. Pokud jste narazili na chybu, uvítáme, když založíte problém na GitHubu.If you found a bug, we'd appreciate it if you file a GitHub issue.

  1. Odinstalace pomocí apt-get remove:Uninstall with apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Pokud nemáte v úmyslu znovu nainstalovat rozhraní příkazového řádku, odeberte informace o úložišti Azure CLI:If you don't plan to reinstall the CLI, remove the Azure CLI repository information:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Odebrání podpisový klíč:Remove the signing key:

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

    sudo apt autoremove
    

Další krokyNext Steps

Teď máte rozhraní Azure CLI nainstalované a můžete si v krátkosti projít jeho funkce a běžné příkazy.Now that you've installed the Azure CLI, take a short tour of its features and common commands.