云客户?
免费开始>
在MyJFrog >中升级
云有什么新>





概述

今天,许多作为纯源文件使用的技术都是以二进制文件的形式部署的(例如,PHP、Rails、Node.js、Ruby等)。作为二进制存储库管理器,Artifactory通过对VCS存储库的支持,为您提供了一种简单、安全、可靠的方式来使用这些二进制文件,从而完成了这一任务。

对VCS的Artifactory支持提供:

  1. 能够列出任何VCS存储库的所有标记和分支。
  2. 访问远程VCS存储库,如GitHub (https://github.com)和Bitbucket (https://bitbucket.org)通过远程存储库它们提供了常用的代理和缓存功能。
  3. 标签和分支的按需本地缓存,以备网络不稳定或托管VCS服务停机时使用。
  4. 根据项目或开发团队分配访问权限的能力。

配置

仓库布局

VCS存储库需要适当的存储库布局来支持缓存项的更分层的布局。

要为存储库使用分层布局,可以使用内置的vcs-default使用Artifactory提供的开箱即用的布局,或者定义一个自定义布局.这将确保不同的维护功能,如版本清理将正确工作。

页面内容

集成的好处

存储库布局是最终的

一旦创建了远程存储库,您就不能更改它的布局,因此我们建议您事先定义它。

内置自定义布局: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企业存储库,遵循以下步骤:

  1. 政府模块,在存储库|存储库|远程,点击新的远程存储库并设置风投公司成为包类型
  2. 设置库的关键,并指定URLhttps://github.com(或您的GitHub企业URL端点)如下所示:


  3. 的“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存储库并单击给我介绍

设置我的VCS存储库


例子

下面是一些使用cURL处理API的例子:

从GitHub下载jquery主分支
curl -i "http://localhost:8080/artifactory/api/vcs/downloadBranch/github/jquery/jquery/master"
从Bitbucket下载一个特定的标签
curl -i "http://localhost:8080/artifactory/api/vcs/downloadTag/bitbucket/lsystems/angular-extended-notifications/1.0.0"
下载jquery 2.0.1标签内的文件,'!'转义为'%21'
curl -i "http://localhost:8080/artifactory/api/vcs/downloadTagFile/github/jquery/jquery/2.0.1%21AUTHORS.txt"

当文件已经被缓存时,你可以使用属性查询参数有条件地请求它们:

下载jquery 2.0.1标签内的文件,'!'转义为'%21'
curl -i "http://localhost:8080/artifactory/api/vcs/downloadBranch/github/jquery/jquery/2.0.1?属性= qa =批准”

访问私有VCS存储库

Artifactory还支持访问私有VCS存储库,如私有GitHub或任何自托管的经过身份验证的存储库。

要做到这一点,只需在下面添加您的证书高级设置远程存储库配置面板的。

重定向时的凭证

一些git提供者(包括GitHub)将下载请求重定向到CDN提供者。

您将需要您的凭证与重定向请求一起传递,只需检查宽松的主机认证凭证将在每个重定向请求上透明地传递。

  • 没有标签
版权所有©2022 JFrog Ltd.