在 Linux 上手动安装 Azure CLI

• 04/13/2020
• • 
  • 
  • 

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

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

先决条件

CLI 需要以下软件：

• Python 3.6.x、3.7.x 或 3.8.x。
• libffi
• OpenSSL 1.0.2

安装或更新

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

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

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

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

1. 运行 login 命令。

   az login
   

   如果 CLI 可以打开默认浏览器，它将这样做并加载 Azure 登录页。

   否则，请在 https://aka.ms/devicelogin 处打开浏览器页，然后输入终端中显示的授权代码。

   Note

   在 Azure China 中使用 Azure CLI 2.0 之前，请首先运行 az cloud set -n AzureChinaCloud 更改云环境。 如果要切换回全局 Azure，请再次运行 az cloud set -n AzureCloud。

2. 在浏览器中使用帐户凭据登录。

若要详细了解不同的身份验证方法，请参阅使用 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

代理阻止连接

如果由于代理而无法连接到外部资源，请确保已在 shell 中正确设置了 HTTP_PROXY 和 HTTPS_PROXY 变量。 你需要与系统管理员联系以了解要对这些代理使用哪些主机和端口。

许多 Linux 程序（包括那些在安装过程中使用的程序）也会采用这些值。 若要设置这些值，请执行以下操作：

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

为了获取安装脚本，代理必须允许与以下地址之间的 HTTPS 连接：

• https://aka.ms/
• https://azurecliprod.blob.core.chinacloudapi.cn/
• https://pypi.python.org
• 分发版的包管理器（如果有）用于核心包的终结点

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，下面简要介绍其功能和常用命令。