在 macOS 上安装 Azure CLI

对于 macOS 平台,可以通过 homebrew 包管理器安装 Azure CLI。 使用 Homebrew 可以轻松保持 CLI 的最新安装状态。 该 CLI 包已在 macOS 10.9 和更高版本中测试。

CLI 的当前版本为 2.0.69。 有关最新版本的信息,请参阅发行说明。 若要查找你已安装的版本并查看是否需要更新,请运行 az --version

使用 Homebrew 安装

Homebrew 是管理 CLI 安装的最容易的方法。 它可以方便地进行安装、更新和卸载。 如果系统中没有可用的 Homebrew,请先安装 Homebrew,然后继续。

安装 CLI 时,可以先更新 brew 存储库信息,然后运行 install 命令:

brew update && brew install azure-cli

Important

Azure CLI 依赖于 Homebrew python3 包,并将安装它。 Azure CLI 保证可与 Homebrew 上发布的最新版本的 python3 兼容。

然后即可使用 az 命令来运行 Azure CLI。 若要登录,请使用 az login 命令。

若要详细了解不同的身份验证方法,请参阅使用 Azure CLI 登录

故障排除

如果在通过 Homebrew 安装 CLI 时遇到问题,会显示以下常见错误。 如果遇到的问题未在本文中列出,请在 github 上提出问题

找不到 Python 或安装的包

在执行 Homebrew 安装期间,可能会出现次要版本不匹配或其他问题。 CLI 不会使用 Python 虚拟环境,因此,它只能查找已安装的 Python 版本。 可行的解决方法之一是从 Homebrew 安装并重新链接 python3 依赖项。

brew update && brew install python3 && brew upgrade python3
brew link --overwrite python3

已安装 CLI 安装 1.x

如果安装了过时的版本,则陈旧的 Homebrew 缓存可能导致此问题。 请遵照更新说明操作。

代理阻止连接

你可能无法从 Homebrew 获取资源,除非已将其正确配置为使用你的代理。 请遵循 Homebrew 代理配置说明

Important

如果你位于代理后面,则必须设置 HTTP_PROXYHTTPS_PROXY 以通过 CLI 连接到 Azure 服务。 如果不使用基本身份验证,建议将这些变量导出到 .bashrc 文件中。 请始终遵循企业的安全策略和系统管理员的要求。

为了从 Homebrew 获取 Bottle 资源,代理必须允许与以下地址之间的 HTTPS 连接:

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

更新

CLI 定期使用 Bug 修复、改进、新功能和预览版功能进行更新。 新版本大约两周发布一次。 更新本地存储库信息,然后升级 azure-cli 包。

brew update && brew upgrade azure-cli

卸载

如果你决定卸载 Azure CLI,我们会很遗憾。 在卸载之前,请使用 az feedback 命令告诉我们在哪些方面需要改进或修复。 我们的目标是消除 Azure CLI 中的 bug 并使其变得用户友好。 如果你在发现 bug 后提出 GitHub 问题,我们将十分感激。

使用 Homebrew 卸载 azure-cli 包。

brew uninstall azure-cli

其他安装方法

如果不能使用 homebrew 在你的环境中安装 Azure CLI,可以使用适用于 Linux 的手册说明。 请注意,此过程未正式保持与 macOS 兼容。 始终建议使用诸如 Homebrew 之类的包管理器。 仅当没有其他选项可用时才使用手动安装方法。

有关手动安装说明,请参阅在 Linux 上手动安装 Azure CLI

后续步骤

现在你已经安装了 Azure CLI,下面简要介绍其功能和常用命令。