Azure CLI Docker 镜像文档

一、镜像概述与主要用途

本镜像为 Azure CLI（Azure 命令行工具）的 Docker 化版本，基于 Alpine Linux 构建，提供轻量级、高效的容器化环境。Azure CLI 是一套开源命令行工具，用于管理和自动化 Microsoft Azure 云服务，支持通过终端直接创建、配置、监控 Azure 资源。本镜像封装了 az 可执行文件，便于在容器环境中快速部署和使用 Azure CLI，适用于各类自动化场景及临时操作需求。

二、核心功能与特性

2.1 基础特性

• 轻量级基础：基于 Alpine Linux，镜像体积小，资源占用低。
• 多架构支持：兼容 amd64 和 arm64v8 架构，适配不同硬件环境。
• 官方版本同步：每个 Azure CLI 官方版本均对应发布镜像，版本标签与官方保持一致。

2.2 核心功能

• 内置完整 az 命令行工具，支持所有 Azure CLI 操作（如资源组管理、虚拟机创建、存储配置等）。
• 可直接通过 docker run 命令执行 az 子命令，无需本地安装依赖。
• 支持作为基础镜像自定义，预配置 CLI settings 或集成额外工具。

三、支持的标签

镜像提供以下版本标签（按最新版本排序）：

• latest（最新稳定版）
• 2.63.0
• 2.62.0
• 2.61.0
• 2.60.0
• 2.59.0
• 2.58.0
• 2.57.0
• 2.56.0
• 2.55.0
• 2.54.0
• 2.53.1

四、使用场景与适用范围

4.1 典型场景

• CI/CD 流水线集成：在自动化流程中执行 Azure 资源部署、配置命令（如 Jenkins、GitHub Actions 等）。
• 临时操作环境：无需本地安装 Azure CLI，通过容器快速执行临时命令（如查询资源状态、修改配置）。
• 多环境一致性：确保开发、测试、生产环境使用统一版本的 Azure CLI，避免版本差异导致的兼容性问题。
• 自定义镜像构建：作为基础镜像，预配置企业内部 CLI 策略或集成特定工具链。

五、使用方法

5.1 基本命令（docker run）

通过 docker run 直接执行 az 命令，语法为：
docker run [选项] oowy/azure-cli:[标签] az [子命令] [参数]

示例 1：查看 Azure CLI 版本

docker run --rm oowy/azure-cli:latest az --version

示例 2：登录 Azure 账户（需交互输入凭据）

docker run -it --rm oowy/azure-cli:latest az login

示例 3：列出 Azure 资源组（需先登录并挂载配置）

# 挂载本地 Azure 配置目录（包含登录凭据）到容器
docker run --rm -v ~/.azure:/root/.azure oowy/azure-cli:latest az group list

5.2 Docker Compose 配置示例

创建 docker-compose.yml 文件，定义常用 Azure CLI 操作环境：

version: '3'
services:
  azure-cli:
    image: oowy/azure-cli:latest
    volumes:
      - ~/.azure:/root/.azure  # 挂载本地配置（包含凭据）
      - ./workspace:/workspace  # 挂载工作目录（如需处理本地文件）
    working_dir: /workspace  # 设置工作目录
    environment:
      - AZURE_CONFIG_DIR=/root/.azure  # 指定配置目录（可选，默认已设置）
    # 可通过 command 直接指定要执行的 az 命令
    command: az group list --output table

运行：

docker-compose up

六、配置说明

6.1 挂载配置文件

Azure CLI 的配置（如登录凭据、默认订阅等）默认存储在 ~/.azure 目录。为使容器内 az 命令访问本地配置，需将该目录挂载到容器内的 /root/.azure（容器内默认用户为 root）：

docker run --rm -v ~/.azure:/root/.azure oowy/azure-cli:latest az [命令]

6.2 设置工作目录

如需在容器内处理本地文件（如部署脚本），可通过 -w 参数指定工作目录，并挂载本地目录：

docker run --rm -v $(pwd):/workspace -w /workspace oowy/azure-cli:latest az deployment group create --template-file ./template.json

6.3 环境变量

可通过 -e 参数传递环境变量，自定义 Azure CLI 行为，常用变量包括：

• AZURE_CONFIG_DIR：指定配置文件存储路径（默认 /root/.azure）。
• AZURE_CLI_DISABLE_CONNECTION_VERIFICATION：禁用 SSL 连接验证（调试场景使用，默认 false）。
• AZURE_SUBSCRIPTION_ID：设置默认 Azure 订阅 ID，避免每次命令指定 --subscription。

示例：

docker run --rm -e AZURE_SUBSCRIPTION_ID=xxxx-xxxx-xxxx -v ~/.azure:/root/.azure oowy/azure-cli:latest az vm list

6.4 自定义基础镜像

如需预配置 CLI 设置（如默认输出格式、日志级别），可基于本镜像构建自定义镜像。示例 Dockerfile：

FROM oowy/azure-cli:latest

# 预设置默认输出格式为 table
RUN az config set core.output=table

# 预安装额外工具（如 jq，用于 JSON 解析）
RUN apk add --no-cache jq

构建并使用：

docker build -t my-custom-azure-cli .
docker run --rm my-custom-azure-cli az group list  # 输出已默认转为 table 格式

七、社区支持

• 问题反馈：关于 Azure CLI 工具本身的问题，可在 Azure CLI 官方仓库 提交 issue。
• Docker 镜像问题：可联系维护者 Oowy 团队 或通过 Docker 社区渠道（如 Docker Community Slack）获取帮助。