存储库布局是最终的
一旦创建了远程存储库,您就不能更改它的布局,因此我们建议您事先定义它。
内置自定义布局:vcs-default
Artifactory的内置的VCS存储库的默认布局(vcs-default)可以与GitHub和BitBucket一起工作。
下面是a的一个例子自定义布局命名vcs-default:
您可以配置自定义布局,或者简单地将下面的代码片段复制到控件的相关部分政府模块,下库管理|布局。
vcs-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
或本地GitHub企业存储库,请遵循以下步骤:
- 在政府模块,在存储库|仓库|远程,点击新建远程存储库并设置风投公司成为包类型。
- 设置库的关键,并指定URL是
https://github.com
(或者你的GitHub Enterprise URL端点)如下所示: - 在VCS Settings下,选择Git提供者字段并单击保存并完成。
Git提供者
Artifactory支持代理以下Git提供商:GitHub、Bitbucket、Stash、远程Artifactory实例或自定义Git存储库,如下图所示:
如果您的Git存储库不在预定义列表中,请使用自定义提供程序。在本例中,您需要向Artifactory提供Git压缩包的下载路径。
您可以通过提供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提供商。
您将需要凭据与重定向请求一起传递,只需检查宽大主机认证并且凭据将在每个重定向请求上透明地传递。