Azure CLIは、対話形式またはスクリプトを使用してAzureリソースを管理するためのクロスプラットフォーム のコマンドライン ツールです。
macOS では、Azure CLI Homebrew Core 数式から保守性と柔軟性の高いインストール モデルに移行しています。 新しいモデルには次のものが含まれます。
- Homebrew Cask (ほとんどのユーザーに推奨)
- Tarball (オフライン環境またはエアギャップ環境に推奨)
このエクスペリエンスは現在プレビュー段階であり、今後のリリースで標準インストール アプローチになります。
Homebrew Cask を使用する理由
- 最も簡単なインストールとアップグレードのエクスペリエンス
- 依存関係を自動的に管理する
- サポートされる将来のインストール モデルに合わせて調整します
変更される内容
Azure CLIは、ブローカー ベースの認証など、より安全な認証をサポートするように進化しています。 これらの機能には、cask ベースのインストール モデルが必要です。 その結果、Homebrew Core から Homebrew Cask に移行します。 この変更により、既存のAzure CLI機能は削除または制限されません。 Homebrew Cask は、現在のすべてのAzure CLI機能とバージョンと完全に互換性があります。
この変更により、環境間の一貫性が向上し、オフライン インストールや制御された展開環境などのシナリオのサポートが向上します。
Important
Azure CLIは現在、Homebrew Cask インストール モデルのプレビュー 段階にあります。 このフェーズでは、インストールはカスタム Homebrew タップでのみ使用できます。
- 現在のメソッド:
brew install azure-cli - 新しいメソッド (プレビュー フェーズ):
- カスタム タップによる Homebrew Cask
brew tap azure/azure-clibrew install --cask azure-cli-preview
- Tarball ベースのインストール
- カスタム タップによる Homebrew Cask
インストール方法を選択する
次のガイダンスを使用して、シナリオに最適なインストール方法を選択します。
| Scenario | 推奨される方法 |
|---|---|
| ほとんどのユーザー | Homebrew Cask |
| オフラインまたはエアギャップシステム | Tarball |
| カスタム インストール場所が必要 | Tarball |
Homebrew Cask を使用してAzure CLIをインストールする
Homebrew は、macOS 上のAzure CLIに最もシンプルで保守しやすいインストール エクスペリエンスを提供します。 標準パッケージ管理ワークフローを使用して、インストール、アップグレード、および削除を処理します。
前提条件
- macOS (Apple シリコンまたは Intel)
- Homebrew がインストールされている
Homebrew 数式を使用してAzure CLIが既にインストールされている場合は、競合を回避するために続行する前にアンインストールします。
brew uninstall azure-cli
Azure CLIをインストールする
これにより、Azure CLIのカスタム タップから Homebrew Cask を使用してAzure CLIがインストールされます。 これは、プレビュー フェーズでサポートされている唯一の Homebrew インストール方法です。
brew tap azure/azure-cli
brew install --cask azure-cli-preview
インストールを検証する
インストール後、Azure CLIが使用可能であることを確認します。
az --version
Azure CLIのアップグレード
最新バージョンにアップグレードするには:
brew update && brew upgrade --cask azure-cli-preview
Azure CLI をアンインストールする
Azure CLIを削除するには:
brew uninstall --cask azure-cli-preview
brew untap azure/azure-cli
プレビュー フェーズの後
Homebrew Cask のインストールが一般公開された場合:
- プレビューのインストール方法 (カスタム タップによる
azure-cli-preview) は廃止されます。 - Azure CLIは、Homebrew Cask の公式リポジトリから入手できます。
次を使用してAzure CLIをインストールします。
brew install --cask azure-cli
# Or
brew install azure-cli
Homebrew Core 数式を使用する既存のインストールは、Cask ベースのインストールに移行する必要があります。 Homebrew Core 数式は、この切り替え後にサポートされなくなります。
Tarball を使用してAzure CLIをインストールする
次の場合は、このメソッドを使用します。
- Homebrew は使用できません
- インターネット アクセスが制限されている
- インストール場所を完全に制御する必要がある
この方法は、エンタープライズ環境、規制環境、またはエアギャップ環境でよく使用されます。
前提条件
- macOS (Apple シリコンまたは Intel)
- Python 3.13 は任意の方法 (python.org、pyenv など) を使用してインストールされます。
tarball をダウンロードする
インターネットにアクセスできるコンピューターでは、アーキテクチャ用の最新のAzure CLI tarball を自動的にダウンロードできます。
ARCH=$(uname -m)
VER=$(curl -s https://api.github.com/repos/Azure/azure-cli/releases/latest | grep tag_name | cut -d '"' -f4 | sed 's/azure-cli-//')
curl -L -o az.tar.gz "https://github.com/Azure/azure-cli/releases/download/azure-cli-$VER/azure-cli-$VER-macos-$ARCH.tar.gz"
このスクリプトは、アーキテクチャを検出し、Azure CLI リリース ページから最新のAzure CLI tarball をダウンロードします。
-
arm64は Apple Silicon を示します -
x86_64は Intel を示します
適切なアーキテクチャを選択すると、互換性と最適なパフォーマンスが保証されます。
Tip
オフライン環境の場合は、インターネットにアクセスできるコンピューターでこのコマンドを実行し、ダウンロードした tarball をターゲット システムに転送します。
インストール ディレクトリに展開する
Azure CLIをインストールするディレクトリを選択します。
mkdir -p $HOME/lib/azure-cli
tar -xzf az.tar.gz -C $HOME/lib/azure-cli
環境変数を構成する
Azure CLIには、Python ランタイムへのアクセスが必要です。 PythonとAzure CLI バイナリを指す環境を構成します。
シェル プロファイルに次のコードを追加します (~/.zshrc または ~/.bashrc)。
export AZ_PYTHON="/path_to_python"
export PATH="/target_directory_path/bin:$PATH"
シェル構成を再読み込みします。
source ~/.zshrc
インストールを検証する
az --version
Azure CLIのアップグレード
オフライン環境でAzure CLIをアップグレードするには、新しい Tarball をダウンロードし、既存のインストールに展開します。
sudo tar -xzf az.tar.gz -C /target_directory_path
Azure CLI をアンインストールする
インストール ディレクトリを削除します。
sudo rm -rf /target_directory_path
次に、シェル プロファイルから AZ_PYTHON と PATH エントリを削除します。
Troubleshooting
Homebrew Cask または Tarball メソッドでAzure CLIをインストールまたは使用するときに問題が発生した場合は、一般的なエラーをいくつか次に示します (その多くは Homebrew に固有です)。 ここで取り上げていない問題が発生した場合は、GitHub で問題を報告してください。
Azure CLIが見つかりません
PATH にインストール ディレクトリが含まれていることを確認します。
echo $PATH
補完が機能していません
Azure CLI Homebrew のインストール (数式または cask を使用) は、Homebrew のマネージドコンプリート ディレクトリに az という名前の完了ファイルを提供します。 完了を有効にするには、 Homebrew の指示に従います。
Zsh の場合は、.zshrc ファイルの末尾に次の 2 行を追加して保存し、Zsh プロファイルを再度再読み込みます。
autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az
Python またはインストールされているパッケージが見つかりません
homebrew のインストール中に、マイナー バージョンの不一致またはその他の問題が発生する可能性があります。 Azure CLIはPython仮想環境を使用しないため、インストールされているPythonバージョンを見つけることに依存します。 考えられる修正案は、Homebrew から python@3.13 の依存関係をインストールして再リンクすることです。
brew update && brew install python@3.13 && brew upgrade python@3.13
brew link --overwrite python@3.13
プロキシによる接続のブロック
プロキシを使用するように構成しない限り、Homebrew からリソースを取得できない場合があります。 Homebrew プロキシの構成手順に従ってください。
Important
プロキシの背後にいる場合は、HTTP_PROXY と HTTPS_PROXY を設定して、Azure CLIを使用してAzure サービスに接続する必要があります。 基本認証を使用しない場合は、これらの変数を .bashrc ファイルにエクスポートする必要があります。 常に、貴社のビジネスのセキュリティ ポリシーと、システム管理者の要件に従ってください。
Homebrew から Bottle リソースを取得するには、プロキシで次のアドレスへの HTTPS 接続を許可する必要があります。
https://formulae.brew.shhttps://homebrew.bintray.com
次のステップ
macOS に Azure CLI をインストールしたら、その機能と一般的なコマンドについて簡単に説明します。
Azure CLI