概述
人工完全支持PyPI存储库提供:
- 提供PyPI包从Artifactory到
皮普来自所有存储库类型的命令行工具。 - 计算托管在Artifactory本地存储库中的PyPI包的元数据。
- 访问远程PyPI存储库(例如
https://pypi.org/)通过远程存储库它提供代理和缓存功能。 - 从一个URL访问多个PyPI存储库的能力虚拟存储库。
- 与setuptools以及它的前身distutils用于上传PyPI包的库。
在Windows上运行
要在Windows上使用Artifactory PyPI存储库，请确保设置Python和Pip所需的环境变量。
注意，在Windows平台上，% % \ pip \ pip.ini回家取代了pip.conf文件将在下面的部分中描述，并且应该可以通过您的HOME路径访问。
配置
局部存储库
要创建新的PyPI本地存储库，请从政府模块选择存储库|存储库|本地并点击新建本地存储库并设置包类型来PyPI。
远程存储库
一个远程存储库Artifactory中定义的作为在远程URL上管理的注册中心的缓存代理，例如https://pypi.python.org/。
从远程存储库请求的工件(如.whl文件)将按需缓存。您可以从远程存储库缓存中删除下载的构件，但是您不能手动将构件部署到远程PyPI存储库。
要创建一个存储库来代理远程PyPI存储库，请遵循以下步骤:
- 在政府模块下仓库|仓库|远程，并点击新建远程存储库。
设置包类型来PyPI然后输入库的关键价值。
URL和Registry URL设置取决于您是代理公共外部PyPI存储库，还是代理托管在另一个Artifactory服务器上的PyPI存储库。
对于公共的外部PyPI存储库:改变URL字段https://files.pythonhosted.org/，并设置注册网址字段https://pypi.org/。
对于托管在另一个Artifactory实例上的PyPI存储库:控件中设置远程存储库的PyPI API URL注册网址字段。例如，要代理名为“python项目，由Artifactory实例在https://my.remote.artifactory/artifactory/，你会设置注册网址来https://my.remote.artifactory/artifactory/api/pypi/python-project如下图所示:
PyPI远程存储库URL
你不应该包括
api / pypi或/简单在PyPI远程存储库URL。这些后缀是Artifactory在访问远程存储库时添加的。如果使用自定义PyPI远程存储库，则需要确保它有一个简单的索引(目录列表样式)可以访问
< URL > /简单。点击保存并完成。
远程Artifactory
如果远程存储库也由Artifactory服务器管理，则需要指向它的PyPI API URL注册网址字段。例如,
http://my.remote.artifactory/artifactory/api/pypi/python-project
虚拟存储库
Artifactory中定义的虚拟存储库聚合来自本地和远程存储库的包。
这允许您从为虚拟存储库定义的单个URL访问本地托管的PyPI包和远程代理的PyPI存储库。
要定义虚拟PyPI存储库，请从政府模块，转到存储库|存储库|虚拟，设置其包类型要成为PyPI，请选择要包含到的底层本地和远程PyPI存储库基本设置选项卡，然后单击保存并完成。
使用pip从人工解决
要安装皮普命令行工具参考PIP文档页。我们建议使用virtualenv在安装PIP时分离您的环境。
使用具有pip和Artifactory的有效SSL证书
只有当包的下载URL是具有有效SSL证书的受信任主机时，pip才使用本地缓存中的包(即运行pip客户机的机器)。这意味着，如果您的Artifactory实例没有使用有效的SSL证书运行，那么对包的请求将始终首先到达Artifactory，即使包存在于本地缓存中。
显示可用于配置的代码片段皮普和setup . py要使用PyPI存储库，请选择该存储库，然后单击帮我介绍一下。
在命令行上指定存储库
指数的URL
当通过Artifactory访问PyPI存储库时，存储库URL应该不以…为前缀api / pypi在小路上。这适用于所有人皮普命令和distutilsurl包括pip安装。
当使用皮普来解析它必须指向的PyPI包
例如，如果您使用Artifactory独立或作为本地服务，您将使用以下URL访问您的PyPI存储库:
http://localhost:8081/artifactory/pypi /<库关键> /简单的
或者，如果您正在使用Artifactory Cloud, URL将是:
https:// < server name > .jfrog.io / artifactory /pypi /<库关键> /简单的
安装pip后，可以使用它来指定要解析的存储库的URL:
$ PIP安装frog-bar -i http://localhost:8081/artifactory/api/pypi/pypi-local/simple
使用凭证
由于它的设计，pip不支持从文件中读取凭证。例如，凭据可以作为URL的一部分提供http://<用户名>:<密码> @localhost: 8081 / artifactory / api / pypi pypi-local /简单。密码可以省略(前面有冒号)，在这种情况下，系统将提示用户以交互方式输入凭据。
使用配置文件
可以通过pip配置文件指定不同存储库的别名，~ / .pip / pip.conf。该文件包含每个存储库的配置参数，例如:
[global] index-url = http://user:password@localhost:8081/artifactory/api/pypi/pypi-virtual/simple
更多信息请参考PIP用户指南。
使用需求文件
需求文件包含要安装的包的列表。通常这些都是当前包的依赖项。可以手动创建，也可以使用皮普冻结命令。索引URL可以在文件的第一行指定，例如:
——index-url http://localhost:8081/artifactory/api/pypi/pypi-local/simple PyYAML==3.11 argparse==1.2.1 frog-bar==0.2 frog-fu==0.2 nltk==2.0.4 wsgiref==0.1.2
向Artifactory发布
使用distutils或setuptools
Setuptools vs. distutils和python版本
人工对你是否使用是不可知的setuptools或distutils，以及项目使用的Python版本或实现。
下面的指令是为Python 2.7和Python编写的setuptools在心里的。使用不同版本的Python，或者不同的工具热情,distutils其他的可能需要对下面的说明进行轻微的修改。
上传到Artifactory使用setup . py以类似于上传到PyPI的方式支持脚本。首先，需要添加Artifactory作为用户的索引服务器。
有关使用说明setuptools来打包Python项目并创建setup . py脚本，请参考setuptools文档和本教程项目。
创建$HOME/。pypirc文件
要上传到Artifactory，需要为每个存储库创建一个条目$ HOME / .pypirc如下:
[distutils] index-servers = local pypi [pypi] repository: https://pypi.org/pypi用户名:mrBagthrope密码:notToBeSeen [local] repository: http://localhost:8081/artifactory/api/pypi/pypi-local用户名:admin密码:password
注意，URL没有以。结尾/简单。
HOME环境变量
setuptools要求.pypirc文件在$ HOME / .pypirc,使用首页环境变量。
在类unix系统上，这通常由系统设置为/home/yourusername /但是在某些环境中，例如构建服务器，您必须手动设置它。
在Windows上必须手动设置。
上传
在创建.pypirc文件和asetup . py在你的项目的根脚本，你可以上传你的鸡蛋(tar.gz)包如下:
~/python_project $ python setup.py sdist upload -r local
如果你使用wheel ()whl)，你可以上传你的软件包如下:
~/python_project $ python setup.py bdist_wheel upload -r local
或者如果你想用两种鸡蛋(tar.gz)和轮子(whl)，你可以按以下方式上传:
~/python_project $ python setup.py sdist bdist_wheel upload -r local
在哪里当地的这节课的名字是你的吗.pypirc指向您的Artifactory PyPI存储库的文件。
默认的上传
默认情况下，两者都是setuptools和distutils将上传到https://pypi.org/pypi如果没有指定存储库。
register命令应该省略
直接上传到pypi.org，文档说明您的包裹必须先注册通过调用python setup . py登记。
上传到Artifactory时，既不需要也不支持应该省略。
通过Web UI或REST方式手动发布
PyPI包也可以使用Web UI或者是人工REST API。为了使Artifactory正确地处理这些包，它们必须与PyPI包一起上传pypi.name和pypi.version属性。
自动提取属性
在索引新上传的软件包时，Artifactory将自动尝试从保存在文件中的包元数据中提取所需的属性。请注意，并非所有支持的文件都可以提取。
目前,只有邮政编码，焦油，tgz，tar.gz，tar.bz2，蛋和whl可以为元数据提取文件。
此外，索引在60秒静默期后开始，从最后一次上传到当前存储库开始计数。
搜索PyPI包
使用脉冲
Artifactory支持使用皮普的搜索命令在本地、远程和虚拟存储库中使用。例如:
$ pip搜索青蛙-fu -索引http://localhost:8081/artifactory/api/pypi/pypi-virtual/青蛙-fu - 0.2a安装:0.2a(最新)$ pip搜索irbench -索引http://localhost:8081/artifactory/api/pypi/pypi-virtual/ irbench -图像检索基准。
在这个例子中frog-fu是本地安装的包，而irbench被发现于pypi.org，这两个存储库都由pypi-virtual存储库。
指定索引
在使用搜索命令时，应该显式指定索引(不带/简单)，因为PIP将忽略index-url它的变量pip.conf文件。
Artifactory搜索
PyPI包也可以使用Artifactory的Property Search进行搜索。所有PyPI包都有这些属性pypi.name，pypi.version和pypi.summary由上传客户端设置，或稍后在索引支持的文件类型时设置。
查看PyPI包的元数据
Artifactory允许您直接从UI中查看PyPI包的选定元数据。
在工件模块树浏览器,向下钻取以选择要检查的文件。元数据显示在PyPI信息选项卡。
使用带有自定义注册表后缀的远程存储库
您可以设置自定义后缀，而不是像DevPi那样设置默认的简单后缀。
要设置devpi注册表后缀到服务器后缀:
在URL和注册URL中使用根URL。例如:http://m.devpi.net。
要进行搜索，请在索引URL中包含所需的范围(如devpi例如，它可以是根/ pypi）.
$ PIP搜索青蛙-fu -索引http://localhost:8081/artifactory/api/pypi/devpi/root/pypi/
要安装，需要在索引url中包含所需的范围(就像在devpi示例中一样)根/ pypi）
$ PIP安装frog-bar -i http://localhost:8081/artifactory/api/pypi/devpi/root/pypi/simple
