如何在Distroless Python镜像中安装缺失的Python模块？

错误原因 #

Distroless镜像为了极致精简，移除了/bin/sh等Shell环境，而Docker默认的RUN指令会通过Shell解析命令，因此出现exec: "/bin/sh": stat /bin/sh: no such file or directory错误。

两种可行解决方案 #

方案一：多阶段构建（推荐）

在完整的Python环境中安装依赖，再将依赖目录复制到Distroless镜像中，避免Distroless的环境限制：

# 第一阶段：在标准Python镜像中构建依赖
FROM python:3.11-slim-bookworm AS builder

WORKDIR /app

# 将依赖安装到指定目录，方便后续复制
RUN pip install --trusted-host pypi.org --trusted-host pypi.python.org --trusted-host files.pythonhosted.org \
    --upgrade pip \
    --target=/app/deps \
    requests simplejson python-json-logger

# 第二阶段：使用Distroless镜像作为最终镜像
FROM gcr.io/distroless/python3-debian12:nonroot

# 复制第一阶段构建的依赖
COPY --from=builder /app/deps /app/deps
# 将依赖目录添加到Python模块搜索路径
ENV PYTHONPATH="/app/deps:${PYTHONPATH}"

# 复制你的应用代码（按需添加）
# COPY ./your_app /app

# 设置容器启动命令（按需修改）
# CMD ["your_main_script.py"]

方案二：使用Exec格式的RUN指令

Distroless镜像中存在pip3可执行文件，直接使用RUN的数组格式（无需Shell解析）执行pip命令：

FROM gcr.io/distroless/python3-debian12:nonroot

# 用数组形式指定命令和参数，绕过Shell
RUN ["pip3", "install", "--trusted-host", "pypi.org", "--trusted-host", "pypi.python.org", "--trusted-host", "files.pythonhosted.org", "--upgrade", "pip"]

RUN ["pip3", "install", "--trusted-host", "pypi.org", "--trusted-host", "pypi.python.org", "--trusted-host", "files.pythonhosted.org", "requests", "simplejson", "python-json-logger"]

注意：如果安装的依赖需要编译C扩展，方案二会因Distroless缺少编译器和系统依赖而失败，此时方案一仍是最优选择。

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