lordgaav/devpi

devpi Docker镜像

镜像概述和主要用途

此Docker镜像为即用型devpi服务镜像，用于快速搭建Python包管理和私有PyPI服务。devpi是一个功能强大的Python包索引服务器，支持包缓存、私有包存储、版本管理及用户权限控制。本镜像包含devpi核心组件及多种扩展插件，可直接部署使用，简化Python包管理流程。

核心功能和特性

• 包含完整的devpi生态组件：devpi-server（服务端）、devpi-web（Web界面）、devpi-client（客户端工具）
• 集成多种扩展插件：
  • devpi-semantic-ui：提供现代化Web界面
  • devpi-ldap：支持LDAP用户认证集成
  • devpi-findlinks：增强包查找功能
  • devpi-cleaner：清理过期包和缓存数据
  • devpi-slack：Slack通知集成
  • devpi-lockdown：增强安全限制功能

使用场景和适用范围

• 企业或团队内部搭建私有PyPI服务，管理内部Python包
• 需要缓存公共PyPI包以提高下载速度和稳定性的开发环境
• 需通过LDAP集成企业身份认证系统的包管理场景
• 需要自动化清理过期包、发送通知的Python开发团队

使用方法和配置说明

基本启动

devpi需要持久化存储包和数据，需映射卷到宿主机目录，并暴露TCP端口3141。

bash
docker run -d -p 3141:3141 -v /some/place:/devpi \
--name devpi-server lordgaav/devpi:latest

首次运行时，启动脚本会为root用户生成密码，并存储在卷目录下的.root_password文件中。

LDAP插件配置

如需使用LDAP认证，需将LDAP配置文件（YAML格式）映射到容器内，并通过参数指定配置文件路径：

bash
docker run -d -p 3141:3141 -v /some/place:/devpi -v /path/to/ldap.yml:/ldap.yml \
--name devpi-server lordgaav/devpi:latest --ldap-config=/ldap.yml

devpi-client辅助工具

容器内置辅助脚本，可通过docker exec操作运行中的容器，自动以root用户登录执行命令：

执行devpi命令

bash
docker exec -it devpi-server devpi-client -h

输出示例：

logged in 'root', credentials valid for 10.00 hours
usage: /usr/local/bin/devpi [-h] [--version] [--debug] [-y] [-v]
                            [--clientdir DIR]
                            {quickstart,use,getjson,patchjson,list,remove,user,login,logoff,index,upload,test,push,install,refresh}
...

启动交互式shell

bash
docker exec -it devpi-server devpi-client bash

进入后会自动登录root用户：

logged in 'root', credentials valid for 10.00 hours
root@c4fa8a7b14cf:/#