このページは Cloud Translation API によって翻訳されました。

Ruby Gem を管理する

このページでは、Ruby gem と gem バージョンの追加、表示、削除について説明します。

始める前に

Google Cloud CLI をインストールして初期化します。

Ruby リポジトリに対するコマンドを実行するには、Google Cloud CLI バージョン 354.0.0 以降が必要です。バージョンは、次のコマンドで確認できます。
```
gcloud version
```
ターゲットリポジトリが存在しない場合は、Ruby パッケージリポジトリを作成します。
Ruby がインストールされていることを確認します。インストール手順については、Google Cloud Ruby の設定のチュートリアルをご覧ください。
（省略可）gcloud コマンドのデフォルトを設定します。

必要なロール

Gem の管理に必要な権限を取得するには、リポジトリに対する次の IAM ロールの付与を管理者に依頼してください。

Gem または Gem 内のファイルを表示する: Artifact Registry 読み取り（roles/artifactregistry.reader）
Gem をダウンロードまたはインストールする: Artifact Registry 読み取り（roles/artifactregistry.reader）
リポジトリに Gem を追加する: Artifact Registry 書き込み（roles/artifactregistry.writer）
Gem を削除する: Artifact Registry リポジトリ管理者（roles/artifactregistry.repoAdmin）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Gem を追加する

Ruby のパッケージは「gem」と呼ばれ、各 gem には名前、バージョン、プラットフォームが含まれています。Ruby プロジェクトには、必要な gem 依存関係を指定する構成ファイルである gemfile も含まれている必要があります。

リポジトリモード: 標準

Ruby プロジェクトをビルドすると、ディストリビューションファイルはプロジェクトの lib サブディレクトリに保存されます。その後、RubyGems を使用して Gem を標準リポジトリにアップロードできます。

Artifact Registry リポジトリに Gem を追加するには:

gem push GEM_NAME --host https://LOCATION-ruby.pkg.dev/PROJECT/REPOSITORY

ここで

GEM_NAME は、リポジトリに push する gem の名前です。
LOCATION は、リポジトリの場所です。
PROJECT は、プロジェクト ID です。このフラグを省略すると、現在のプロジェクトまたはデフォルトのプロジェクトが使用されます。
REPOSITORY は、Artifact Registry のリポジトリの名前です。

Gem とバージョンを表示する

リポジトリモード: 標準

Google Cloud コンソールまたは gcloud を使用してパッケージとパッケージのバージョンを表示するには:

コンソール

Google Cloud コンソールで [リポジトリ] ページを開きます。

[リポジトリ] ページを開く
リポジトリリストで、適切なリポジトリをクリックします。

[パッケージ] ページに、リポジトリ内のパッケージが一覧表示されます。
パッケージをクリックして、そのパッケージのバージョンを表示します。

gcloud

リポジトリ内のパッケージを一覧表示するには、次のコマンドを実行します。

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

以下を置き換えます。

REPOSITORY はリポジトリの名前です。デフォルトリポジトリを構成した場合は、このフラグを省略してデフォルトを使用できます。
LOCATION は、リポジトリのリージョンまたはマルチリージョンのロケーションです。デフォルトロケーションを構成している場合は、このフラグを省略してデフォルトを使用できます。

パッケージのバージョンを表示するには、次のコマンドを実行します。

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

以下を置き換えます。

PACKAGE は、パッケージの ID またはパッケージの完全修飾 ID です。
REPOSITORY はリポジトリの名前です。デフォルトリポジトリを構成した場合は、このフラグを省略してデフォルトを使用できます。
LOCATION は、リポジトリのリージョンまたはマルチリージョンのロケーションです。このフラグを使用して、特定のロケーションのリポジトリを表示します。デフォルトロケーションを構成している場合は、このフラグを省略してデフォルトを使用できます。

リモートリポジトリの場合、返されるリストには、すべての直接的な依存関係と一時的な依存関係が含まれます。

ファイルの一覧表示

リポジトリモード: 標準

リポジトリ内のファイル、指定したパッケージのすべてのバージョン内のファイル、またはパッケージの特定のバージョン内のファイルを一覧表示できます。

次のすべてのコマンドについては、コマンドに --limit フラグを追加することで、返されるファイルの最大数を設定できます。

デフォルト値が構成されている場合にデフォルトのプロジェクト、リポジトリ、ロケーションのすべてのファイルを一覧表示するには次のようにします。

gcloud artifacts files list

指定したプロジェクト、リポジトリ、ロケーション内のファイルを一覧表示するには、次のコマンドを実行します。

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

特定のパッケージのすべてのバージョン内のファイルを一覧表示するには:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

特定のパッケージバージョンのファイルを一覧表示するには:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

次の値を置き換えます。

LOCATION: リポジトリのリージョンまたはマルチリージョンロケーション。
PROJECT: Google Cloud プロジェクト ID。プロジェクト ID にコロン（:）が含まれている場合は、ドメインをスコープとするプロジェクトをご覧ください。
REPOSITORY: イメージが保存されるリポジトリの名前。
PACKAGE: パッケージの名前。
VERSION: パッケージのバージョン。

例

次のパッケージ情報について考慮するには:

プロジェクト: my-project
リポジトリ: my-repo
リポジトリの場所: us-west1
パッケージ: my-app

次のコマンドは、デフォルトプロジェクト内のロケーション us-west1 のリポジトリ my-repo 内のすべてのファイルを一覧表示します。

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo

パッケージのバージョン 1.0 内のファイルを一覧表示します。

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=1.0

gem をインストールする

リポジトリモード: 標準

パッケージの最新の安定版リリースをインストールするには:

gem install GEM_NAME

標準リポジトリの場合は、リポジトリからパッケージを直接ダウンロードします。

リモートリポジトリの場合は、パッケージとその依存関係のキャッシュに保存されたコピーをダウンロードします。キャッシュに保存されたコピーが存在しない場合は、リモートリポジトリがアップストリームソースからパッケージをダウンロードし、それを提供する前にキャッシュに保存します。リモートリポジトリがアップストリームソースからパッケージを取得したことを確認するには、リポジトリ内のパッケージの一覧を表示します。

仮想リポジトリの場合は、Artifact Registry はリクエストされたパッケージのアップストリームリポジトリを検索します。

キャッシュに保存されたコピーが存在しない場合、アップストリームのリモートリポジトリは、リクエストされたパッケージをダウンロードしてキャッシュに保存します。仮想リポジトリはリクエストされたパッケージを提供だけして、保存しません。
複数のアップストリームリポジトリに存在する利用可能なバージョンをリクエストすると、Artifact Registry は仮想リポジトリ用に構成された優先度設定に基づいて、使用するアップストリームリポジトリを選択します。

たとえば、アップストリームリポジトリに次の優先度設定がある仮想リポジトリについて考えます。

main-repo: 優先度が 100 に設定
secondary-repo1: 優先度が 80 に設定
secondary-repo2: 優先度が 80 に設定
test-repo: 優先度が 20 に設定

main-repo の優先度の値は最も高いため、仮想リポジトリは常に最初に検索します。

secondary-repo1 と secondary-repo2 はどちらも優先度が 80 に設定されています。リクエストされたパッケージが main-repo にない場合、Artifact Registry は次にこれらのリポジトリを検索します。どちらも同じ優先度を持つため、両方にそのバージョンがある場合、Artifact Registry はどちらか一方のリポジトリからパッケージを提供するように選択できます。

test-repo の優先度は最も低くなります。他のアップストリームリポジトリにアーティファクトがない場合、保存されたアーティファクトが提供されます。

その他の情報

Artifact Registry リポジトリに gem を push するか、Artifact Registry リポジトリから gem を pull する際に、リクエストされた gem またはその依存関係が指定されたリポジトリで見つからない場合、gem クライアントは、gem の gemfile で定義されている他のソースを使用します。Artifact Registry から直接取得してインストールするだけの場合は、次のコマンドを実行して、gemfile から Artifact Registry 以外のソースを削除します。

gem sources --remove SOURCE

rubygems.org をソースとして再び追加するには:

gem sources --add SOURCE

ここで、SOURCE はソースのアドレスです（https://rubygems.org など）。

パッケージとバージョンを削除する

リポジトリモード: 標準

パッケージとそのすべてのバージョンを削除することや、特定のバージョンを削除することができます。

パッケージを削除すると、その操作は元に戻せません。
リモートリポジトリの場合は、パッケージのキャッシュに保存されたコピーのみが削除されます。アップストリームソースはこの影響を受けません。キャッシュに保存されたパッケージを削除し、次回、リポジトリが同じパッケージバージョンのリクエストを受け取った場合、Artifact Registry は、そのパッケージを再度ダウンロードしてキャッシュに保存します。

パッケージまたはパッケージのバージョンを削除する前に、そのパッケージの重要な依存関係を送信済み、または対処済みであることを確認してください。

パッケージを削除するには：

コンソール

Google Cloud コンソールで [リポジトリ] ページを開きます。

[リポジトリ] ページを開く
リポジトリリストで、適切なリポジトリをクリックします。

[パッケージ] ページに、リポジトリ内のパッケージが一覧表示されます。
削除するパッケージを選択します。
[削除] をクリックします。
確認のダイアログボックスで、[削除] をクリックします。

gcloud

次のコマンドを実行します。

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

以下を置き換えます。

PACKAGE は、リポジトリ内のイメージの名前です。
REPOSITORY はリポジトリの名前です。デフォルトリポジトリを構成した場合は、このフラグを省略してデフォルトを使用できます。
LOCATION は、リポジトリのリージョンまたはマルチリージョンのロケーションです。このフラグを使用して、特定のロケーションのリポジトリを表示します。デフォルトロケーションを構成している場合は、このフラグを省略してデフォルトを使用できます。

--async フラグを使用すると、処理中のオペレーションの完了を待たずに、コマンドがすぐに返されます。

パッケージのバージョンを削除するには:

コンソール

Google Cloud コンソールで [リポジトリ] ページを開きます。

[リポジトリ] ページを開く
リポジトリリストで、適切なリポジトリをクリックします。

[パッケージ] ページに、リポジトリ内のパッケージが一覧表示されます。
パッケージをクリックして、そのパッケージのバージョンを表示します。
削除するバージョンを指定します。
[削除] をクリックします。
確認のダイアログボックスで、[削除] をクリックします。

gcloud

次のコマンドを実行します。

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

以下を置き換えます。

VERSION は、削除するバージョンの名前です。
PACKAGE は、リポジトリ内のイメージの名前です。
REPOSITORY はリポジトリの名前です。デフォルトリポジトリを構成した場合は、このフラグを省略してデフォルトを使用できます。
LOCATION は、リポジトリのリージョンまたはマルチリージョンのロケーションです。このフラグを使用して、特定のロケーションのリポジトリを表示します。デフォルトロケーションを構成している場合は、このフラグを省略してデフォルトを使用できます。

--async フラグを使用すると、処理中のオペレーションの完了を待たずに、コマンドがすぐに返されます。

制限事項

Artifact Registry では、gem sources -add コマンドを使用してリポジトリをソースとして追加することはできません。ただし、.gemrc ファイルにソースを手動で追加するか、gem コマンドで --source フラグを直接渡すことができます。
Artifact Registry では、gem fetch を使用した Gem の pull はサポートされていません。

Ruby Gem を管理する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

必要なロール

Gem を追加する

Gem とバージョンを表示する

コンソール

gcloud

ファイルの一覧表示

例

gem をインストールする

その他の情報

パッケージとバージョンを削除する

コンソール

gcloud

コンソール

gcloud

制限事項

次のステップ

Ruby Gem を管理する