在 Linux 上手动安装 Azure CLI
如果没有适用于你的分发版的 Azure CLI 包,请运行一个脚本来手动安装 CLI。
Azure CLI 的当前版本为 2.3.1。 有关最新版本的信息,请参阅发行说明。 若要查找你已安装的版本并查看是否需要更新,请运行 az --version
。
Note
强烈建议使用包管理器安装 CLI。 使用包管理器可确保始终获得最新更新,并保证 CLI 组件的稳定性。 在手动安装之前,请检查发行版是否有对应的包。
先决条件
CLI 需要以下软件:
Important
自版本 2.1.0
发布以来,CLI 已放弃对 Python 2.7 的支持。 新版本不再保证在 Python 2.7 环境中正常运行。
安装或更新
安装和更新 CLI 都需要重新运行安装脚本。 运行 curl
来安装 CLI。
curl -L https://aka.ms/InstallAzureCli | bash
也可以下载并在本地运行该脚本。 可能需要重启 shell 才能使更改生效。
然后即可使用 az
命令来运行 Azure CLI。 若要登录,请使用 az login 命令。
运行
login
命令。az login
如果 CLI 可以打开默认浏览器,它将这样做并加载 Azure 登录页。
否则,请在 https://aka.ms/devicelogin 处打开浏览器页,然后输入终端中显示的授权代码。
Note
请先运行
az cloud set -n AzureChinaCloud
更改云环境,然后才能在 Azure 中国中使用 Azure CLI。若要切换回 Azure 公有云,请再次运行az cloud set -n AzureCloud
。在浏览器中使用帐户凭据登录。
若要详细了解不同的身份验证方法,请参阅使用 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]
Important
如果你位于代理后面,则必须设置这些 shell 变量以通过 CLI 连接到 Azure 服务。
如果不使用基本身份验证,建议将这些变量导出到 .bashrc
文件中。
请始终遵循企业的安全策略和系统管理员的要求。
为了获取安装脚本,代理必须允许与以下地址之间的 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
。
删除安装的 CLI 文件。
rm -r <install location>/lib/azure-cli rm <install location>/bin/az
修改
$HOME/.bash_profile
文件,删除以下行:<install location>/lib/azure-cli/az.completion
如果使用
bash
或zsh
,请重新加载 shell 的命令缓存。hash -r
后续步骤
现在你已经安装了 Azure CLI,下面简要介绍其功能和常用命令。