存储库布局是最终的
一旦创建了远程存储库,您就不能更改它的布局,因此我们建议您事先定义它。
内置自定义布局:vcs-default
Artifactory的内置的VCS存储库的默认布局(vcs-default)可以同时使用GitHub和BitBucket。
下面是一个示例自定义布局命名vcs-default:
您可以配置自定义布局,或简单地将下面的代码段复制到政府模块,下库管理|布局.
vc -default [orgPath]/[module]/[refs ]/[baseRev]/[module]-[baseRev](-[fileItegRev])(-[classifier])。[ext] false 。* [a-zA-Z0-9]{40}
如果存储库包布局在相应的文件夹层次结构中,Artifactory Version Cleanup工具将正确地检测先前安装的版本。
使用REST API搜索工件版本也可以正常工作:
$ curl "http://localhost:8081/artifactory/api/search/versions?G =jquery&a=jquery&repos=github-cache" {"results": [{"version": "2.0.3", "integration": false}, {"version": "master-062b5267d0a3538f1f6dee3df16da536b73061ea", "integration": true}]}
远程存储库
你需要创建一个远程存储库哪个作为缓存代理github.com.如果有必要,您也可以为bitbucket.org或其他您需要的远程git存储库。
工件(例如tar.gz
从远程存储库请求的文件)根据需要缓存。您可以从远程存储库缓存中删除下载的构件,但是,您不能手动将构件部署到远程存储库。
创建要代理的远程存储库github.com
或一个on-prem GitHub企业存储库,遵循以下步骤:
- 在政府模块,在存储库|存储库|远程,点击新的远程存储库并设置风投公司成为包类型.
- 设置库的关键,并指定URL是
https://github.com
(或您的GitHub企业URL端点)如下所示: - 的“VCS Settings”下,选择GitHub提供者Git提供者字段,单击保存&完成.
Git提供者
Artifactory支持代理以下即时可用的Git提供者:GitHub, Bitbucket, Stash,一个远程Artifactory实例或自定义Git存储库,如下所示:
如果您有一个预定义列表中不存在的Git存储库,请使用自定义提供程序。在这种情况下,您需要为Artifactory提供Git tarball的下载路径。
你可以通过提供4个占位符来实现:
占位符 | 描述 |
---|---|
{0} | 标识用户名或组织名。 |
{1} | 标识存储库名称。 |
{2} | 标识分支或标记名称。 |
{3} | 标识要下载的文件扩展名。 |
例如,GitHub在以下位置公开tarball下载:https://github.com/<用户名>/回购> </归档/> <标签/分支.< >扩展
因此,为Artifactory配置的自定义下载路径应该为{0} /{1} /归档/ {2},{3}
使用Stash或Bitbucket
如果您正在使用Stash或BitBucket,您需要下载并安装BitBucket服务器存档插件.
下载JAR之后,在Stash UI中选择它管理|管理加载项|上传加载项。
一旦你安装了插件,你需要重新启动Stash。
使用API
VCS存储库必须在路径中加上api/ VCS前缀
当通过Artifactory访问VCS存储库时,存储库URL必须加上前缀api /风险投资在路上。
例如,如果你单独使用Artifactory或作为本地服务,你可以使用下面的URL访问你的VCS存储库:
http://localhost:8081/artifactory/api /风险投资<库关键>
或者,如果您正在使用Artifactory Cloud, URL将是:
https:// < server name > .jfrog.io / artifactory /api /风险投资<库关键>
Artifactory公开了REST api,允许您使用VCS存储库执行以下操作:
为了帮助您正确地构建API调用,您可以选择希望与之交互的VCS存储库并单击给我介绍.
例子
下面是一些使用cURL处理API的例子:
curl -i "http://localhost:8080/artifactory/api/vcs/downloadBranch/github/jquery/jquery/master"
curl -i "http://localhost:8080/artifactory/api/vcs/downloadTag/bitbucket/lsystems/angular-extended-notifications/1.0.0"
curl -i "http://localhost:8080/artifactory/api/vcs/downloadTagFile/github/jquery/jquery/2.0.1%21AUTHORS.txt"
当文件已经被缓存时,你可以使用属性查询参数有条件地请求它们:
curl -i "http://localhost:8080/artifactory/api/vcs/downloadBranch/github/jquery/jquery/2.0.1?属性= qa =批准”
访问私有VCS存储库
Artifactory还支持访问私有VCS存储库,如私有GitHub或任何自托管的经过身份验证的存储库。
要做到这一点,只需在下面添加您的证书高级设置远程存储库配置面板的。
重定向时的凭证
一些git提供者(包括GitHub)将下载请求重定向到CDN提供者。
您将需要您的凭证与重定向请求一起传递,只需检查宽松的主机认证凭证将在每个重定向请求上透明地传递。