Rust应用打包为distroless Docker镜像运行时提示libpq.so.5缺失如何解决

Rust默认编译产出的是动态链接二进制，并非所有场景下都是无外部依赖的独立文件。你使用了PostgreSQL数据库驱动相关依赖，这类库默认会动态链接系统的libpq（PostgreSQL客户端库）。
你的构建阶段使用的rust:1.54镜像内置了libpq.so.5，但运行阶段使用的gcr.io/distroless/cc镜像仅包含最基础的C语言运行时，没有携带libpq相关依赖，因此启动时会抛出找不到共享库的报错。

以下三种方案可按需选择：

• 方案一：编译全静态二进制
  直接将Rust应用编译为完全静态的musl目标，产出的二进制无任何动态依赖，可直接在distroless镜像中运行。修改后的Dockerfile调整如下：

  # build stage
  FROM rust:1.54 as builder
  LABEL maintainer="jiangtingqiang@gmail.com"
  ENV ROCKET_ADDRESS=0.0.0.0
  ENV ROCKET_PORT=11014
  WORKDIR /app
  COPY . /app
  # 安装musl编译目标和依赖
  RUN rustup default stable && rustup target add x86_64-unknown-linux-musl
  RUN apt update && apt install -y musl-tools libpq-dev
  # 静态编译
  RUN cargo build --release --target x86_64-unknown-linux-musl
  
  # Prod stage
  FROM gcr.io/distroless/cc
  COPY --from=builder /app/target/x86_64-unknown-linux-musl/release/reddwarf_music /
  CMD ["./reddwarf_music"]
  

• 方案二：运行镜像补充缺失依赖
  不想修改编译逻辑的话，可以将构建阶段的libpq及其依赖的共享库拷贝到运行镜像中，或者直接换用自带PostgreSQL客户端依赖的轻量基础镜像：
  拷贝依赖示例：

  # Prod stage
  FROM gcr.io/distroless/cc
  COPY --from=builder /usr/lib/x86_64-linux-gnu/libpq.so.5 /usr/lib/x86_64-linux-gnu/
  COPY --from=builder /usr/lib/x86_64-linux-gnu/libssl.so.1.1 /usr/lib/x86_64-linux-gnu/
  COPY --from=builder /usr/lib/x86_64-linux-gnu/libcrypto.so.1.1 /usr/lib/x86_64-linux-gnu/
  COPY --from=builder /app/target/release/reddwarf_music /
  CMD ["./reddwarf_music"]
  

  也可以直接用alpine作为运行镜像，安装postgresql13-client包即可，最终镜像体积仅几十M，兼容性更好。
• 方案三：替换为纯Rust实现的PG驱动
  如果你使用的是sqlx等支持纯Rust驱动的库，可以关闭依赖系统libpq的特性，改用纯Rust实现的PostgreSQL驱动，编译后自然不会产生对libpq.so.5的动态依赖。

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