docs/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/rubygems.md

date, slug, sidebar_position

date	slug	sidebar_position
2021-07-20T00:00:00+00:00	rubygems	110

RubyGems 套件註冊表

為您的用戶或組織發布 RubyGems 套件。

需求

要使用 RubyGems 套件註冊表，您需要使用 gem 命令行工具來消費和發布套件。

配置套件註冊表

要註冊套件註冊表，請編輯 ~/.gem/credentials 文件並添加：

---
https://gitea.example.com/api/packages/{owner}/rubygems: Bearer {token}

參數	描述
owner	套件的擁有者。
token	您的 個人訪問令牌。

例如：

---
https://gitea.example.com/api/packages/testuser/rubygems: Bearer 3bd626f84b01cd26b873931eace1e430a5773cc4

發布套件

運行以下命令來發布套件：

gem push --host {host} {package_file}

參數	描述
host	套件註冊表的 URL。
package_file	套件 .gem 文件的路徑。

例如：

gem push --host https://gitea.example.com/api/packages/testuser/rubygems test_package-1.0.0.gem

如果已經存在同名同版本的套件，您不能發布該套件。您必須先刪除現有的套件。

安裝套件

要從套件註冊表中安裝套件，您可以使用 Bundler 或 gem。

Bundler

在您的 Gemfile 中添加一個新的 source 塊：

source "https://gitea.example.com/api/packages/{owner}/rubygems" do
  gem "{package_name}"
end

參數	描述
owner	套件的擁有者。
package_name	套件名稱。

例如：

source "https://gitea.example.com/api/packages/testuser/rubygems" do
  gem "test_package"
end

之後運行以下命令：

bundle install

gem

執行以下命令：

gem install --host https://gitea.example.com/api/packages/{owner}/rubygems {package_name}

參數	描述
owner	套件的擁有者。
package_name	套件名稱。

例如：

gem install --host https://gitea.example.com/api/packages/testuser/rubygems test_package

支持的命令

gem install
bundle install
gem push