macOS にAzure CLIをインストールする - プレビュー

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
      1. brew tap azure/azure-cli
      2. brew install --cask azure-cli-preview
    • Tarball ベースのインストール

インストール方法を選択する

次のガイダンスを使用して、シナリオに最適なインストール方法を選択します。

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_PYTHONPATH エントリを削除します。

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

Homebrew から Bottle リソースを取得するには、プロキシで次のアドレスへの HTTPS 接続を許可する必要があります。

  • https://formulae.brew.sh
  • https://homebrew.bintray.com

次のステップ

macOS に Azure CLI をインストールしたら、その機能と一般的なコマンドについて簡単に説明します。