云客户?
免费开始>
在MyJFrog中升级>
云的新功能>





概述

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

对VCS的人工支持提供:

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

配置

仓库布局

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

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

页面内容

集成的好处

存储库布局是最终的

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

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

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


  3. 在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存储库并单击帮我介绍

为我设置VCS存储库


例子

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

从GitHub下载jquery master分支
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.