Ruční instalace Azure CLI pro LinuxInstall Azure CLI on Linux manually

Pokud pro rozhraní příkazového řádku Azure pro vaši distribuce neexistuje žádný balíček, nainstalujte rozhraní příkazového řádku ručně spuštěním skriptu.If there's no package for the Azure CLI for you your distribution, install the CLI manually by running a script.

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

Důrazně doporučujeme k instalaci rozhraní příkazového řádku použít správce balíčků.It's strongly recommend to install the CLI with a package manager. 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.A package manager makes sure you always get the latest updates, and guarantees the stability of CLI components. Před zahájením ruční instalace se podívejte, jestli je k dispozici balíček pro vaši distribuci.Check and see if there is a package for your distribution before installing manually.

PožadavkyPrerequisites

Rozhraní příkazového řádku vyžaduje následující software:The CLI requires the following software:

Důležité

Rozhraní příkazového řádku je také kompatibilní s Python 2.7.x, který se ještě end lifed na 1. ledna 2020.The CLI is also compatible with Python 2.7.x, which is being end-of-lifed on January 1, 2020. Z tohoto důvodu doporučujeme nainstalovat Python 3 a spusťte CLI.For this reason we recommend that you install Python 3 to run the CLI.

Instalace nebo aktualizaceInstall or update

Instalace i aktualizace rozhraní příkazového řádku vyžaduje opětovné spuštění instalačního skriptu.Both installing and updating the CLI requires re-running the install script. Nainstalujte CLI spuštěním příkazu curl.Install the CLI by running curl.

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

Tento skript se také dá stáhnout a spustit místně.The script can also be downloaded and run locally. Možná bude nutné restartovat vaše prostředí, aby se změny projevily.You may have to restart your shell in order for changes to take effect.

Rozhraní příkazového řádku Azure potom můžete spustit pomocí příkazu az.You can then run the Azure CLI with the az command. K přihlášení použijte příkaz az login.To sign in, use 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

Toto jsou některé běžné problémy, které se vyskytují během ruční instalace.Here are some common problems seen during a manual installation. Pokud dojde k potížím, není součástí tohoto založte problém na Githubu.If you experience a problem not covered here, file an issue on GitHub.

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

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:If you get an error from curl related to the -L parameter, or an error message including the text "Object Moved", try using the full URL instead of the aka.ms redirect:

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

Příkaz az se nenašelaz command not found

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í.If you can't run the command after installation and using bash or zsh, clear your shell's command hash cache. SpusťteRun

hash -r

a podívejte se, jestli se problém vyřeší.and check if the problem is resolved.

K tomuto problému může také dojít, pokud jste po instalaci nerestartovali vaše prostředí.The issue can also occur if you didn't restart your shell after installation. Ověřte, že umístění příkazu az je v $PATH.Make sure that the location of the az command is in your $PATH. Umístění příkazu az jeThe location of the az command is

<install path>/bin

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.

Pokud chcete získat instalační skripty, váš proxy server je potřeba povolit připojení prostřednictvím protokolu HTTPS na následující adresy:In order to get the installation scripts, your proxy needs to allow HTTPS connections to the following addresses:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Koncové body používat Správce balíčků vaší distribuce (pokud existuje) pro základníEndpoints used by your distribution's package manager (if any) for core packages

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.

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.

Rozhraní příkazového řádku můžete odinstalovat přímým odstraněním souborů z umístění zvolené při instalaci.Uninstall the CLI by directly deleting the files from the location chosen at the time of installation. Výchozí umístění instalace je $HOME.The default install location is $HOME.

  1. Odeberte nainstalované soubory rozhraní příkazového řádku.Remove the installed CLI files.

    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:Modify your $HOME/.bash_profile file to remove the following line:

    <install location>/lib/azure-cli/az.completion
    
  3. Při použití bash nebo zsh znovu načtěte mezipaměť příkazů prostředí.If using bash or zsh, reload your shell's command cache.

    hash -r
    

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.