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

Azure Command-Line インターフェイス (CLI) は、macOS コンピューターにローカルにインストールできるクロスプラットフォーム のコマンド ライン ツールです。 Azure CLIを使用すると、対話型のコマンド ライン プロンプトまたはスクリプトを使用して、Azureに接続し、Azure リソースに対して管理コマンドを実行できます。

macOS プラットフォームの場合は、homebrew パッケージ マネージャーを使用してAzure CLIをインストールします。 Homebrew を使用すると、Azure CLIのインストールを簡単に最新の状態に保つことができます。 Azure CLI パッケージには macOS 13 以降が必要です。

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

Homebrew でインストールする

Homebrew は、Azure CLIインストールを管理する最も簡単な方法です。 これには、便利なインストール、更新、およびアンインストール手段が用意されています。 システムで使用できる Homebrew がない場合は、Homebrew をインストールしてから操作を続行します。

brew リポジトリ情報を更新し、install コマンドを実行して、macOS にAzure CLIをインストールできます。

brew update && brew install azure-cli

トラブルシューティング

Homebrew を使用してAzure CLIをインストールするときに問題が発生した場合は、一般的なエラーをいくつか次に示します。 ここで説明していない問題が発生した場合は、GitHubで問題を解決してください。

補完が機能していません

Azure CLIのホームブルー数式は、ホームブルー管理の補完ディレクトリにazという名前の補完ファイルをインストールします（既定の場所は/usr/local/etc/bash_completion.d/です）。 補完を有効にするには、Homebrew の指示 (ここ) に従ってしてください。

Zsh の場合は、 ファイルの末尾に次の 2 行を追加して保存し、Zsh プロファイルを再度再読み込みます。

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

Pythonまたはインストールされているパッケージが見つかりません

homebrew のインストール中に、マイナー バージョンの不一致またはその他の問題が発生する可能性があります。 Azure CLIはPython仮想環境を使用しないため、インストールされているPythonバージョンを見つけることに依存します。 考えられる修正案は、Homebrew から の依存関係をインストールして再リンクすることです。

brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10

Azure CLI バージョン 1.x がインストールされている

古いバージョンがインストールされている場合は、Homebrew の古いキャッシュが原因と考えられます。 更新の手順に従ってください。

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

プロキシを使用するように構成しない限り、Homebrew からリソースを取得できない場合があります。 Homebrew プロキシの構成手順に従ってください。

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

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

更新

Azure CLIは、バグ修正、機能強化、新機能、プレビュー機能で定期的に更新されます。 新しいリリースは月に 1 回程度利用できます。

バージョン 2.11.0 以降、Azure CLIは最新バージョンに更新するためのツール内コマンドを提供します。

az upgrade

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

また、ローカルの Homebrew リポジトリ情報を更新してから パッケージをアップグレードすることもできます。

brew update && brew upgrade azure-cli

[アンインストール]

Azure CLIをアンインストールされると伺い、残念に思います。 アンインストールする前に、 コマンドを使用して、どのような改善または修正が可能かをお知らせください。 私たちの目標は、Azure CLIバグをなくし、ユーザーフレンドリーにすることです。 バグが見つかった場合は、GitHubの問題を報告。

Homebrew を使用して、 パッケージをアンインストールします。

brew uninstall azure-cli

[データを削除する]

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

rm -rf ~/.azure

その他のインストール方法

homebrew を使用して環境にAzure CLIをインストールできない場合は、Linux 用の手動の手順を使用できます。 このプロセスは macOS との互換性が正式には維持されていません。 Homebrew などのパッケージ マネージャーを使用することをお勧めします。 他の選択肢を利用できない場合のみ、手動によるインストール方法を使用します。

手動でのインストール手順については、「Install Azure CLI on Linux manuallyを参照してください。

次のステップ

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