次の方法で共有

Linux に Azure CLI をインストールする

  • [アーティクル]

この記事では、Azure CLI を Linux にインストールする方法について説明します。 ページの上部にあるオプションから、ディストリビューションに適したパッケージ マネージャーを選択します。 Linux ディストリビューションのパッケージ マネージャーを使用することをお勧めしますが、[スクリプトのインストール] オプションを選択して、Linux に Azure CLI を手動 でインストールすることもできます。

Azure CLI の現在のバージョンは 2.63.0 です。 最新リリースについては、リリース ノートをご覧ください。 インストール済みのバージョンを見つけ、更新する必要があるかどうかを確認するには、az version を実行します。

開始する前に

  • Azure CLI 2.38.2 (2024 年 6 月 21 日リリース) は、RHEL 7 および Centos 7 でサポートされている最新バージョンです。 Microsoft は、これらのディストリビューションの更新プログラムやバグ修正プログラムを提供しなくなりました。

  • Microsoft は引き続き Azure CLI と Linux インストール スクリプトの開発とサポートを行っています。

  • dnf パッケージ マネージャーをサポートしていない Linux システムを使用している場合は、yum パッケージ マネージャーを使用してください。

Azure CLI のインストール

Azure CLI をインストールするには、次の手順を実行します。

  1. Microsoft リポジトリ キーをインポートします。

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

  2. RHEL 9 または CentOS Stream の場合は、リポジトリ packages-microsoft-com-prod 追加します。

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

    RHEL 8 の場合は、 packages-microsoft-com-prod リポジトリを追加します。

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

    RHEL 7 の場合は、 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

    注意事項

    CentOS 7 End Of Life (EOL) は 2024 年 6 月 30 日でした。 Azure CLI でサポートされる環境の詳細については、 Azure CLI のサポート ライフサイクルに関するページを参照してください。

  3. dnf install コマンドを使用してインストールします。

    sudo dnf install azure-cli

特定のバージョンをインストールする

まず、上記のように azure-cli リポジトリ情報を構成する必要があります。 利用可能なバージョンについては、「Azure CLI リリース ノート」を参照してください。

  1. コマンドを使用して利用可能なバージョンを表示するには、以下を実行します。

    dnf list --showduplicates azure-cli

  2. 特定のバージョンをインストールするには、以下を実行します。

    sudo dnf install azure-cli-<version>-1.el7

Azure CLI を更新する

バージョン 2.11.0 以降の Azure CLI には、最新バージョンに更新するためのツール内コマンドが用意されています。

az upgrade

このコマンドを使用すると、インストールされているすべての拡張機能も既定で更新されます。 az upgrade オプションの詳細については、コマンド リファレンス ページをご覧ください。 2.11.0 より前のバージョンの Azure CLI の場合は、「Azure CLI のインストール」の説明に従って再インストールすることで更新します。

dnf update コマンドを使用して Azure CLI を更新することもできます。

sudo dnf update azure-cli

Azure CLI をアンインストールする

Azure CLI が不要であると判断した場合は、アンインストールできます。 アンインストールする前に、az feedback コマンドを使用して、どのような改善または修正が可能かをお知らせください。 Microsoft の目標は、Azure CLI のバグをなくし、使いやすいものにすることです。 バグが見つかった場合は、GitHub で問題を報告していただきますよう、よろしくお願いいたします。

  1. システムからパッケージを削除します。

    sudo dnf remove azure-cli

  2. CLI を再インストールする予定がない場合は、リポジトリ情報を削除します。

    sudo rm /etc/yum.repos.d/azure-cli.repo

  3. 他の Microsoft パッケージを使用しない場合は、署名キーを削除します。

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY

[データを削除する]

Azure CLI を再インストールする予定がない場合は、そのデータを削除します。

rm -rf ~/.azure

トラブルシューティング

ここでは、dnf でのインストール時に発生する一般的な問題をいくつか示します。 ここで取り上げていない問題が発生した場合は、GitHub で問題を報告してください。

Python 3 を含まない RHEL 7.6 またはその他のシステムにインストールする

可能な場合は、python 3.6+ パッケージの正式なサポートがあるバージョンにシステムをアップグレードしてください。 それ以外の場合は、最初に python3 パッケージをインストールしてから、依存関係なしで Azure CLI をインストールする必要があります。

次のコマンドを使用して、ソースからビルドされた python 3.6 を使用する Azure CLI インストール スクリプトをダウンロードしてインストールできます。

curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

手順を追って実行することもできます。

まず、Azure CLI には SSL 1.1+ が必要であり、python3 をビルドする前にソースから openssl 1.1 をビルドする必要があります。

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

次に、ソースから Python 3 をビルドします。

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

最後に、インストールの説明の手順 1 と 2 に従って、Azure CLI リポジトリを追加します。 これで、パッケージをダウンロードして、依存関係なしでインストールできます。

Note

dnf ダウンロード プラグインがまだインストールされていない場合は、以下のコードを実行するときに command not found エラーが発生します。 dnf install 'dnf-command(download)' を使用して dnf ダウンロード プラグインをインストールしてください。

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

代替の方法として、別のリポジトリを使用して Python 3 をインストールすることもできます。 python3 を設定したが、エラー python3: command not found が引き続き発生する場合は、この方法を使用してください。 パスに含まれていることを確認してください。

scl enable rh-python36 bash

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

プロキシのために外部リソースに接続できない場合、シェルに HTTP_PROXY および HTTPS_PROXY 変数を正しく設定していることを確認してください。 これらのプロキシ用にどのホストとポートを使用するかについては、システム管理者に問い合わせる必要があります。

これらの変数の値は、多くの Linux プログラムおよびインストール プロセス中に使用されます。 これらの値を設定するには、次の手順を実行します。

# 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 サービスに接続するように設定する必要があります。 基本認証を使用しない場合は、.bashrc ファイルでこれらの変数をエクスポートすることをお勧めします。 常に、貴社のビジネスのセキュリティ ポリシーと、システム管理者の要件に従ってください。

常にこのプロキシを使用するように dnf を明示的に構成することが必要な場合もあります。 次の行が /etc/dnf/dnf.conf の [main] セクションの下に表示されていることを確認してください。

[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

リポジトリから Microsoft 署名キーとパッケージを取得するには、お使いのプロキシで次のアドレスへの HTTPS 接続を許可する必要があります。

  • https://packages.microsoft.com

Windows Subsystem for Linux で CLI をインストールまたは実行できない

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

WSL インストールのトラブルシューティングを行い、問題を解決するには、以下を行ってください。

  • 可能であれば、同じインストール プロセスを Linux マシンまたは VM で実行し、正常にインストールできるかどうかを確認します。 インストールできる場合、問題は WSL に関連している可能性が高いです。 Azure で Linux VM を開始するには、Azure portal での Linux 仮想マシンの作成に関するページを参照してください。
  • 最新バージョンの WSL を実行していることを確認します。 最新バージョンを入手するには、Windows 10 インストールを更新してください。
  • 現在の問題に対処している、WSL 関連の未解決の問題がないか確認します。 この問題を回避する方法についての提案や、問題が修正されているリリースに関する情報が掲載されることがよくあります。
  • 現在の問題に関する案件がまだない場合は、WSL に関する新規案件を提出します。その際は、必ず、可能な限り多くの情報を提供してください。

引き続き WSL でのインストールまたは実行の問題が発生する場合は、Windows 用の CLI のインストールを検討してください。

開始する前に

  • Azure CLI 2.38.2 (2024 年 6 月 21 日リリース) は、SUSE Linux Enterprise Server (SLES) と OpenSUSE (Leap) でサポートされている最新バージョンです。 Microsoft は、これらのディストリビューションの更新プログラムやバグ修正プログラムを提供しなくなりました。

  • Microsoft は引き続き Azure CLI と Linux インストール スクリプトの開発とサポートを行っています。 SUSE は、SUSE/OpenSUSE リポジトリによって提供されるパッケージの保守とサポートを行います。

  • Azure では、Azure Marketplace イメージに基づく SUSE および OpenSUSE 仮想マシン (VM) に Azure CLI が既にインストールされています。

Azure CLI のインストール

SUSE/OpenSUSE に Azure CLI をインストールするには、次のいずれかの方法を選択してください。

  1. SUSE/OpenSUSE リポジトリで SUSE によって提供される Enterprise パッケージを使用する。

  2. [Install script (any)]\(インストール スクリプト (任意)\) タブに記載されているインストール方法を使用する。

  3. Microsoft リポジトリからインストールする

SUSE または OpenSUSE リポジトリからインストールする

Azure CLI の RPM パッケージは、python3 パッケージによって異なります。

sudo zypper install -y azure-cli

インストール スクリプトでインストールする

インストール スクリプト オプションを使用して、任意のバージョンの Linux に Azure CLI を手動でインストールできます。

この方法を使用して最新バージョンに "更新する" 場合は、まず以前のバージョンと、そのバージョン用に追加したリポジトリをすべてアンインストールしてください。

Microsoft リポジトリからインストールする

Microsoft リポジトリを使用して Azure CLI の最新の履歴バージョンをインストールするには、次の手順に従います。

(このパッケージは、SLES 15 と OpenSUSE Leap 15.1 でテストされています)

  1. curl をインストールします。

    sudo zypper install -y curl

  2. Microsoft リポジトリ キーをインポートします。

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

  3. ローカル azure-cli リポジトリ情報を作成します。

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli

  4. zypper パッケージのインデックスを更新し、インストールを行います。

    sudo zypper install --from azure-cli azure-cli

    「2」と入力すると、依存関係の一部を無視してインストールが続行されます。

特定のバージョンをインストールする

まず、上記のように azure-cli リポジトリ情報を構成する必要があります。 使用可能なバージョンについては、「Azure CLI リリース ノート」を参照してください。

  1. 次のコマンドを使用して、使用可能なバージョンを表示します。

    zypper search --details --match-exact azure-cli

  2. 特定のバージョンをインストールするには、以下を実行します。

    sudo zypper install --from azure-cli azure-cli=<version>-1.el7

Azure CLI を更新する

バージョン 2.11.0 以降の Azure CLI には、最新バージョンに更新するためのツール内コマンドが用意されています。

az upgrade

このコマンドを使用すると、インストールされているすべての拡張機能も既定で更新されます。 az upgrade オプションの詳細については、コマンド リファレンス ページをご覧ください。 2.11.0 より前のバージョンの Azure CLI の場合は、「Azure CLI のインストール」の説明に従って再インストールすることで更新します。

zypper update コマンドを使用してパッケージを更新することもできます。

sudo zypper refresh
sudo zypper update azure-cli

Azure CLI をアンインストールする

Azure CLI が不要であると判断した場合は、アンインストールできます。 アンインストールする前に、az feedback コマンドを使用して、どのような改善または修正が可能かをお知らせください。 Microsoft の目標は、Azure CLI のバグをなくし、使いやすいものにすることです。 バグが見つかった場合は、GitHub で問題を報告していただきますよう、よろしくお願いいたします。

  1. システムからパッケージを削除します。

    sudo zypper remove -y azure-cli

  2. CLI を再インストールする予定がない場合は、リポジトリ情報を削除します。

    sudo zypper removerepo azure-cli

  3. 他の Microsoft パッケージを使用しない場合は、Microsoft 署名キーを削除します。

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY

[データを削除する]

Azure CLI を再インストールする予定がない場合は、そのデータを削除します。

rm -rf ~/.azure

トラブルシューティング

ここでは、zypper でのインストール時に発生する一般的な問題をいくつか示します。 ここで取り上げていない問題が発生した場合は、GitHub で問題を報告してください。

Python 3 を使用せずにインストールする

重要

Azure CLI の RPM パッケージは、python3 パッケージによって異なります。 お使いのシステムでは、これは Python 3.6.x の要件より前から存在する Python バージョンである可能性があります。 この影響がある場合は、代替の python3 パッケージを見つけてください。

Python 2 は 2020 年 1 月 1日に有効期間 (EOL) が終了したため、更新プログラムは配信されません。 Azure CLI は、バージョン 2.1.0 以降、Python 2.7 のサポートを終了しました。 Python 2.7 を使用すると、新しいバージョンの CLI が正しく実行されない場合があります。

OpenSUSE 15 VM での NotImplementedError

OpenSUSE 15 VM には、バージョン 2.0.45 の Azure CLI が事前にインストールされていますが、これは古く、az login に関する問題があります。 このバージョンをその依存関係と共に削除してから、インストール手順に従って、最新の Azure CLI を追加します。

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

バージョン 2.0.45 の依存関係を削除せずに Azure CLI を更新した場合は、その古い依存関係が最新バージョンの Azure CLI に影響する可能性があります。 古いバージョンを再度追加してその依存関係にリンクさせてから、その依存関係と共に azure-cli を削除する必要があります。

# 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

Python 3.6 を含まない SLES 12 またはその他のシステムにインストールする

SLES 12 では、既定の python3 パッケージは 3.4 であり、Azure CLI ではサポートされていません。 最初に、インストールの指示の手順 1 から 3 に従って、azure-cli リポジトリを追加します。 次に、ソースからより新しいバージョンの python3 をビルドします。 最後に、Azure CLI パッケージをダウンロードして、依存関係なしでインストールできます。

次の 1 つのコマンドを使用して、上記の手順に基づいて Azure CLI をインストールまたは更新できます。 このスクリプトにより /usr/local/azcli に Python 3.8 がインストールされ、az の別名を PATH=/usr/local/azcli/bin:$PATH az に設定することによって Azure CLI で使用されるようにします。 スクリプトをダウンロードし、必要に応じて変更することもできます。 たとえば、Python のバージョンやインストールの場所を変更できます。

curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash

初めてインストールする場合は、次のコマンドを実行してエイリアスをアクティブ化することを忘れないでください。

source ~/.bashrc

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

プロキシのために外部リソースに接続できない場合、シェルに HTTP_PROXY および HTTPS_PROXY 変数を正しく設定していることを確認してください。 これらのプロキシ用にどのホストとポートを使用するかについては、システム管理者に問い合わせる必要があります。

これらの変数の値は、多くの Linux プログラムおよびインストール プロセス中に使用されます。 これらの値を設定するには、次の手順を実行します。

# 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 サービスに接続するように設定する必要があります。 基本認証を使用しない場合は、.bashrc ファイルでこれらの変数をエクスポートすることをお勧めします。 常に、貴社のビジネスのセキュリティ ポリシーと、システム管理者の要件に従ってください。

常にこのプロキシを使用するように zypper (yast2 経由) を明示的に構成することが必要な場合もあります。 このためには、yast2 proxy コマンドをスーパーユーザーとして実行し、フォームに提示された情報を入力します。 システムでウィンドウ マネージャーを使用できる場合、YaST Control Center で Network Services > Proxy ウィンドウを使用することもできます。

詳細な構成やその他の情報については、OpenSUSE プロキシの構成に関するドキュメントをご覧ください。

Microsoft 署名キーを取得し、リポジトリからパッケージを取得するには、お使いのプロキシで次のアドレスへの HTTPS 接続を許可する必要があります。

  • https://packages.microsoft.com
  • https://download.opensuse.org

Windows Subsystem for Linux で CLI をインストールまたは実行できない

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

WSL インストールのトラブルシューティングを行い、問題を解決するには、以下を行ってください。

  • 可能であれば、同じインストール プロセスを Linux マシンまたは VM で実行し、正常にインストールできるかどうかを確認します。 インストールできる場合、問題は WSL に関連している可能性が高いです。 Azure で Linux VM を開始するには、Azure portal での Linux 仮想マシンの作成に関するページを参照してください。
  • 最新バージョンの WSL を実行していることを確認します。 最新バージョンを入手するには、Windows 10 インストールを更新してください。
  • 現在の問題に対処している、WSL 関連の未解決の問題がないか確認します。 この問題を回避する方法についての提案や、問題が修正されているリリースに関する情報が掲載されることがよくあります。
  • 現在の問題に関する案件がまだない場合は、WSL に関する新規案件を提出します。その際は、必ず、可能な限り多くの情報を提供してください。

引き続き WSL でのインストールまたは実行の問題が発生する場合は、Windows 用の CLI のインストールを検討してください。

SSL 証明書の問題

マシンで証明書が破損していたり、古くなったりしていると、curl がサーバーの正当性を確認できなかったためにセキュリティで保護された接続を確立できなかったことを示すエラーが表示されることがあります。 証明書を更新して問題を解決してください。

sudo zypper update-ca-certificates

開始する前に

  • apt パッケージ マネージャーには、次のディストリビューションでテスト済みの Azure CLI の x86_64 および ARM64 パッケージが含まれています。

    Distribution Version
    Ubuntu 20.04 LTS (フォーカル フォッサ)、22.04 (ジャミー クラゲ)、24.04 (ノーブル Numbat)
    Debian 10 (Buster)、11 (Bullseye)、12 (Bookworm)

  • Ubuntu 20.04 (Focal Fossa) および 20.10 (Groovy Gorilla) には、universe リポジトリによって提供されるバージョン 2.0.81 の azure-cli パッケージが含まれています。 このパッケージは古いため、推奨されません。 このパッケージがインストールされている場合は、続行する前にコマンド sudo apt remove azure-cli -y && sudo apt autoremove -y を実行して、パッケージを削除してください。 apt remove の詳細については、Ubuntu パッケージの管理に関するページを参照するか、ubuntu にお問い合わせください。

Azure CLI のインストール

システムに Azure CLI をインストールするには、2 つのオプションがあります。 インストール コマンドを自動で実行するインストール スクリプトをダウンロードすることも、ステップ バイ ステップ プロセスでインストール コマンドを自分で実行することもできます。 両方の方法について、以下で説明します。

オプション 1: 1 つのコマンドでインストールする

Azure CLI をインストールする最も簡単な方法は、Azure CLI チームが管理するスクリプトを使用することです。 このスクリプトはすべてのインストール コマンドを 1 ステップで実行します。 このスクリプトは curl 経由でダウンロードされ、CLI をインストールするために直接 bash にパイプ処理されます。

実行する前にスクリプトの内容を自分で調べる場合は、まず curl を使用してスクリプトをダウンロードし、任意のテキスト エディターで調べます。

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

オプション 2:ステップ バイ ステップのインストール手順

ステップ バイ ステップのインストール プロセスを使用する場合は、次の手順を実行して Azure CLI をインストールします。

  1. インストール プロセスに必要なパッケージを取得します。

    sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release

  2. Microsoft の署名キーをダウンロードしてインストールします。

    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. 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. リポジトリ情報を更新し、azure-cli パッケージをインストールします。

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

特定のバージョンをインストールする

上記のように azure-cli リポジトリ情報を構成します。 使用可能なバージョンについては、「Azure CLI リリース ノート」を参照してください。

  1. Azure CLI の使用可能なバージョンを表示します。

    apt-cache policy azure-cli

  2. 特定のバージョンをインストールします。

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

    変数なしで特定のバージョンをインストールするには、表示されている Azure CLI のバージョンと Linux ディストリビューション名を置換します。

    sudo apt-get install azure-cli=2.51.0-1~bullseye

"パッケージ azure-cli の場所が見つからない" というエラー メッセージが表示された場合、azure-cli リポジトリ情報が構成されていません。 オプション 2: ステップ バイ ステップのインストール手順に従ってください。

"azure-cli のバージョン x.xx.x-1~distributionName が見つかりませんでした" というエラー メッセージが表示された場合、lsb_release -cs を使用し、実行中のディストリビューションを見つけます。

Azure CLI を更新する

バージョン 2.11.0 以降の Azure CLI には、最新バージョンに更新するためのツール内コマンドが用意されています。

az upgrade

このコマンドを使用すると、インストールされているすべての拡張機能も既定で更新されます。 az upgrade オプションの詳細については、コマンド リファレンス ページをご覧ください。 2.11.0 より前のバージョンの Azure CLI の場合は、「Azure CLI のインストール」の説明に従って再インストールすることで更新します。

apt-get upgrade を使用して CLI パッケージを更新することもできます。 このコマンドにより、システムにインストールされている、依存関係が変更されていないすべてのパッケージがアップグレードされます。

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

CLI だけをアップグレードするには、apt-get install を使用します。

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

Azure CLI をアンインストールする

Azure CLI が不要であると判断した場合は、アンインストールできます。 アンインストールする前に、az feedback コマンドを使用して、どのような改善または修正が可能かをお知らせください。 Microsoft の目標は、Azure CLI のバグをなくし、使いやすいものにすることです。 バグが見つかった場合は、GitHub で問題を報告していただきますよう、よろしくお願いいたします。

  1. apt-get remove を使用してアンインストールします。

    sudo apt-get remove -y azure-cli

  2. CLI を再インストールする予定がない場合は、Azure CLI リポジトリ情報を削除します。

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

  3. Microsoft の他のパッケージを使用していない場合は、署名キーを削除します。

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

  4. 不要なパッケージを削除します。

    sudo apt autoremove

[データを削除する]

Azure CLI を再インストールする予定がない場合は、そのデータを削除します。

rm -rf ~/.azure

トラブルシューティング

ここでは、apt でのインストール時に発生する一般的な問題をいくつか示します。 ここで取り上げていない問題が発生した場合は、GitHub で問題を報告してください。

azure-cli パッケージは、CLI バージョン 2.46.0 以降で ARM64 アーキテクチャをサポートしています。

Ubuntu 20.04 (Focal)/WSL でのモジュールが存在しない問題

手動インストールの手順の「手順 3」で Azure CLI ソフトウェア リポジトリを追加せずに、または提供されているスクリプトを使用して azure-cli を Focal にインストールした場合、インストールしたパッケージが focal/universe リポジトリからの古い azure-cli 2.0.81 であるため、"decorator" や "antlr4" という名前のモジュールが存在しないなどの問題が発生する可能性があります。 最初に sudo apt remove azure-cli -y && sudo apt autoremove -y を実行してそれを削除してから、上記の手順に従って最新の azure-cli パッケージをインストールします。

lsb_release がベース ディストリビューション バージョンを返さない

Ubuntu や Debian から派生する他のディストリビューション (Linux Mint など) の一部では、正しいバージョン名が lsb_release から返されない場合があります。 この値は、インストール プロセスで、インストールするパッケージを特定するときに使用されます。 ディストリビューションの派生元である Ubuntu または Debian のバージョンのコード名がわかっている場合は、リポジトリを追加するときに AZ_REPO 値を手動で設定できます。 それ以外の場合は、ご自身のディストリビューションについて、ベース ディストリビューションのコード名を調べて、AZ_REPO を正しい値に設定する方法をご確認ください。

ご使用のディストリビューションのパッケージがない

場合によっては、更新された Azure CLI パッケージが、ディストリビューション バージョン リリース後すぐには使用できないことがあります。 Azure CLI は、将来のバージョンの依存関係に対して弾力性を持つように、また可能な限りそれらに依存しないように設計されています。 ベース ディストリビューションに使用できるパッケージがない場合は、以前のディストリビューション用のパッケージをお試しください。

以前のディストリビューションのパッケージを試すには、リポジトリを追加するときに AZ_REPO の値を手動で設定します。 Ubuntu ディストリビューションには最新の jammy リポジトリーを使用します。

AZ_REPO="jammy"

Debian ディストリビューションには最新の bookworm リポジトリーを使用します。

AZ_REPO="bookworm"

重要

Ubuntu Bionic および Debian Buster より前にリリースされたディストリビューションはサポートされていません。

elementary OS (EOS) で Azure CLI のインストールが失敗する

lsb_release によって HERA (EOS リリース名) が返されるため、EOS で Azure CLI のインストールが失敗します。 解決策は、ファイル /etc/apt/sources.list.d/azure-cli.sources を修正して、Suites: hera を Suites: bionic に変更することです。

元のファイルの内容:

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

修正したファイルの内容

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

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

プロキシのために外部リソースに接続できない場合、シェルに HTTP_PROXY および HTTPS_PROXY 変数を正しく設定していることを確認してください。 これらのプロキシ用にどのホストとポートを使用するかについては、システム管理者に問い合わせる必要があります。

これらの変数の値は、多くの Linux プログラムおよびインストール プロセス中に使用されます。 これらの値を設定するには、次の手順を実行します。

# 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 サービスに接続するように設定する必要があります。 基本認証を使用しない場合は、.bashrc ファイルでこれらの変数をエクスポートすることをお勧めします。 常に、貴社のビジネスのセキュリティ ポリシーと、システム管理者の要件に従ってください。

常にこのプロキシを使用するように apt を明示的に構成することが必要な場合もあります。 次の行が /etc/apt/apt.conf.d/ の apt 構成ファイルに表示されることを確認します。 既存のグローバル構成ファイル、既存のプロキシ構成ファイル、40proxies、または 99local を使用することをお勧めしますが、システム管理の要件に従ってください。

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

プロキシで基本認証を使用しない場合は、プロキシ URL の [username]:[password]@ 部分を削除します。 プロキシ構成について詳しくは、Ubuntu の公式ドキュメントを参照してください。

Microsoft 署名キーを取得し、リポジトリからパッケージを取得するには、お使いのプロキシでアドレス https://packages.microsoft.com. への HTTPS 接続を許可する必要があります。

Windows Subsystem for Linux で CLI をインストールまたは実行できない

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

WSL インストールのトラブルシューティングを行い、問題を解決するには、以下を行ってください。

  • 可能であれば、同じインストール プロセスを Linux マシンまたは VM で実行し、正常にインストールできるかどうかを確認します。 インストールできる場合、問題は WSL に関連している可能性が高いです。 Azure で Linux VM を開始するには、Azure portal での Linux 仮想マシンの作成に関するページを参照してください。
  • 最新バージョンの WSL を実行していることを確認します。 最新バージョンを入手するには、Windows 10 インストールを更新してください。
  • 現在の問題に対処している、WSL 関連の未解決の問題がないか確認します。 この問題を回避する方法についての提案や、問題が修正されているリリースに関する情報が掲載されることがよくあります。
  • 現在の問題に関する案件がまだない場合は、WSL に関する新規案件を提出します。その際は、必ず、可能な限り多くの情報を提供してください。

引き続き WSL でのインストールまたは実行の問題が発生する場合は、Windows 用の CLI のインストールを検討してください。

Azure CLI のインストール

Azure Linux 用の RPM は 、CBL-Mariner を介してリリースされます。 azure-cli パッケージは、CLI バージョン 2.46.0 以降で ARM64 アーキテクチャをサポートしています。

Azure CLI をインストールするには、次の手順を実行します。

  1. Microsoft が選択した公式の信頼されたルート証明書のセットをインストールします。

    sudo tdnf install ca-certificates

  2. Azure CLI をインストールします。

    sudo tdnf install azure-cli

特定のバージョンをインストールする

利用可能なバージョンについては、「Azure CLI リリース ノート」を参照してください。

コマンドを使用して利用可能なバージョンを表示するには、以下を実行します。

tdnf list azure-cli

特定のバージョンをインストールするには、以下を実行します。

sudo tdnf install azure-cli-<version>-1

Azure CLI を更新する

tdnf update コマンドで Azure CLI を更新します。

sudo tdnf update azure-cli

Azure CLI をアンインストールする

Azure CLI が不要であると判断した場合は、アンインストールできます。 アンインストールする前に、az feedback コマンドを使用して、どのような改善または修正が可能かをお知らせください。 Microsoft の目標は、Azure CLI のバグをなくし、使いやすいものにすることです。 バグが見つかった場合は、GitHub で問題を報告していただきますよう、よろしくお願いいたします。

システムからパッケージを削除します。

sudo tdnf remove azure-cli

[データを削除する]

Azure CLI を再インストールする予定がない場合は、そのデータを削除します。

rm -rf ~/.azure

開始する前に

パッケージ マネージャーを使用して CLI をインストールすることを強くお勧めします。 パッケージ マネージャーを使用すると、常に最新の更新プログラムを取得できるので、CLI コンポーネントの安定性が保証されます。 手動でインストールする前に、ご使用のディストリビューション用のパッケージがないかを確認します。

Azure CLI のインストール スクリプトには、次のソフトウェアが必要です。

Azure CLI をインストールまたは更新する

重要

インストール スクリプトは、Python 3.8.x、3.9.x、または 3.10.x でのみ機能します。 このインストール スクリプトは、Python 3.11.x 以降のバージョンでは機能しません。

Azure CLI のインストールと更新の両方で、インストール スクリプトを再実行する必要があります。

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

スクリプトをダウンロードして、ローカルで実行することもできます。 変更を有効にするには、シェルを再起動する必要がある場合があります。

Azure CLI をアンインストールする

Azure CLI が不要であると判断した場合は、アンインストールできます。 アンインストールする前に、az feedback コマンドを使用して、どのような改善または修正が可能かをお知らせください。 Microsoft の目標は、Azure CLI のバグをなくし、使いやすいものにすることです。 バグが見つかった場合は、GitHub で問題を報告していただきますよう、よろしくお願いいたします。

CLI をアンインストールするには、インストール時に選択した場所からファイルを直接削除します。 既定のインストール場所は、ユーザーのホーム ディレクトリ ($HOME) です。

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

    rm -r <install location>/lib/azure-cli
rm <install location>/bin/az

  2. $HOME/.bash_profile ファイルを変更して、次の行を削除します。

    <install location>/lib/azure-cli/az.completion

  3. bash または zsh を使用している場合は、シェルのコマンド キャッシュを再読み込みします。

    hash -r

[データを削除する]

Azure CLI を再インストールする予定がない場合は、そのデータを削除します。

rm -rf ~/.azure

トラブルシューティング

ここでは、手動インストール中に発生する一般的な問題をいくつか示します。 ここで取り上げていない問題が発生した場合は、GitHub で問題を報告してください。

Python 3 を使用せずにインストールする

バージョン 2.1.0 以降、Azure CLI は Python 2.7 のサポートを終了しました。 ご使用のシステムには、要件となっている Python 3.6.x より古い Python バージョンが存在する可能性があります。 置き換え用の python3 パッケージを見つけます。

curl の "Object Moved" エラー

curl で -L パラメーターに関連するエラーが発生した場合や、"Object Moved" というテキストが含まれているエラー メッセージが表示された場合は、次のように、aka.ms リダイレクトの代わりに完全な URL を使用してみてください。

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

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

bash または zsh を使用してインストールした後にコマンドを実行できない場合は、シェルのコマンド ハッシュ キャッシュをクリアして、問題が解決されるかどうかを確認してください。

hash -r

インストール後にシェルを再起動しなかった場合にも、この問題が発生することがあります。 az コマンドの場所が $PATH にあることを確認してください。 az コマンドの場所は ...

 <install path>/bin

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

プロキシのために外部リソースに接続できない場合、シェルに HTTP_PROXY および HTTPS_PROXY 変数を正しく設定していることを確認してください。 これらのプロキシ用にどのホストとポートを使用するかについては、システム管理者に問い合わせる必要があります。

これらの変数の値は、多くの Linux プログラムおよびインストール プロセス中に使用されます。 これらの値を設定するには、次の手順を実行します。

# 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 サービスに接続するように設定する必要があります。 基本認証を使用しない場合は、.bashrc ファイルでこれらの変数をエクスポートすることをお勧めします。 常に、貴社のビジネスのセキュリティ ポリシーと、システム管理者の要件に従ってください。

インストール スクリプトを取得するには、プロキシで次のアドレスへの HTTPS 接続を許可する必要があります。

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • コア パッケージ用のディストリビューションのパッケージ マネージャー (ある場合) によって使用されるエンドポイント

Windows Subsystem for Linux で CLI をインストールまたは実行できない

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

WSL インストールのトラブルシューティングを行い、問題を解決するには、以下を行ってください。

  • 可能であれば、同じインストール プロセスを Linux マシンまたは VM で実行し、正常にインストールできるかどうかを確認します。 インストールできる場合、問題は WSL に関連している可能性が高いです。 Azure で Linux VM を開始するには、Azure portal での Linux 仮想マシンの作成に関するページを参照してください。
  • 最新バージョンの WSL を実行していることを確認します。 最新バージョンを入手するには、Windows 10 インストールを更新してください。
  • 現在の問題に対処している、WSL 関連の未解決の問題がないか確認します。 この問題を回避する方法についての提案や、問題が修正されているリリースに関する情報が掲載されることがよくあります。
  • 現在の問題に関する案件がまだない場合は、WSL に関する新規案件を提出します。その際は、必ず、可能な限り多くの情報を提供してください。

引き続き WSL でのインストールまたは実行の問題が発生する場合は、Windows 用の CLI のインストールを検討してください。

次のステップ

これで Azure CLI をインストールできました。次は、その機能と一般的なコマンドを簡単に見ていきましょう。

Azure CLI の概要