RubyGems存储库

常规配置

所有RubyGems命令，包括宝石来源和宝石推，必须在存储库路径前加上api /宝石。

例如，如果你使用Artifactory独立或作为本地服务，你可以使用以下URL访问你的RubyGems库:

http://localhost:8081/artifactory/api /珠宝/<库关键>

或者，如果您正在使用Artifactory Cloud, URL将是:

https:// < server name > .jfrog.io /artifactory/api /珠宝/<库关键>

局部存储库

本地RubyGems存储库是物理的、本地管理的存储库，你可以在其中部署和管理你的内部Gems。

要创建一个本地的RubyGems存储库，在政府模块,在存储库|存储库|本地，点击新建本地存储库并设置宝石成为包装类型。

你可以这样设置一个本地的RubyGems仓库:

您需要通过修改您的~ / .gemrc文件或使用宝石来源命令，如下所示。您可以通过在Tree Browser中选择存储库并单击来提取源URL帮我介绍一下。

注意有两个来源。首先是远程代理，然后是本地代理。这将有效地允许您以指定的顺序从它们中检索Gems。

Gem源代码- http://localhost:8081/artifactory/api/gems/my-gems-local/

默认的文件

在创建本地RubyGems存储库时，Artifactory用以下文件集填充它，这些文件集是索引存储库所需的:

• rubygems-update - * .gem(根据宝石存储库文件夹)
• 快速/元帅。*
• latest_specs . * . gz
• prerelease_specs . * . gz
• * . gz和规格。

本地RubyGems存储库显示在应用程序模块|Artifactory|工件。

使用

首先，设置适当的凭证为宝石工具:包含API密钥~ / .gem /凭证文件或发出这个命令:

Curl http://localhost:8081/artifactory/api/gems//api/v1/api_key。Yaml -u admin:password > ~/.gem/credentials

为了…推Gems到本地存储库时，可以设置全局变量RUBYGEMS_HOST美元使用如下命令指向本地存储库:

export RUBYGEMS_HOST=http://localhost:8081/artifactory/api/gems/<存储库密钥>

要获得此值，请选择您的存储库的应用程序模块|Artifactory|工件|Gems-local和点击帮我介绍一下。

或者你也可以使用宝石推命令——主机，或者，——关键指定相关的API密钥。

远程存储库

远程RubyGems存储库作为远程URL管理的存储库的缓存代理，例如http://rubygems.org。

一旦被请求，工件(Gems)就会按需缓存。然后可以删除它们，但不能手动将任何内容部署到远程存储库中。

要创建远程RubyGems存储库，执行以下步骤:

1. 在政府模块,在仓库|仓库|远程，点击新建远程存储库并设置宝石成为包装类型。
2. 设置库的关键，并指定URL到远程存储库。下面的示例引用了rubygems.org。

使用

1. 在Application模块| Artifactory | Artifacts Tree Browser中，选择新创建的存储库并单击帮我介绍。
2. 文件中复制源URLRubyGems来源部分。
   

3. 添加此URL~ / .gemrc文件或使用宝石来源命令如下:

   所有的RubyGems库都必须在路径中加上api/gems前缀

   当使用RubyGems命令行通过Artifactory访问存储库时，存储库URL必须以api /宝石在小路上。

   Gem源代码- http://localhost:8081/artifactory/api/gems/rubygems/

你可以使用的其他Gem命令

可以通过修改您的~ / .gemrc手动或运行文件Gem资源-r
你也可以运行宝石来源-列表知道你的有效资源是什么以及它们的顺序。

克服未授权状态失败

一些gem/bundler命令可能会在未授权(401)状态下失败。在某些情况下，这些可以通过使用一个下列选项之一:

• 通过勾选启用“匿名用户”允许匿名访问在安全常规配置如管理用户所述。
• 创建一个专门的允许目标这只允许匿名访问远程存储库。

• 使用带有嵌入式凭据的源URL，例如:宝石来源-一个http：//用户：password@host/ . .。

---

虚拟存储库

一个虚拟的RubyGems存储库(或“存储库组”)可以聚合多个本地和远程的RubyGems存储库，将它们无缝地暴露在一个URL下。

存储库是虚拟的，因为您可以从中解析和检索工件，但不能向其中部署任何内容。更多信息请参考虚拟存储库。

设置虚拟存储库的过程与设置本地或远程存储库非常相似，但是作为最后一步，您需要选择将包含在正在创建的虚拟存储库中的存储库。

使用

使用虚拟的RubyGems存储库，你可以聚合本地和远程存储库。

您需要设置正确的存储库源URL，方法与使用对于本地的RubyGems存储库，只需使用合适的存储库密钥，如下所示:

来源:http://localhost: 8081 / artifactory / api /珠宝/ <库关键> /

目标:http://localhost: 8081/ / artifactory / api /宝石<库关键>（结尾没有斜杠!)

---

使用REST API

REST API通过以下URL提供了对Gems插件的访问:

http://localhost:8081/artifactory/api /宝石/ <库关键> /

除了基本的二进制存储库操作(如下载、部署、删除等)之外后RubyGems.org支持API Gem命令:

Gem命令	Curl语法示例	讲话
信息	旋度http://localhost:8081/artifactory/api /宝石/ <代表ository关键>/ api / v1 /珠宝/ my_gem。(json xml | | yaml)	可选地指定JSON / XML / YAML(默认:JSON)
搜索	旋度http://localhost:8081/artifactory/api /宝石/ <库关键> / api / v1 /搜索。(json xml | | yaml) ?查询=[查询］	将搜索宝石名称包含查询
依赖关系	旋度http://localhost:8081/artifactory/api /宝石/ <库关键> / api / v1 /依赖性?宝石= (gem1,……)	的值使用gem名称的csv格式宝石
猛地一拉	curl -X DELETEhttp://localhost:8081/artifactory/api /宝石/ <库关键> /api / v1 /猛拉 - d ' gem_name =gem_name' -d 'version=0.0.1' -d '平台=鲁比（人名）＇	删除来自存储库的特定gem文件

索引是由Artifactory在后台自动完成的，但是如果您仍然需要重新创建或更新规范索引文件，以下REST API命令也可用:

其他命令	Curl语法示例	讲话
重建索引	curl -X POSThttp://localhost:8081/artifactory/api /宝石/ <库关键> /重建索引	重新创建所有规格索引文件。
更新索引	curl -X POSThttp://localhost:8081/artifactory/api /宝石/ <库关键> / updateIndex	如果需要，更新所有规格索引文件。

---

查看RubyGems工件信息

如果您在树浏览器中选择一个RubyGems工件，您可以选择RubyGems选项卡查看所选工件的详细信息。

---

获取与您的Ruby版本兼容的最新RubyGems包

Bundler Compact Index功能允许您检索与项目中安装的Ruby版本兼容的最新RubyGems版本，适用于本地、远程和虚拟存储库。

要应用此特性，请设置artifactory.gems.compact.index.enabled = true的值artifactory.system.properties文件。

---

观看视频