极狐GitLab 是 GitLab 在中国的发行版，关于中文参考文档和资料有：
- 极狐GitLab 中文文档
- 极狐GitLab 中文论坛
- 极狐GitLab 官网
软件包库中的 Ruby gems (BASIC ALL)
WARNING:Ruby gems 软件包库正在开发中，由于功能有限，尚未准备好用于生产。
您可以在项目的软件包库中发布 Ruby gem，然后在需要将它们用作依赖项时安装它们。尽管您可以将 gem 推送到软件包库，但不能从库里安装它们。但是，您可以直接从软件宝库的 UI 下载 gem 文件，或者使用 API。
启用 Ruby gems 库
Ruby gems 库背后有一个默认禁用的功能标志。可以访问 GitLab Rails 控制台的 GitLab 管理员可以为您的实例启用此库。
启用：
Feature.enable(:rubygem_packages)
禁用：
Feature.disable(:rubygem_packages)
为特定项目启用或禁用：
Feature.enable(:rubygem_packages, Project.find(1))
Feature.disable(:rubygem_packages, Project.find(2))
创建 Ruby gem
如果您在创建 Ruby gem 时需要帮助，请参阅 RubyGems 文档。
向软件包库进行身份验证
在推送到软件包库之前，您必须进行身份验证。
为此，您可以使用：
-
个人访问令牌，范围设置为
api。 -
部署令牌，其范围设置为
read_package_registry、write_package_registry或两者均有。 -
CI 作业令牌。
使用个人访问令牌或部署令牌进行身份验证
要使用个人访问令牌进行身份验证，请创建或编辑 ~/.gem/credentials 文件并添加：
---
https://gitlab.example.com/api/v4/projects/<project_id>/packages/rubygems: '<your token>'
<your token>必须是您的个人访问令牌或部署令牌的令牌值。- 您的项目 ID 在您的项目主页上。
使用 CI 作业令牌进行身份验证
要在 GitLab CI/CD 中使用 RubyGems 命令，您可以使用 CI_JOB_TOKEN 代替个人访问令牌或部署令牌。
例如：
# assuming a my_gem.gemspec file is present in the repository with the version currently set to 0.0.1
image: ruby
run:
before_script:
- mkdir ~/.gem
- echo "---" > ~/.gem/credentials
- |
echo "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/rubygems: '${CI_JOB_TOKEN}'" >> ~/.gem/credentials
- chmod 0600 ~/.gem/credentials # rubygems requires 0600 permissions on the credentials file
script:
- gem build my_gem
- gem push my_gem-0.0.1.gem --host ${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/rubygems
您还可以在检入极狐GitLab 的 ~/.gem/credentials 文件中使用 CI_JOB_TOKEN：
---
https://gitlab.example.com/api/v4/projects/${env.CI_PROJECT_ID}/packages/rubygems: '${env.CI_JOB_TOKEN}'
推送 Ruby gem
先决条件：
- 您必须向软件包库进行身份验证。
- 允许的最大 gem 大小为 3 GB。
要推送您的 gem，请运行如下命令：
gem push my_gem-0.0.1.gem --host <host>
请注意， 是您在设置身份验证时使用的 URL。例如：
gem push my_gem-0.0.1.gem --host https://gitlab.example.com/api/v4/projects/1/packages/rubygems
此消息表示 gem 上传成功：
Pushing gem to https://gitlab.example.com/api/v4/projects/1/packages/rubygems...
{"message":"201 Created"}
要查看已发布的 gem，请转到您项目的 软件包和镜像库 页面。推送到极狐GitLab 的 Gems 不会立即显示在您项目的 Packages UI 中。处理 gem 最多可能需要 10 分钟。
推送具有相同名称或版本的 gem
如果已存在具有相同名称和版本的包，您可以推送 gem。
两者都在 UI 中可见且可访问。但是，只有最近推送的 gem 用于安装。
安装 Ruby gem
GitLab 的 Ruby gems 库正在开发中，尚未准备好用于生产。您不能从库中安装 Gems。但是，您可以直接从 UI 或使用 API 下载 .gem 文件。
