aristanetworks/devpi

devpi: PyPI服务器及打包/测试/发布工具

镜像概述和主要用途

devpi是一个完整的PyPI服务器及打包/测试/发布系统，包含服务端和客户端组件，用于搭建本地或团队内部的Python包管理服务。它能够提供与pypi.org兼容的缓存索引，支持创建用户或团队专属索引，并允许索引间的包继承，同时提供Web界面和命令行工具简化包管理流程。

核心功能和特性

核心组件

devpi系统由三个核心包组成：

• devpi-server
  提供与pypi.org兼容的缓存索引服务，支持创建用户或团队专属索引。这些索引可以相互继承，或从pypi.org继承包，实现包的层级管理和本地缓存。

• devpi-web
  devpi-server的插件，提供Web界面和搜索功能，方便用户通过浏览器查看包信息、管理索引和用户。

• devpi-client
  命令行工具，支持用户创建、索引管理、包上传/安装，以及通过"test"子命令调用tox进行测试等操作。

使用场景和适用范围

• 本地PyPI镜像：缓存pypi.org包，加速本地Python项目依赖安装，减少网络请求。
• 团队包管理：为团队创建私有索引，管理内部开发的Python包，控制包版本和访问权限。
• 开发测试流程：集成测试工具（如tox），简化包的测试、上传和发布流程。
• 离线环境：在无网络环境中提供PyPI包服务，确保项目依赖可访问。

使用方法和配置说明

基本部署（docker run）

bash
# 运行devpi-server，映射数据卷和端口
docker run -d \
  --name devpi-server \
  -p 3141:3141 \
  -v devpi-data:/data \
  devpi/devpi-server

docker-compose配置示例

yaml
version: '3'
services:
  devpi:
    image: devpi/devpi-server
    container_name: devpi-server
    ports:
      - "3141:3141"
    volumes:
      - devpi-data:/data
    restart: always
    environment:
      - DEVPI_PASSWORD=your-secure-password  # 设置管理员密码（可选）

volumes:
  devpi-data:  # 持久化存储devpi数据

核心配置参数

客户端使用示例

1. 安装devpi-client

   bash
   pip install devpi-client
   

2. 连接到devpi服务器

   bash
   devpi use http://localhost:3141
   

3. 创建用户和索引

   bash
   # 创建用户
   devpi user -c myuser password=mypassword
   
   # 登录用户
   devpi login myuser --password mypassword
   
   # 创建索引
   devpi index -c myindex bases=root/pypi
   

4. 上传和安装包

   bash
   # 上传包
   devpi upload
   
   # 从自定义索引安装包
   pip install -i http://localhost:3141/myuser/myindex/simple/ mypackage
   

参考文档

更多详细使用说明和高级配置，请参见官方文档：[***]