你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 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 Silicon 或 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 不可用
  • Internet 访问受到限制
  • 需要完全控制安装位置

此方法通常用于企业环境、监管环境或空隙环境。

先决条件

  • macOS （Apple Silicon 或 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

选择正确的体系结构可确保兼容性和最佳性能。

小窍门

对于脱机环境，请在具有 Internet 访问权限的计算机上运行此命令，然后将下载的 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二进制文件。

将以下内容添加到 shell 配置文件（~/.zshrc 或 ~/.bashrc）：

export AZ_PYTHON="/path_to_python"
export PATH="/target_directory_path/bin:$PATH"

重新加载 shell 配置：

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

然后从 shell 配置文件中删除 AZ_PYTHON 和 PATH 条目。

Troubleshooting

如果在安装或将 Azure CLI 与 Homebrew Cask 或 Tarball 方法一起使用时遇到问题，下面是一些常见错误（其中许多错误特定于 Homebrew）。 如果遇到的问题未在本文中列出，请在 GitHub 上提出问题。

找不到Azure CLI

确保 PATH 包括安装目录：

echo $PATH

完成无法正常工作

Azure CLI 的 Homebrew 安装（无论是通过 formula 还是 cask）在 Homebrew 托管的完成目录中提供一个名为 az 的完成文件。 若要启用自动完成，请按照 Homebrew 文档中的说明操作。

对于 Zsh，请将以下两行添加到 .zshrc 文件底部，然后保存并重新加载 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 获取瓶资源，代理需要允许与以下地址建立 HTTPS 连接：

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

后续步骤

在 macOS 上安装 Azure CLI 后，请简要了解其功能和常见命令。

开始使用 Azure CLI

  • Last updated on