你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

如何在 Docker 容器中运行 Azure CLI

可以使用 Docker 通过预装的 Azure CLI 运行独立的 Linux 容器,从而为使用 Azure CLI 提供快速隔离的环境。 此容器映像还可以用作你自己的自定义部署的基础。

警告

Azure CLI 2.63.0(2024 年 8 月发布)是基于 Alpine 的 Docker 映像支持的最终版本。 Microsoft不再为此映像提供更新或 bug 修复。 为了确保持续支持,请迁移到完全维护的基于 Azure Linux 的映像(Azure Linux 3.0)。 请参阅以下示例,了解如何使用 Azure Linux 3.0。

若要禁止显示警告消息,请运行: az config set core.only_show_errors=yes。 有关配置选项的详细信息,请参阅 Azure CLI 配置值和环境变量

查找可用图像

按照 Docker 的官方 说明 安装 Docker。 发布容器派生自官方分发映像、安装依赖项和安装 Azure CLI。

可以在 Docker 映像页上找到 Azure CLI Docker 映像 的完整列表。

重要

这些映像是从 OS 分发服务器提供的正式作系统 (OS) 映像生成的。 这些映像可能没有最新的安全更新。 Microsoft建议将 OS 包更新到最新版本,以确保应用最新的安全更新。

启动预安装了 Azure CLI 的 Docker 容器

打开命令提示符,并使用以下命令启动已预装 Azure CLI 的 Docker 容器。 在管道中使用此命令时,请使用确定性标记(如 azurelinux3.0)来确保一致的行为。

docker run -it mcr.microsoft.com/azure-cli:azurelinux3.0

注释

若要在容器中使用本地 SSH 密钥,请通过包括以下选项来装载 .ssh 目录: --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh 此选项允许容器从用户环境访问 SSH 密钥。

docker run -it --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh mcr.microsoft.com/azure-cli:azurelinux3.0

Azure CLI 在映像中可用作位于 az 中的 /usr/bin/az 命令。

运行包含特定版本的 Azure CLI 的 Docker 容器

可以在 Azure CLI 发行说明中找到可用版本。

若要在 Docker 容器中运行特定版本的 Azure CLI,请使用以下命令,替换 2.74.0 为您所需的版本。

docker run -it mcr.microsoft.com/azure-cli:2.74.0-azurelinux3.0

更新 Docker 映像

若要在使用 Docker 时更新 Azure CLI,必须拉取最新的映像并重新创建任何现有容器。 由于此更新过程,请避免将 Azure CLI 容器用作持久性数据存储。

使用以下命令更新本地映像:

docker pull mcr.microsoft.com/azure-cli:latest

卸载 Docker 映像

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

若要删除 Docker 映像,请先停止任何正在运行的容器,然后运行:

docker rmi mcr.microsoft.com/azure-cli

后续步骤

现在,你已准备好在 Docker 容器中使用 Azure CLI,快速了解其关键功能和常用命令以开始使用。