你当前正在访问 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 配置值和环境变量

启动预安装了 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 在映像中可用作位于 /usr/local/bin/az 中的 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,快速了解其关键功能和常用命令以开始使用。