CNB 文档

简体中文

English

简体中文

English

外观

PyPI 制品库

复制页面

1614 字约 5 分钟

PyPI 制品库用于存储和分发 Python 软件包，开发者可以通过它上传、管理和安装各种 Python 第三方库和工具。

前置准备

  1. 创建制品库

  2. 获取制品库的地址

  3. 创建令牌

本地开发

配置拉取凭据

  • 方案 1：在 ~/.pip/pip.conf（MacOS/Linux）或者 %HOME%\pip\pip.ini（Windows）中添加 pip 源配置：
[global]
# YOUR_TOKEN: 访问令牌的 password; REPO_URL: 制品库地址
# 示例: index-url = https://cnb:<YOUR_TOKEN>@pypi.cnb.build/cnb/pypi-repo/-/packages/simple
index-url = https://cnb:<YOUR_TOKEN>@<REPO_URL>
  • 方案 2：也可以使用命令行设置：
# YOUR_TOKEN: 访问令牌的 password; REPO_URL: 制品库地址
# 示例: pip config set global.index-url https://cnb:<YOUR_TOKEN>@pypi.cnb.build/cnb/pypi-repo/-/packages/simple
pip config set global.index-url https://cnb:<YOUR_TOKEN>@<REPO_URL>

配置推送凭据

twine 配置

请在 ~/.pypirc 文件中添加以下配置

[distutils]
index-servers =
  cnb-pypi-repo
[cnb-pypi-repo]
# 制品库地址
repository: <REPO_URL>
username: cnb
# 访问令牌的 password
password: <YOUR_TOKEN>

示例:

[distutils]
index-servers =
  cnb-pypi-repo
[cnb-pypi-repo]
repository: https://pypi.cnb.build/cnb/pypi-repo/-/packages/simple
username: cnb
password: "<YOUR_TOKEN>"

拉取制品

#示例1: pip install requests
#示例2: 拉取指定版本 pip install requests==2.30.1
pip install <PACKAGE_NAME>

# 示例, 临时源拉取 pip install -i https://cnb:<YOUR_TOKEN>@pypi.cnb.build/cnb/pypi-repo/-/packages/simple requests
pip install -i https://cnb:<YOUR_TOKEN>@<REPO_URL> <PACKAGE_NAME>

编译及推送制品

twine
python -m build  
twine upload -r cnb-pypi-repo dist/*

云原生构建

拉取制品

  • 方案1: 使用内置的 CNB_TOKEN 环境变量:
.cnb.yml
main:
  push:
    - docker:
        image: docker.cnb.cool/examples/language/python-3:latest 
      stages:
        - name: 拉取制品
          script:
            # 制品库地址
            # 示例: pip config set global.index-url https://cnb:${CNB_TOKEN}@pypi.cnb.build/cnb/pypi-repo/-/packages/simple
            - pip config set global.index-url https://cnb:${CNB_TOKEN}@<REPO_URL>
            # 示例: pip install requests
            - pip install <PACKAGE_NAME>
  • 方案2: 使用密钥仓库文件:
.cnb.yml
main:
  push:
    - docker:
        image: docker.cnb.cool/examples/language/python-3:latest
      imports:
        # 引入密钥仓库配置文件
        - <SECRET_REPO_URL> 
      stages:
        - name: 拉取制品
          script:
            - pip config set global.index-url https://<USER_NAME>:<PASS_WORD>@<REPO_URL>
            - pip install <PACKAGE_NAME>

示例:

.cnb.yml
main:
  push:
    - docker:
        image: docker.cnb.cool/examples/language/python-3:latest
      imports:
        - https://cnb.build/cnb-demo/env-demo/-/blob/main/envs/env.yml 
      stages:
        - name: 拉取制品
          script:
            # 引入密钥仓库配置文件，以环境变量的形式注入 USER_NAME 和 PASS_WORD 的值
            - pip config set global.index-url https://${USER_NAME}:${PASS_WORD}@pypi.cnb.build/cnb/pypi-repo/-/packages/simple
            - pip install requests

推送制品

twine 配置
  • 方案1: 使用内置的 CNB_TOKEN 环境变量:
.cnb.yml
main: 
  push: 
    - docker:
        image: docker.cnb.cool/examples/language/python-3:latest
      stages:
        - name: 打包 & 上传至仓库
          script:
            - export TWINE_USERNAME=${CNB_TOKEN_USER_NAME} 
            - export TWINE_PASSWORD=${CNB_TOKEN}
            # 制品库地址
            # 示例: export TWINE_REPOSITORY_URL=https://pypi.cnb.build/cnb/pypi-repo/-/packages/simple 
            - export TWINE_REPOSITORY_URL=<REPO_URL>
            - python -m build
            - twine upload dist/*
  • 方案2: 使用密钥仓库文件
.cnb.yml
main:
  push:
    - docker:
        image: docker.cnb.cool/examples/language/python-3:latest
      imports:
        # 密钥仓库文件地址
        # 示例: https://cnb.build/cnb-demo/env-demo/-/blob/main/envs/env.yml
        - <SECRET_REPO_URL> 
      stages:
        - name: 打包 & 上传至仓库
          script:
            # 密钥仓库文件 USER_NAME 配置
            - export TWINE_USERNAME=${USER_NAME}
            # 密钥仓库文件 PASS_WORD 配置
            - export TWINE_PASSWORD=${PASS_WORD}
            # 制品库地址
            # 示例: export TWINE_REPOSITORY_URL=https://pypi.cnb.build/cnb/pypi-repo/-/packages/simple
            - export TWINE_REPOSITORY_URL=<REPO_URL>
            - python -m build
            - twine upload dist/*

云原生开发

前置准备工作

请在 .cnb.yml 文件中添加以下配置

.cnb.yml
  $:
    vscode:
      - docker:
          image: docker.cnb.cool/examples/language/python-3:latest
        services:
          - vscode
          - docker
        # 使用密钥仓库文件则需要填入以下配置  
        imports:
          # 示例: https://cnb.build/cnb-demo/env-demo/-/blob/main/envs/env.yml
          - <SECRET_REPO_URL>

配置拉取凭据

  • 方案1: 使用内置的 CNB_TOKEN 环境变量:
# 示例: pip config set global.index-url https://cnb:${CNB_TOKEN}@pypi.cnb.build/cnb/pypi-repo/-/packages/simple
pip config set global.index-url https://cnb:${CNB_TOKEN}@<REPO_URL>
  • 方案2: 使用密钥仓库文件:
# 示例: pip config set global.index-url https://${USER_NAME}:${PASS_WORD}@pypi.cnb.build/cnb/pypi-repo/-/packages/simple
pip config set global.index-url https://${USER_NAME}:${PASS_WORD}@<REPO_URL>

配置推送凭据

云原生开发 TERMINAL 中输入以下命令

twine
  • 方案1: 使用内置的 CNB_TOKEN 环境变量:
export TWINE_USERNAME=${CNB_TOKEN_USER_NAME} 
export TWINE_PASSWORD="${CNB_TOKEN}"
# 制品库地址
# 示例: export TWINE_REPOSITORY_URL=https://pypi.cnb.build/cnb/pypi-repo/-/packages/simple 
export TWINE_REPOSITORY_URL=<REPO_URL>
  • 方案2: 使用密钥仓库文件:
# 密钥仓库文件 USER_NAME 配置
export TWINE_USERNAME="${USER_NAME}" 
# 密钥仓库文件 PASS_WORD 配置
export TWINE_PASSWORD="${PASS_WORD}"
# 制品库地址
# 示例: export TWINE_REPOSITORY_URL=https://pypi.cnb.build/cnb/pypi-repo/-/packages/simple   
export TWINE_REPOSITORY_URL=<REPO_URL>

拉取制品

#示例1: pip install requests
#示例2: 拉取指定版本 pip install requests==2.30.1
pip install <PACKAGE_NAME>

# 示例: 临时源拉取 pip install -i https://cnb:${CNB_TOKEN}@pypi.cnb.build/cnb/pypi-repo/-/packages/simple requests
pip install -i https://cnb:${CNB_TOKEN}@<REPO_URL> <PACKAGE_NAME>

编译及推送制品

twine
python -m build  
twine upload -r cnb-pypi-repo dist/*

FAQ

Q:为什么我上传时会报 409 的错误

A: 您上传的制品包名称和版本已存在，请将制品仓库的版本覆盖策略设置为允许覆盖已有版本，或更改包版本后重新上传。

Q:为什么我上传时会报 400 的错误

A: 一般是制品文件名不符合 PyPI 规范，请检查并处理后重新上传。

Q:CNB PyPI 制品仓库目前支持哪些 PyPI 制品格式

A: 目前仅支持 wheel 和 sdist 两种格式的制品包，egg、exe 等旧格式的制品包会被拒绝上传。

更多用法

更多 PyPI 用法，请查阅 PyPI 官方文档。

© 2026 cnb.cool