mslovy/devpi

docker-devpi镜像说明

镜像概述

本镜像基于devpi PyPI服务器构建，旨在为Docker构建过程中的pip install步骤提供可选的包缓存服务，从而加快构建速度，提升开发效率，同时保证构建流程的稳定性。

核心功能

1. Python包缓存：缓存常用Python依赖包，减少重复下载时间。
2. 加速Docker构建：在Dockerfile中集成该缓存服务，显著缩短pip install环节的耗时。
3. 持久化存储：通过挂载卷保存缓存数据，确保容器重启后状态不丢失。
4. 安全配置：支持设置管理员密码，限制仅root用户可创建索引和用户，降低安全风险。

使用场景

• 本地开发环境中频繁构建Python项目的Docker镜像。
• CI/CD流水线中需要重复安装Python依赖的构建步骤。
• 需要提升团队协作开发中Docker构建效率的场景。

配置说明

部署示例

Docker Run命令

bash
docker run -d --name devpi \
    --publish 3141:3141 \
    --volume /srv/docker/devpi:/data \
    --env=DEVPI_PASSWORD=your_long_secret_password \
    --restart always \
    mslovy/devpi

Docker Compose

可参考项目中的docker-compose.yml文件启动容器，需确保包含端口映射、卷挂载及环境变量配置。

客户端使用

在Dockerfile中添加以下代码，将devpi作为可选缓存源：

Dockerfile
# 安装netcat获取主机IP
RUN apt-get update \
 && apt-get install -y netcat \
 && rm -rf /var/lib/apt/lists/*

# 配置pip使用devpi缓存
RUN export HOST_IP=$(ip route| awk '/^default/ {print $3}') \
 && mkdir -p ~/.pip \
 && echo "[global]" >> ~/.pip/pip.conf \
 && echo "extra-index-url = http://$HOST_IP:3141/app/dev/+simple" >> ~/.pip/pip.conf \
 && echo "[install]" >> ~/.pip/pip.conf \
 && echo "trusted-host = $HOST_IP" >> ~/.pip/pip.conf

上传Python包

为充分利用缓存，需上传依赖包至devpi服务器：

bash
pip wheel --download=packages --wheel-dir=wheelhouse -r requirements.txt
pip install "devpi-client>=2.3.0" \
&& export HOST_IP=$(ip route| awk '/^default/ {print $3}') \
&& if devpi use http://$HOST_IP:3141>/dev/null; then \
       devpi use http://$HOST_IP:3141/root/public --set-cfg \
    && devpi login root --password=$DEVPI_PASSWORD  \
    && devpi upload --from-dir --formats=* ./wheelhouse ./packages; \
else \
    echo "未找到运行中的devpi容器（地址：http://$HOST_IP:3141）"; \
fi

持久化设置

需挂载/data目录作为卷，以保存devpi的状态数据，确保容器重启后缓存不丢失（上述部署命令已包含此配置）。

安全注意事项

• 必须设置DEVPI_PASSWORD：默认创建root用户，需通过环境变量设置强密码，否则者可能上传包执行任意代码。
• 限制修改权限：镜像默认添加--restrict-modify root参数，仅root用户可创建索引和用户，增强安全性。