GitLabパッケージレジストリの管理

GitLabをさまざまな一般的なパッケージマネージャーのプライベートリポジトリとして使用するには、パッケージレジストリを使用します。パッケージをビルドして公開すると、ダウンストリームプロジェクトで依存関係として使用できます。

サポートされている形式

パッケージレジストリは、次の形式をサポートしています:

パッケージレジストリは、モデルレジストリデータの保存にも使用されます。

コントリビュートを受け入れる

次の表に、サポートされていないパッケージ形式を示します。これらの形式のサポートを追加するために、GitLabにコントリビュートすることを検討してください。

レート制限

ダウンストリームプロジェクトで依存関係としてパッケージをダウンロードする際、Packages APIを介して多くのリクエストが行われます。そのため、強制されたユーザーおよびIPレート制限に達する可能性があります。この問題に対処するには、Packages APIに特定のレート制限を定義できます。詳細については、パッケージレジストリのレート制限を参照してください。

パッケージレジストリの有効化または無効化

パッケージレジストリはデフォルトで有効になっています。無効にするには、次の手順に従います:

ストレージパスの変更

デフォルトでは、パッケージはローカルに保存されますが、デフォルトのローカルの場所を変更したり、オブジェクトストレージを使用したりすることもできます。

ローカルストレージパスの変更

デフォルトでは、パッケージはGitLabインストールからの相対的なローカルパスに保存されます:

• Linuxパッケージ（Omnibus）: /var/opt/gitlab/gitlab-rails/shared/packages/
• 自己コンパイル（ソース）: /home/git/gitlab/shared/packages/

ローカルストレージパスを変更するには:

古いストレージパスにパッケージが既に保存されている場合は、既存のパッケージに引き続きアクセスできるように、古い場所から新しい場所にすべて移動します:

mv /var/opt/gitlab/gitlab-rails/shared/packages/* /mnt/packages/

DockerとKubernetesはローカルストレージを使用しません。

• Helmチャート（Kubernetes）の場合: 代わりにオブジェクトストレージを使用してください。
• Dockerの場合: /var/opt/gitlab/ディレクトリは、ホスト上のディレクトリにすでにマウントされています。コンテナ内でローカルストレージパスを変更する必要はありません。

オブジェクトストレージを使用する

ローカルストレージに依存する代わりに、オブジェクトストレージを使用してパッケージを保存できます。

詳細については、統合されたオブジェクトストレージの設定の使用方法を参照してください。

オブジェクトストレージとローカルストレージ間でパッケージを移行する

オブジェクトストレージを構成した後、次のタスクを使用して、ローカルストレージとリモートストレージ間でパッケージを移行できます。この処理はバックグラウンドワーカーで実行され、ダウンタイムは不要です。

オブジェクトストレージに移行する

1. パッケージをオブジェクトストレージに移行します:

   Linuxパッケージ（Omnibus）

   sudo gitlab-rake "gitlab:packages:migrate"

   自己コンパイル（ソース）

   RAILS_ENV=production sudo -u git -H bundle exec rake gitlab:packages:migrate

2. PostgreSQLコンソールを使用して、進行状況を追跡し、すべてのパッケージを正常に移行したことを確認します:

   Linuxパッケージ（Omnibus）14.1以前

   sudo gitlab-rails dbconsole

   Linuxパッケージ（Omnibus）14.2以降

   sudo gitlab-rails dbconsole --database main

   自己コンパイル（ソース）

   RAILS_ENV=production sudo -u git -H psql -d gitlabhq_production

3. 次のSQLクエリを使用して、すべてのパッケージをオブジェクトストレージに移行したことを確認します。objectstgの数がtotalと同じである必要があります:

   SELECT count(*) AS total,
          sum(case when file_store = '1' then 1 else 0 end) AS filesystem,
          sum(case when file_store = '2' then 1 else 0 end) AS objectstg
   FROM packages_package_files;

   出力例:

   total | filesystem | objectstg
   ------+------------+-----------
    34   |          0 |        34

4. 最後に、ディスク上のpackagesディレクトリにファイルがないことを確認します:

   Linuxパッケージ（Omnibus）

   sudo find /var/opt/gitlab/gitlab-rails/shared/packages -type f | grep -v tmp | wc -l

   自己コンパイル（ソース）

   sudo -u git find /home/git/gitlab/shared/packages -type f | grep -v tmp | wc -l

オブジェクトストレージからローカルストレージに移行する

1. パッケージをオブジェクトストレージからローカルストレージに移行します:

   Linuxパッケージ（Omnibus）

   sudo gitlab-rake "gitlab:packages:migrate[local]"

   自己コンパイル（ソース）

   RAILS_ENV=production sudo -u git -H bundle exec rake "gitlab:packages:migrate[local]"

2. PostgreSQLコンソールを使用して、進行状況を追跡し、すべてのパッケージを正常に移行したことを確認します:

   Linuxパッケージ（Omnibus）14.1以前

   sudo gitlab-rails dbconsole

   Linuxパッケージ（Omnibus）14.2以降

   sudo gitlab-rails dbconsole --database main

   自己コンパイル（ソース）

   RAILS_ENV=production sudo -u git -H psql -d gitlabhq_production

3. 次のSQLクエリを使用して、すべてのパッケージがローカルストレージに移行されたことを確認します。filesystemの数がtotalと同じである必要があります:

   SELECT count(*) AS total,
          sum(case when file_store = '1' then 1 else 0 end) AS filesystem,
          sum(case when file_store = '2' then 1 else 0 end) AS objectstg
   FROM packages_package_files;

   出力例:

   total | filesystem | objectstg
   ------+------------+-----------
    34   |         34 |         0

4. 最後に、packagesディレクトリにファイルが存在することを確認します:

   Linuxパッケージ（Omnibus）

   sudo find /var/opt/gitlab/gitlab-rails/shared/packages -type f | grep -v tmp | wc -l

   自己コンパイル（ソース）

   sudo -u git find /home/git/gitlab/shared/packages -type f | grep -v tmp | wc -l