Docker コンテナーで Azure CLI を実行する方法

2025-06-24

Docker を使用すると、Azure CLI がプレインストールされたスタンドアロンの Linux コンテナーを実行でき、Azure CLI を使用するための迅速で分離された環境が提供されます。このコンテナーイメージは、独自のカスタムデプロイのベースとしても機能します。

Warnung

Azure CLI 2.63.0 (2024 年 8 月リリース) は、Alpine ベースの Docker イメージでサポートされる最終バージョンです。 Microsoft は、このイメージの更新プログラムやバグ修正プログラムを提供しなくなりました。継続的なサポートを確保するには、完全に保守されている Azure Linux ベースのイメージ (Azure Linux 3.0) に移行します。 Azure Linux 3.0 の使用については、次の例を参照してください。

警告メッセージを抑制するには、次を実行します: az config set core.only_show_errors=yes。構成オプションの詳細については、 Azure CLI の構成値と環境変数に関するページを参照してください。

Azure CLI がプレインストールされた Docker コンテナーを起動する

次のコマンドを使用して、コマンドプロンプトを開き、Azure CLI がプレインストールされた Docker コンテナーを起動します。パイプラインでこのコマンドを使用する場合は、決定論的タグ ( azurelinux3.0 など) を使用して、一貫性のある動作を保証します。

docker run -it mcr.microsoft.com/azure-cli:azurelinux3.0

注

コンテナー内でローカル SSH キーを使用するには、次のオプションを含めて .ssh ディレクトリをマウントします: --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh。このオプションを使用すると、コンテナーはユーザー環境から SSH キーにアクセスできます。

docker run -it --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh mcr.microsoft.com/azure-cli:azurelinux3.0

Azure CLI は、/usr/local/bin/azにある az コマンドとしてイメージで使用できます。

特定のバージョンの Azure CLI で Docker コンテナーを実行する

使用可能なバージョンは、 Azure CLI のリリースノートで確認できます。

Docker コンテナーで特定のバージョンの Azure CLI を実行するには、次のコマンドを使用して、 2.74.0 を目的のバージョンに置き換えます。

docker run -it mcr.microsoft.com/azure-cli:2.74.0-azurelinux3.0

Docker イメージの更新

Docker を使用するときに Azure CLI を更新するには、最新のイメージをプルし、既存のコンテナーを再作成する必要があります。この更新プロセスのため、永続的なデータストアとして Azure CLI コンテナーを使用しないでください。

次のコマンドを使用してローカルイメージを更新します。

docker pull mcr.microsoft.com/azure-cli:latest

Docker イメージのアンインストール

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

Docker イメージを削除するには、まず実行中のコンテナーを停止してから、次を実行します。

docker rmi mcr.microsoft.com/azure-cli

次のステップ

これで、Docker コンテナーで Azure CLI を使用する準備ができたので、その主な機能と一般的に使用されるコマンドを簡単に説明します。

Azure CLI の使用を開始する