在 Linux 上手动安装 Azure CLI

  • 作者
    • Stephen Tramer
    • olprod
    • Derek1101

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

Note

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

先决条件

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 命令

如果在安装后以及在使用 bash 或 zsh 时无法运行该命令，请清除 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. 如果使用 bash 或 zsh，请重新加载 shell 的命令缓存。

    hash -r

后续步骤

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

Azure CLI 入门