在 Linux 上手动安装 Azure CLI

如果没有适用于你的分发版的 Azure CLI 包,请运行一个脚本来手动安装 CLI。

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

Note

强烈建议使用包管理器安装 CLI。 使用包管理器可确保始终获得最新更新,并保证 CLI 组件的稳定性。 在手动安装之前,请检查发行版是否有对应的包。

先决条件

CLI 需要以下软件:

Important

该 CLI 也与 Python 2.7.x 兼容,后者将于 2020 年 1 月 1 日停用。 出于此原因,我们建议安装 Python 3 以运行该 CLI。

安装或更新

安装和更新 CLI 都需要重新运行安装脚本。 运行 curl 来安装 CLI。

curl -L https://aka.ms/InstallAzureCli | bash

也可以下载并在本地运行该脚本。 可能需要重启 shell 才能使更改生效。

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

az login

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

故障排除

下面是手动安装过程中可能出现的一些常见问题。 如果遇到的问题未在本文中列出,请在 github 上提出问题

curl“对象已移动”错误

如果从有关 -L 参数的 curl 收到错误,或者收到包含“对象已移动”的错误消息,请尝试使用完整 URL 而不是 aka.ms 重定向:

curl https://azurecliprod.blob.core.windows.net/install | bash

找不到 az 命令

如果在安装后以及在使用 bashzsh 时无法运行该命令,请清除 shell 的命令哈希缓存。 运行

hash -r

并查看问题是否得到解决。

如果在安装后没有重启 shell,也可能出现此错误。 确保 az 命令的位置在 $PATH 中。 az 命令的位置为

<install path>/bin

CLI 未能在适用于 Linux 的 Windows 子系统上安装或运行

由于适用于 Linux 的 Windows 子系统 (WSL) 是基于 Windows 平台的一个系统调用转换层,因此,在尝试安装或运行 Azure CLI 时可能会发生错误。 CLI 依赖于在 WSL 中可能具有 bug 的某些功能。 如果无论你以何方式安装 CLI 都会发生错误,则很可能是因为 WSL 有问题而不是 CLI 安装过程有问题。

若要对 WSL 安装进行故障排除并尽可能解决问题,请执行以下操作:

  • 如果可以,在 Linux 计算机或 VM 上运行相同的安装过程来看看它是否会成功。 如果成功,则几乎可以肯定问题与 WSL 有关。 若要启动 Azure 中的 Linux VM,请参阅在 Azure 门户中创建 Linux VM 文档。
  • 确保运行的是最新版本的 WSL。 若要获取最新版本,请更新 Windows 10 安装
  • 检查 WSL 是否存在可能会解决你的问题的待解决问题。 那里通常会提供有关如何解决该问题的建议,或者提供有关将修复该问题的发行版的信息。
  • 如果没有与你的问题对应的现有问题,请提交一个新的 WSL 问题并确保提供尽可能多的信息。

如果在 WSL 上安装或运行时继续出现问题,请考虑安装适用于 Windows 的 CLI

卸载

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

可以通过直接从安装时所选的位置删除文件来卸载 CLI。 默认安装位置是 $HOME

  1. 删除安装的 CLI 文件。

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. 修改 $HOME/.bash_profile 文件,删除以下行:

    <install location>/lib/azure-cli/az.completion
    
  3. 如果使用 bashzsh,请重新加载 shell 的命令缓存。

    hash -r
    

后续步骤

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