如何在多个Dockerfile及代码仓库间共享Python库文件？

1. 封装为内部私有PyPI包 #

把共享库做成Bitbucket私有PyPI包，每个应用直接通过依赖安装，完全不用改现有仓库：

• 给共享库添加setup.py或pyproject.toml打包配置，上传到Bitbucket的私有包仓库；
• 在每个应用的Dockerfile里配置私有PyPI源，执行pip install安装共享包，比如：

  RUN pip install --index-url https://<你的Bitbucket账号>:<token>@api.bitbucket.org/2.0/repositories/<库仓库路径>/packages/pypi/simple/ shared-lib==1.0.0
  

• 好处：依赖管理标准化，后续更新共享库只需要发布新版本，各应用按需升级即可。

2. 多阶段构建拉取共享库 #

在应用的Dockerfile里用多阶段构建，先拉取共享库代码再复制到应用环境：

# 拉取共享库的临时阶段
FROM alpine/git AS lib-source
WORKDIR /shared-lib
RUN git clone --branch stable https://<Bitbucket账号>@bitbucket.org/<库仓库路径>.git .

# 应用构建阶段
FROM python:3.10-slim
WORKDIR /app
# 把共享库复制到Python的site-packages目录
COPY --from=lib-source /shared-lib /usr/local/lib/python3.10/site-packages/
# 复制应用代码并安装自身依赖
COPY . .
RUN pip install -r requirements.txt
CMD ["python", "run.py"]

• 可指定克隆的分支或标签，避免拉取未稳定的代码；如果共享库需要编译，可在临时阶段先完成编译再复制。

3. 构建时传递共享库上下文 #

利用Docker BuildKit的--build-context参数，构建应用时直接引入共享库仓库，不用修改应用的Dockerfile核心逻辑：

• 构建命令：docker build --build-context shared-lib=https://bitbucket.org/<库仓库路径>.git#stable -t my-app-image .
• 应用Dockerfile中复制共享库：

  FROM python:3.10-slim
  WORKDIR /app
  COPY --from=shared-lib / /usr/local/lib/python3.10/site-packages/
  COPY . .
  RUN pip install -r requirements.txt
  CMD ["python", "app.py"]
  

• 优势：应用代码和Dockerfile完全不用动，只需要在CI/CD的构建步骤里添加参数即可。

这三个方案都能满足你不调整仓库结构的需求，其中私有PyPI包的方式最符合Python生态的最佳实践，长期维护成本最低。

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