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

概要

RHEL 8/9 や CentOS Stream 8/9 など、dnf を使用する Linux ディストリビューションには、Azure CLI 用の RPM パッケージがあります。

警告

Azure CLI 2.39.0 (2022 年 8 月 2 日リリース) 以降、RHEL 7 と CentOS 7 用の RPM パッケージはリリースされません。これらのシステムでは引き続き過去のバージョンの Azure CLI を使用できますが、これらのバージョンに対する Microsoft からの更新プログラムやバグ修正はありません。

Azure CLI と Linux インストールスクリプトは、引き続き Microsoft によって開発およびサポートされます。 Red Hat および CentOS の各リポジトリによって提供されるパッケージは、それぞれのディストリビューションによってメンテナンスおよびサポートされます。

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

重要

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

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

Note

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

Note

azure-cli パッケージでは、2.46.0 の ARM64 アーキテクチャがサポートされています。

インストール

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

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

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

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

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

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

RHEL 7 または CentOS 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

dnf install コマンドを使用してインストールします。
```
sudo dnf install azure-cli
```

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

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

コマンドを使用して利用可能なバージョンを表示するには、以下を実行します。
```
dnf list --showduplicates azure-cli
```
特定のバージョンをインストールするには、以下を実行します。
```
sudo dnf install azure-cli-<version>-1.el7
```

トラブルシューティング

ここでは、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 のインストールを検討してください。

更新

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

az upgrade

Note

az upgrade コマンドはバージョン 2.11.0 で追加されたもので、2.11.0 より前のバージョンでは動作しません。以前のバージョンは、「Azure CLI のインストール」の説明に従って再インストールすることによって更新できます。

このコマンドを使用すると、インストールされているすべての拡張機能も既定で更新されます。 az upgrade オプションの詳細については、コマンドリファレンスページを参照してください。

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

sudo dnf update azure-cli

アンインストール

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

システムからパッケージを削除します。
```
sudo dnf remove azure-cli
```
CLI を再インストールする予定がない場合は、リポジトリ情報を削除します。
```
sudo rm /etc/yum.repos.d/azure-cli.repo
```

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

警告

SUSE Linux Enterprise Server (SLES) および OpenSUSE (Leap) 用に Microsoft によって開発された最新の Azure CLI パッケージは、バージョン 2.39.0 (2022 年 8 月 2 日リリース) です。これらのシステムでは引き続き過去のバージョンの Azure CLI を使用できますが、これらのバージョンに対する Microsoft からの更新プログラムやバグ修正はありません。

Azure CLI と Linux インストールスクリプトは、引き続き Microsoft によって開発およびサポートされます。 SUSE/OpenSUSE リポジトリによって提供されるパッケージは、SUSE によって管理およびサポートされます。

概要

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

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

SUSE/OpenSUSE リポジトリで SUSE によって提供される Enterprise パッケージを使用する。
[Install script (any)] (インストールスクリプト (任意)) タブに記載されているインストール方法を使用する。

Azure CLI のインストール

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

重要

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

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

sudo zypper install -y azure-cli

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

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

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

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

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

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

curl をインストールします。
```
sudo zypper install -y curl
```

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

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

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

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

zypper パッケージのインデックスを更新し、インストールを行います。
```
sudo zypper install --from azure-cli azure-cli
```
「2」と入力すると、依存関係の一部を無視してインストールが続行されます。

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

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

次のコマンドを使用して、使用可能なバージョンを表示します。
```
zypper search --details --match-exact azure-cli
```
特定のバージョンをインストールするには、以下を実行します。
```
sudo zypper install --from azure-cli azure-cli=<version>-1.el7
```

トラブルシューティング

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

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

更新

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

az upgrade

Note

az upgrade コマンドはバージョン 2.11.0 で追加されたもので、2.11.0 より前のバージョンでは動作しません。以前のバージョンは、「Azure CLI のインストール」の説明に従って再インストールすることによって更新できます。

このコマンドを使用すると、インストールされているすべての拡張機能も既定で更新されます。 az upgrade オプションの詳細については、コマンドリファレンスページを参照してください。

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

sudo zypper refresh
sudo zypper update azure-cli

アンインストール

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

システムからパッケージを削除します。
```
sudo zypper remove -y azure-cli
```
CLI を再インストールする予定がない場合は、リポジトリ情報を削除します。
```
sudo zypper removerepo azure-cli
```

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

概要

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

Distribution	Version
Ubuntu	18.04 LTS (Bionic Beaver)、20.04 LTS (Focal Fossa)、22.04 (Jammy Jellyfish)
Debian	10 (Buster)、11 (Bullseye)

警告

以前のシステムでは引き続き履歴バージョンの Azure CLI を使用できますが、更新プログラムやバグ修正はありません。 Ubuntu または Debian の新しいバージョンにアップグレードして、最新のバージョンの Azure CLI を使用します。

警告

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 を実行して、パッケージを削除してください。詳細については、Ubuntu パッケージの管理に関するページを参照するか、、ubuntu にお問い合わせください。apt remove

Note

azure-cli パッケージでは、2.46.0 の ARM64 アーキテクチャがサポートされています。

インストールオプション

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

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

Azure CLI チームは、1 回の手順ですべてのインストールコマンドを実行するスクリプトを保持します。このスクリプトは curl 経由でダウンロードされ、CLI をインストールするために直接 bash にパイプ処理されます。

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

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

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

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

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

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

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

Azure CLI ソフトウェアリポジトリを追加します。

AZ_REPO=$(lsb_release -cs)
echo "deb [arch=`dpkg --print-architecture` signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" |
    sudo tee /etc/apt/sources.list.d/azure-cli.list

リポジトリ情報を更新し、azure-cli パッケージをインストールします。
```
sudo apt-get update
sudo apt-get install azure-cli
```

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

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

コマンドを使用して利用可能なバージョンを表示するには、以下を実行します。
```
apt-cache policy azure-cli
```
特定のバージョンをインストールするには、以下を実行します。
```
sudo apt-get install azure-cli=<version>-1~bullseye
```

トラブルシューティング

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

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 ディストリビューションには最新の bullseye リポジトリーを使用します。

AZ_REPO="bullseye"

重要

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

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

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

元のファイルの内容:

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ hera main

修正したファイルの内容

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ bionic main

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

プロキシのために外部リソースに接続できない場合、シェルに 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 接続を許可する必要があります。

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 のインストールを検討してください。

更新

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

az upgrade

Note

az upgrade コマンドはバージョン 2.11.0 で追加されたもので、2.11.0 より前のバージョンでは動作しません。以前のバージョンは、「Azure CLI のインストール」の説明に従って再インストールすることによって更新できます。

このコマンドを使用すると、インストールされているすべての拡張機能も既定で更新されます。 az upgrade オプションの詳細については、コマンドリファレンスページを参照してください。

apt-get upgrade を使用して CLI パッケージを更新することもできます。

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

Note

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

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

アンインストール

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

apt-get remove を使用してアンインストールします。
```
sudo apt-get remove -y azure-cli
```
CLI を再インストールする予定がない場合は、Azure CLI リポジトリ情報を削除します。
```
sudo rm /etc/apt/sources.list.d/azure-cli.list
```
Microsoft の他のパッケージを使用していない場合は、署名キーを削除します。
```
sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg
```
不要なパッケージを削除します。
```
sudo apt autoremove
```

概要

RPM は CBL-Mariner 2.0 用にリリースされます。

Note

azure-cli パッケージでは、2.46.0 の ARM64 アーキテクチャがサポートされています。

インストール

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

sudo tdnf install azure-cli

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

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

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

tdnf list azure-cli

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

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

更新

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

sudo tdnf update azure-cli

アンインストール

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

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

sudo tdnf remove azure-cli

概要

注意

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

CLI には、次のソフトウェアが必要です。

重要

Azure CLI は、バージョン 2.1.0 以降、Python 2.7 のサポートを終了しました。 Python 2.7 を使用すると、新しいバージョンが正しく実行されない場合があります。

インストールまたは更新

Azure CLI のインストールおよび更新のいずれの場合も、先にインストールスクリプトを再実行する必要があります。

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

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

トラブルシューティング

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

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

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

インストールされている CLI ファイルを削除します。
```
rm -r <install location>/lib/azure-cli
rm <install location>/bin/az
```
$HOME/.bash_profile ファイルを変更して、次の行を削除します。
```
<install location>/lib/azure-cli/az.completion
```
bash または zsh を使用している場合は、シェルのコマンドキャッシュを再読み込みします。
```
hash -r
```

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

概要

インストール

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

トラブルシューティング

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

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

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

更新

アンインストール

概要

Azure CLI のインストール

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

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

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

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

トラブルシューティング

OpenSUSE 15 VM での NotImplementedError

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

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

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

SSL 証明書の問題

更新

アンインストール

概要

インストール オプション

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

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

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

トラブルシューティング

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

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

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

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

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

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

更新

アンインストール

概要

インストール

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

更新

アンインストール

概要

インストールまたは更新

トラブルシューティング

curl の "Object Moved" エラー

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

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

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

[アンインストール]

[データを削除する]

次の手順

その他のリソース

その他のリソース

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

インストールオプション

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

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

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