如何将Shell脚本特定命令移植到Dockerfile并缩小镜像体积

问题背景 #

需要将Shell脚本中编译安装libdatachannel的逻辑移植到Dockerfile中，但直接运行完整脚本会导致镜像体积过大，需优化镜像大小。

原Shell脚本逻辑 #

原脚本负责检查libdatachannel是否已安装，若未安装则拉取指定版本源码，根据系统环境配置编译参数，最终编译安装：

# Build & Install libdatachannel
if ! cmake --find-package -DNAME=LibDataChannel -DCOMPILER_ID=GNU -DLANGUAGE=CXX -DMODE=EXIST >/dev/null 2>/dev/null && \
    should_build "libdatachannel" "for the webrtc node-type"; then
    git clone ${GIT_OPTS} --recursive --branch v0.18.4 https://github.com/paullouisageneau/libdatachannel.git
    mkdir -p libdatachannel/build
    pushd libdatachannel/build

    if pkg-config "nice >= 0.1.16"; then
        CMAKE_DATACHANNEL_USE_NICE=-DUSE_NICE=ON
    fi

    cmake -DNO_MEDIA=ON \
          -DNO_WEBSOCKET=ON \
          ${CMAKE_DATACHANNEL_USE_NICE-} \
          ${CMAKE_OPTS} ..
    make ${MAKE_OPTS} install
    popd
fi

失败尝试的问题 #

之前的尝试存在以下问题：

1. 单独RUN定义的FLAGS变量无法跨RUN生效（每个RUN是独立shell环境）
2. 未保留原脚本中的条件判断逻辑（检查libdatachannel是否存在、nice库版本）
3. 未清理编译临时文件，导致镜像体积冗余

RUN  FLAGS+=" -DUSE_NICE=ON" 

COPY . /villas

WORKDIR /villas/build
RUN cmake ${FLAGS} -S .. && \
    make -j$(nproc) install && \
    ldconfig

优化解决方案 #

采用多阶段构建分离编译与运行环境，同时合并命令清理临时文件，最大化缩小镜像体积：

完整Dockerfile示例 #

# 编译阶段：使用包含编译工具的基础镜像
FROM debian:bookworm-slim AS builder

# 安装编译依赖，安装后立即清理apt缓存
RUN apt-get update && apt-get install -y --no-install-recommends \
    git cmake make gcc g++ pkg-config libnice-dev \
    && rm -rf /var/lib/apt/lists/*

# 定义原脚本中的环境变量
ENV GIT_OPTS=""
ENV MAKE_OPTS="-j$(nproc)"
ENV CMAKE_OPTS=""

# 合并所有编译逻辑为单个RUN，执行后立即清理临时文件
RUN if ! cmake --find-package -DNAME=LibDataChannel -DCOMPILER_ID=GNU -DLANGUAGE=CXX -DMODE=EXIST >/dev/null 2>&1; then \
        git clone ${GIT_OPTS} --recursive --branch v0.18.4 https://github.com/paullouisageneau/libdatachannel.git; \
        mkdir -p libdatachannel/build; \
        cd libdatachannel/build; \
        CMAKE_DATACHANNEL_USE_NICE=""; \
        if pkg-config "nice >= 0.1.16"; then \
            CMAKE_DATACHANNEL_USE_NICE="-DUSE_NICE=ON"; \
        fi; \
        cmake -DNO_MEDIA=ON -DNO_WEBSOCKET=ON ${CMAKE_DATACHANNEL_USE_NICE} ${CMAKE_OPTS} ..; \
        make ${MAKE_OPTS} install; \
        cd ../..; \
        # 清理源码和编译临时文件
        rm -rf libdatachannel; \
    fi

# 最终运行阶段：使用轻量基础镜像
FROM debian:bookworm-slim

# 从编译阶段复制libdatachannel的产物
COPY --from=builder /usr/local/lib /usr/local/lib
COPY --from=builder /usr/local/include /usr/local/include
COPY --from=builder /usr/local/bin /usr/local/bin

# 更新系统库缓存
RUN ldconfig

# 复制并编译你的应用
COPY . /villas
WORKDIR /villas/build
RUN cmake -S .. && make -j$(nproc) install && ldconfig && \
    # 清理应用编译临时文件
    rm -rf /villas/build

关键优化点 #

• 多阶段构建：编译阶段仅负责生成产物，最终镜像仅保留运行必需的文件，大幅减少体积。
• 单RUN合并命令：将编译、安装、清理逻辑放在同一个RUN中，避免生成冗余镜像层，同时清理所有临时文件。
• 保留条件逻辑：完整保留原脚本中检查libdatachannel是否存在、检测nice库版本的判断逻辑。
• 依赖清理：安装编译依赖后立即删除apt缓存，编译完成后删除源码和临时文件，避免残留无用内容。

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