如何缩减基于Alpine的Azure-CLI Docker镜像体积？

原Dockerfile的问题分析 #

原构建脚本存在重复执行apk update、构建依赖管理混乱、未彻底清理缓存等问题，加上pip安装Azure-CLI会引入大量编译依赖和缓存文件，导致镜像体积激增。以下是具体优化方案：

优化方案一：精简单阶段构建（适合快速调整） #

通过合并命令、清理缓存、优化依赖管理来缩减体积，优化后的Dockerfile如下：

FROM alpine:latest

WORKDIR /workspace

ENV PIP_ROOT_USER_ACTION=ignore

RUN apk update && \
    # 安装运行时必需的工具
    apk add --no-cache git git-lfs zip bash aws-cli python3 py3-pip && \
    git lfs install && \
    # 用虚拟包统一安装构建依赖
    apk add --no-cache --virtual .build-deps gcc libffi-dev musl-dev openssl-dev python3-dev make && \
    # pip安装时禁用缓存，避免残留文件
    pip3 install --no-cache-dir azure-cli && \
    # 删除所有构建依赖
    apk del --purge .build-deps && \
    # 彻底清理各类缓存和无用文件
    rm -rf /var/cache/apk/* && \
    rm -rf ~/.cache/pip && \
    rm -rf /usr/share/man /usr/share/doc /usr/share/info

关键优化点：

• 合并所有apk操作，减少镜像层数量，避免重复更新索引。
• 使用.build-deps虚拟包管理构建依赖，一次性删除所有编译工具，无残留。
• pip install添加--no-cache-dir参数，不保留下载的包缓存。
• 删除系统文档、缓存等无用文件，进一步压缩体积。

优化方案二：多阶段构建（推荐，体积缩减效果最显著） #

将构建环境与最终运行环境完全分离，仅复制必要的可执行文件和依赖到干净镜像，彻底剥离构建过程中的冗余内容：

# 第一阶段：构建/安装所有工具
FROM alpine:latest AS builder

WORKDIR /tmp/build

RUN apk update && \
    apk add --no-cache git git-lfs zip bash aws-cli python3 py3-pip && \
    git lfs install && \
    apk add --no-cache --virtual .build-deps gcc libffi-dev musl-dev openssl-dev python3-dev make && \
    pip3 install --no-cache-dir azure-cli && \
    apk del --purge .build-deps && \
    rm -rf /var/cache/apk/* && \
    rm -rf ~/.cache/pip && \
    rm -rf /usr/share/man /usr/share/doc

# 第二阶段：仅保留运行必需的内容到干净镜像
FROM alpine:latest

WORKDIR /workspace

# 从builder阶段复制核心工具和依赖
COPY --from=builder /usr/bin/git /usr/bin/git
COPY --from=builder /usr/bin/git-lfs /usr/bin/git-lfs
COPY --from=builder /usr/bin/zip /usr/bin/zip
COPY --from=builder /usr/bin/bash /usr/bin/bash
COPY --from=builder /usr/bin/aws /usr/bin/aws
COPY --from=builder /usr/bin/az /usr/bin/az
COPY --from=builder /usr/lib/python3.11/site-packages /usr/lib/python3.11/site-packages
COPY --from=builder /usr/share/azure-cli /usr/share/azure-cli

ENV PATH="/usr/bin:$PATH"
ENV PIP_ROOT_USER_ACTION=ignore

关键优化点：

• 构建阶段完成所有安装和清理后，仅将运行时必需的二进制文件、Python依赖包复制到最终镜像。
• 最终镜像完全不包含构建工具、缓存文件，体积能大幅降低（通常比单阶段再缩减30%-50%）。

额外建议：使用Alpine官方Azure-CLI包（如果可用） #

部分Alpine版本的仓库中已提供预编译的azure-cli包，直接用apk add azure-cli替代pip安装，能避免编译过程，进一步减少体积：

FROM alpine:latest

WORKDIR /workspace

RUN apk update && \
    apk add --no-cache git git-lfs zip bash aws-cli azure-cli && \
    git lfs install && \
    rm -rf /var/cache/apk/* && \
    rm -rf /usr/share/man /usr/share/doc

内容的提问来源于stack exchange，提问作者raj03