cloudhotspot/devpi

Devpi Docker镜像

https://images.microbadger.com/badges/image/cloudhotspot/devpi.svg](https://microbadger.com/images/cloudhotspot/devpi "在microbadger.com获取你的镜像徽章")

本仓库包含一个Dockerfile，用于构建基于Alpine Linux的轻量级Devpi服务器。当前发布的镜像大小约29MB，虚拟大小约90MB。

镜像概述

Devpi是一个Python包管理工具，可用于缓存PyPI包、管理私有包索引，提升Python项目依赖安装效率。本镜像基于Alpine Linux，体积小巧，易于部署和维护。

核心功能

1. 轻量级：基于Alpine Linux，镜像体积小，启动速度快。
2. 初始化配置：支持通过环境变量设置root密码、添加用户及创建索引。
3. 数据持久化：可通过卷挂载保存Devpi服务器数据。
4. 备份导入：支持导入.bz2格式的Devpi备份文件。
5. 自定义配置：可修改端口、数据目录等参数。

使用场景

• 企业内部Python项目依赖管理，缓存公共PyPI包以加速安装。
• 搭建私有Python包索引，存储内部开发的包。
• 快速部署Devpi服务器用于测试或开发环境。

配置说明

初始化

镜像将Devpi服务器目录配置为/var/lib/devpi。若无现有数据，会通过以下环境变量初始化：

• DEVPI_ROOT_PASSWORD：设置root用户密码，未提供则生成32位随机密码。
• DEVPI_USER：添加新用户（若从备份恢复且用户已存在则不操作）。
• DEVPI_PASSWORD：设置新用户密码（若用户已存在则更新密码）。
• DEVPI_INDEX：为用户创建基于root/pypi的索引，路径为$DEVPI_USER/$DEVPI_INDEX。

示例：设置DEVPI_USER=dev、DEVPI_PASSWORD=xyz123、DEVPI_INDEX=root，索引路径为http://<server>:<port>/dev/root。

运行镜像

镜像的entrypoint为： devpi-server --serverdir /var/lib/devpi --restrict-modify root --host 0.0.0.0

可添加额外参数： docker run -d --name devpi cloudhotspot/devpi <arg> [<arg> ...]

默认网络

Devpi默认监听3141端口，需映射端口： docker run -d --name devpi -p 3141:3141 cloudhotspot/devpi

自定义端口： docker run -d --name devpi -p 8000:8000 -e DEVPI_PORT=8000 cloudhotspot/devpi

数据目录

默认数据目录为/var/lib/devpi-server，可通过DEVPI_SERVERDIR覆盖： docker run -d --name devpi -e DEVPI_SERVERDIR=/mnt/devpi -e DEVPI_PORT=8000 -p 8000:8000 cloudhotspot/devpi

导入服务器状态

entrypoint会处理/devpi-init.d目录下的所有.bz2文件，提取并导入到Devpi。导入过程可能耗时，可通过docker logs查看进度。参考Devpi服务器管理文档了解导出/导入细节。

Docker Compose示例

以下是示例docker-compose.yml文件（假设已准备backup.bz2备份文件并设置DEVPI_PASSWORD环境变量）：

1. 创建外部卷：docker volume create --name devpi_data
2. 启动服务：docker-compose up -d（Devpi将运行在8000端口）
3. 数据将持久化到devpi_data卷。

yaml
version: '2'

volumes:
  devpi_data:
    external: true

services:
  devpi:
    image: cloudhotspot/devpi
    volumes:
      - devpi_data:/var/lib/devpi
      - ./backup.bz2:/devpi-init.d/backup.bz2
    ports:
      - "8000:8000"
    stop_signal: SIGINT
    environment:
      DEVPI_USER: dev
      DEVPI_PASSWORD: ${DEVPI_PASSWORD}
      DEVPI_PORT: "8000"