Docker多阶段构建与挂载方式构建部署C++程序的方案咨询

1. make install 完全可以在Docker构建中使用 #

这是非常推荐的做法，和你本地开发流程完全对齐，不需要修改现有构建逻辑。你可以在构建阶段统一指定CMAKE_INSTALL_PREFIX到固定路径（比如/opt/build_output或者直接用默认的/usr/local），所有自定义依赖和最终二进制都安装到这个路径下，方便后续统一拷贝。

2. 多阶段构建实现无源码最终镜像的方案 #

具体流程 #

第一阶段用完整的构建基础镜像（比如gcc:12-bookworm或者ubuntu:22.04预装build-essential、cmake、pkg-config等构建工具），按依赖顺序编译安装所有库：

• 先编译安装libA
• 再编译安装libB（CMake会自动从安装路径找到libA）
• 再编译安装libC
• 最后编译你的主程序，全部安装到统一前缀
  第二阶段用轻量运行时基础镜像（比如debian:bookworm-slim，比alpine少glibc兼容问题），只把第一阶段安装路径下的二进制、动态库拷贝过来，丢弃所有源码、中间编译产物、构建工具。

依赖完整性校验方法 #

你可以通过两个步骤确保所有依赖都完整：

• 构建第二阶段时执行ldd /path/to/your/binary，检查是否有not found的依赖项，缺的依赖从第一阶段对应路径拷贝即可，也可以直接加一步构建校验：

  RUN ldd /usr/local/bin/your_tool | grep "not found" && exit 1 || exit 0
  

  只要有缺失依赖就直接中断构建，避免出问题
• 对于protobuf、curl这类系统库，你可以直接在运行时镜像里用包管理器安装对应的运行时包（比如libprotobuf32、libcurl4），比手动拷贝更稳妥，版本也统一。

3. 挂载源码构建 vs 多阶段构建的选择 #

多阶段构建是更优方案，挂载源码构建的缺陷非常明显：

• 构建过程依赖宿主机的源码目录，无法在无本地源码的CI/CD环境中独立运行，可复现性差
• 没有从根本上解决最终镜像的体积问题，你还是需要手动把依赖拷贝到镜像里，无法直接得到最小可用镜像
• 容易出现宿主机和容器内构建环境的版本冲突，比如宿主机源码的编译缓存带到容器里导致构建异常
  多阶段构建的所有逻辑都在Dockerfile里声明，完全自包含，构建全程不需要宿主机挂载任何目录，最终镜像只保留运行必须的文件，适合所有部署场景。

示例Dockerfile参考 #

# 第一阶段：构建阶段
FROM gcc:12-bookworm AS builder
# 安装构建依赖
RUN apt update && apt install -y --no-install-recommends \
    cmake \
    pkg-config \
    libcurl4-openssl-dev \
    libprotobuf-dev \
    protobuf-compiler \
    && rm -rf /var/lib/apt/lists/*
# 编译安装libA
COPY libA /src/libA
WORKDIR /src/libA/build
RUN cmake -DCMAKE_INSTALL_PREFIX=/usr/local .. && make -j$(nproc) && make install
# 编译安装libB
COPY libB /src/libB
WORKDIR /src/libB/build
RUN cmake -DCMAKE_INSTALL_PREFIX=/usr/local .. && make -j$(nproc) && make install
# 编译安装libC
COPY libC /src/libC
WORKDIR /src/libC/build
RUN cmake -DCMAKE_INSTALL_PREFIX=/usr/local .. && make -j$(nproc) && make install
# 编译主程序
COPY your_tool /src/your_tool
WORKDIR /src/your_tool/build
RUN cmake -DCMAKE_INSTALL_PREFIX=/usr/local .. && make -j$(nproc) && make install

# 第二阶段：运行时阶段
FROM debian:bookworm-slim
# 安装运行时系统依赖
RUN apt update && apt install -y --no-install-recommends \
    libcurl4 \
    libprotobuf32 \
    && rm -rf /var/lib/apt/lists/*
# 从构建阶段拷贝所有安装的二进制和库
COPY --from=builder /usr/local/bin /usr/local/bin
COPY --from=builder /usr/local/lib /usr/local/lib
# 刷新动态库缓存
RUN ldconfig
# 校验依赖完整性
RUN ldd /usr/local/bin/your_tool | grep "not found" && exit 1 || exit 0
# 入口命令
ENTRYPOINT ["/usr/local/bin/your_tool"]

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