1. 授权认证
  2. 获取用户个人信息
  3. 项目协同
  4. 代码托管
  5. 持续集成
  6. 制品仓库
  7. 测试管理
  8. 文档管理
  1. 项目协同
  2. 代码仓库
  3. DevOps 实践之旅
  4. 一分钟开始持续集成之旅
  5. 持续部署
  6. 制品库

使用 PyPI 制品仓库

该文档介绍如何将 PyPI 类型制品存储在 CODING 制品库中,方便团队在项目进行统一的制品管理与版本控制。下文包含如何进行制品制作、认证配置与制品推拉。

阅读该篇文档需要准备好以下内容:

初始化本地 PyPI 项目

  1. 新建 Demo 目录作为本地 PyPI 包的地址。在终端中运行命令创建 Demo 项目文件夹。
mkdir -p demo/example_pkg/__init__.py
  1. 进入 demo 目录,创建 setup.py 文件。
cd demo && touch setup.py
  1. setup.py 文件中粘贴配置内容。
import setuptools

setuptools.setup(
    name="example-pkg-YOUR-USERNAME-HERE", # Replace with your own username
    version="0.0.1",
    author="Example Author",
    author_email="author@example.com",
    description="A small example package",
    url="https://github.com/pypa/sampleproject",
    packages=setuptools.find_packages(),
    classifiers=[
        "Programming Language :: Python :: 3",
        "License :: OSI Approved :: MIT License",
        "Operating System :: OS Independent",
    ],
    python_requires='>=3.6',
)
  1. 安装 setuptoolswheel 工具。
python3 -m pip install --user --upgrade setuptools wheel
  1. 打包项目
python3 setup.py sdist bdist_wheel

打包项目后,会在 /dist 目录下生成以下两个文件,用于推送到制品仓库:

└─npm
    ├─example_pkg_YOUR_USERNAME_HERE-0.0.1-py3-none-any.whl
    ├─example_pkg_YOUR_USERNAME_HERE-0.0.1.tar.gz

配置制品库认证信息

推送至 CODING 制品库之前,需在本地文件中添加相应的认证信息。您可以通过「自动生成配置」或「手动配置」两种方式进行认证。在进行操作前,请使用命令 cd / 前往根目录,输入 ls -a 查看是否存在 .pypircpip.conf 文件。

如果没有的话,输入以下命令以新建两个文件。

touch .pypirc && touch pip.conf

自动生成配置

  1. 点击网页上的【使用访问令牌生成配置】,系统会自动帮您生成访问凭据。若需查看个人令牌,则前往【个人账户设置】->【访问令牌】处进行管理。

  1. 输入登录密码后确认,得到配置内容。

将配置内容复制进入根目录的 .pypircpip.conf 文件中。

手动配置

按照网页上的指引提示,复制相关代码至特定文件中。

推送

进入项目目录,如上文中新建的 Demo 目录,复制网页上的命令后在终端执行,即可把 Demo/dist 目录下的所有制品推送至制品库。

twine upload -r coding-pypi dist/*

推送成功后,刷新仓库页面,您可以看到最新推送的制品。

拉取

根据 PyPI 制品仓库中具体制品的拉取指引可以执行 pip install 拉取制品。

pip install <制品名>

设置代理

当 CODING 私有制品仓库不存在想要拉取的制品时,将尝试从配置的代理地址拉取。您可以添加第三方制品源,用以获取特定仓库中的制品。无需额外设置,CODING 将会按照顺序从上到下依次检索相应的制品包。

使用网页上生成的命令,替换 < package > 的包名,完成拉取。

拉取的制品及依赖会成功拉取到本地,并且还会同步至 CODING 制品仓库中,详情页会显示包的来源。

代理设置的详细说明,请参考《制品代理》

上一篇Maven 制品库
最近更新
感谢反馈有用
感谢反馈没用