Linux での Azure CLI の手動インストールInstall Azure CLI on Linux manually

お使いのディストリビューションに対応した Azure CLI 用パッケージがない場合は、手動でスクリプトを実行して CLI をインストールします。If there's no package for the Azure CLI for you your distribution, install the CLI manually by running a script.

Azure CLI の現在のバージョンは 2.10.0 です。The current version of the Azure CLI is 2.10.0. 最新リリースについては、リリース ノートをご覧ください。For information about the latest release, see the release notes. インストール済みのバージョンを見つけ、更新する必要があるかどうかを確認するには、az --version を実行します。To find your installed version and see if you need to update, run az --version.

注意

パッケージ マネージャーを使用して CLI をインストールすることを強くお勧めします。It's strongly recommend to install the CLI with a package manager. パッケージ マネージャーを使用すると、常に最新の更新プログラムを取得できるので、CLI コンポーネントの安定性が保証されます。A package manager makes sure you always get the latest updates, and guarantees the stability of CLI components. 手動でインストールする前に、お使いのディストリビューション用のパッケージがあるかどうかを確認してください。Check and see if there is a package for your distribution before installing manually.

前提条件Prerequisites

CLI には、次のソフトウェアが必要です。The CLI requires the following software:

重要

バージョン 2.1.0 以降、CLI は Python 2.7 のサポートを終了しました。The CLI has dropped support for Python 2.7 since version 2.1.0. 新しいバージョンでは、Python 2.7 の正しい動作は保証されません。New versions no longer guarantee to run with Python 2.7 correctly.

インストールまたは更新Install or update

CLI をインストールおよび更新するには、いずれの場合もインストール スクリプトを再実行する必要があります。Both installing and updating the CLI requires re-running the install script. curl を実行して CLI をインストールします。Install the CLI by running curl.

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

スクリプトをダウンロードして、ローカルで実行することもできます。The script can also be downloaded and run locally. 変更を有効にするために、シェルの再起動が必要になる場合があります。You may have to restart your shell in order for changes to take effect.

その後、Azure CLI は az コマンドで実行できます。You can then run the Azure CLI with the az command. サインインするには、az login コマンドを使用します。To sign in, use az login command.

  1. login コマンドを実行します。Run the login command.

    az login
    

    CLI で既定のブラウザーを開くことができる場合、開いたブラウザに Azure サインイン ページが読み込まれます。If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    それ以外の場合は、https://aka.ms/devicelogin でブラウザー ページを開き、ターミナルに表示されている認証コードを入力します。Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. ブラウザーでアカウントの資格情報を使用してサインインします。Sign in with your account credentials in the browser.

さまざまな認証方法の詳細については、「Azure CLI を使用してサインインする」を参照してください。To learn more about different authentication methods, see Sign in with Azure CLI.

トラブルシューティングTroubleshooting

ここでは、手動インストール中に発生する一般的な問題をいくつか示します。Here are some common problems seen during a manual installation. ここで取り上げていない問題が発生した場合は、GitHub で問題を報告してください。If you experience a problem not covered here, file an issue on GitHub.

curl の "Object Moved" エラーcurl "Object Moved" error

curl-L パラメーターに関連するエラーが発生した場合や、"Object Moved" というテキストが含まれているエラー メッセージが表示された場合は、次のように、aka.ms リダイレクトの代わりに完全な 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

az コマンドが見つからないaz command not found

インストール後に、bash または zsh でコマンドを実行できない場合は、シェルのコマンド ハッシュのキャッシュをクリアします。If you can't run the command after installation and using bash or zsh, clear your shell's command hash cache. ランRun

hash -r

問題が解決されているかどうかを確認します。and check if the problem is resolved.

インストール後にシェルを再起動しなかった場合にも、この問題が発生することがあります。The issue can also occur if you didn't restart your shell after installation. az コマンドの場所が $PATH にあることを確認してください。Make sure that the location of the az command is in your $PATH. az コマンドの場所は次のとおりです。The location of the az command is

<install path>/bin

プロキシによる接続のブロックProxy blocks connection

プロキシのために外部リソースに接続できない場合、シェルに HTTP_PROXY および HTTPS_PROXY 変数を正しく設定していることを確認してください。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. これらのプロキシ用にどのホストとポートを使用するかについては、システム管理者に問い合わせる必要があります。You will need to contact your system administrator to know what host(s) and port(s) to use for these proxies.

これらの値は、多くの Linux プログラムで使用されます (インストール プロセスで使用されるものも含む)。These values are respected by many Linux programs, including those which are used in the install process. これらの値を設定するには、次の手順を実行します。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]

重要

プロキシの内側にいる場合は、これらのシェル変数を CLI によって Azure サービスに接続するように設定する必要があります。If you are behind a proxy, these shell variables must be set to connect to Azure services with the CLI. 基本認証を使用しない場合は、.bashrc ファイルでこれらの変数をエクスポートすることをお勧めします。If you are not using basic auth, it's recommended to export these variables in your .bashrc file. 常に、貴社のビジネスのセキュリティ ポリシーと、システム管理者の要件に従ってください。Always follow your business' security policies and the requirements of your system administrator.

インストール スクリプトを取得するには、プロキシで次のアドレスへの HTTPS 接続を許可する必要があります。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
  • コア パッケージ用のディストリビューションのパッケージ マネージャー (ある場合) によって使用されるエンドポイントEndpoints used by your distribution's package manager (if any) for core packages

Windows Subsystem for Linux で CLI をインストールまたは実行できないCLI fails to install or run on Windows Subsystem for Linux

Windows Subsystem for Linux (WSL) は Windows プラットフォームを基盤とするシステム呼び出し変換レイヤーであるため、Azure CLI をインストールまたは実行しようとするとエラーが発生する場合があります。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. CLI は、WSL にバグが含まれる可能性のあるいくつかの機能に依存しています。The CLI relies on some features that may have a bug in WSL. どのように CLI をインストールしてもエラーが発生する場合は、CLI のインストール プロセスではなく WSL に問題があると考えられます。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.

WSL インストールのトラブルシューティングを行い、問題を解決するには、以下を行ってください。To troubleshoot your WSL installation and possibly resolve issues:

  • 可能であれば、同じインストール プロセスを Linux マシンまたは VM で実行し、正常にインストールできるかどうかを確認します。If you can, run an identical install process on a Linux machine or VM to see if it succeeds. インストールできる場合、問題はほぼ間違いなく WSL に関連するものです。If it does, your issue is almost certainly related to WSL. Azure で Linux VM を開始するには、Azure portal での Linux 仮想マシンの作成に関するページを参照してください。To start a Linux VM in Azure, see the create a Linux VM in the Azure Portal documentation.
  • 最新バージョンの WSL を実行していることを確認します。Make sure that you're running the latest version of WSL. 最新バージョンを入手するには、Windows 10 インストールを更新してください。To get the latest version, update your Windows 10 installation.
  • 現在の問題に対処している、WSL 関連の未解決案件がないか確認します。Check for any open issues with WSL which might address your problem. この問題を回避する方法についての提案や、問題が修正される予定のリリースに関する情報が掲載されることがよくあります。Often there will be suggestions on how to work around the problem, or information about a release where the issue will be fixed.
  • 現在の問題に関する案件がまだない場合は、WSL に関する新規案件を提出します。その際は、必ず、可能な限り多くの情報を提供してください。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.

引き続き WSL でのインストールまたは実行の問題が発生する場合は、Windows 用の CLI のインストールを検討してください。If you continue to have issues installing or running on WSL, consider installing the CLI for Windows.

アンインストールUninstall

Azure CLI が不要であると判断した場合は、アンインストールできます。If you decide to uninstall the Azure CLI, we're sorry to see you go. アンインストールする前に、az feedback コマンドを使用して、どのような改善または修正が可能かをお知らせください。Before you uninstall, use the az feedback command to let us know what could be improved or fixed. Microsoft の目標は、Azure CLI のバグをなくし、使いやすいものにすることです。Our goal is to make the Azure CLI bug-free and user-friendly. バグが見つかった場合は、GitHub で問題を報告していただきますよう、よろしくお願いいたします。If you found a bug, we'd appreciate it if you file a GitHub issue.

CLI をアンインストールするには、インストール時に選択した場所からファイルを直接削除します。Uninstall the CLI by directly deleting the files from the location chosen at the time of installation. 既定のインストール場所は $HOME です。The default install location is $HOME.

  1. インストールされている CLI ファイルを削除します。Remove the installed CLI files.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. $HOME/.bash_profile ファイルを変更して、次の行を削除します。Modify your $HOME/.bash_profile file to remove the following line:

    <install location>/lib/azure-cli/az.completion
    
  3. bash または zsh を使用している場合は、シェルのコマンド キャッシュを再読み込みします。If using bash or zsh, reload your shell's command cache.

    hash -r
    

次の手順Next Steps

これで Azure CLI をインストールできました。次は、その機能と一般的なコマンドを簡単に見ていきましょう。Now that you've installed the Azure CLI, take a short tour of its features and common commands.