Migrating your enterprise to the Container registry from the Docker registry

You can migrate Docker images previously stored in the Docker registry on お使いの GitHub Enterprise Server インスタンス to the Container registry.

この機能を使用できるユーザーについて

Enterprise owners can migrate Docker images to the Container registry.

この記事の内容

注: Container registry は GitHub Enterprise Server に対して現在ベータ版であり、変更される可能性があります。

Container registry を使うには、GitHub Packages と Subdomain Isolation の両方を有効にする必要があります。 詳しくは、「コンテナレジストリの利用」を参照してください。

About the Container registry

Container registry は、Organization または個人アカウント内にコンテナー イメージを格納し、イメージをリポジトリに関連付けることができます。 権限をリポジトリから継承するか、リポジトリとは別に細かい権限を設定するかを選ぶことができます。 パブリック コンテナー イメージに匿名でアクセスすることもできます。 For more information, see "コンテナレジストリの利用."

For more information about configuring GitHub Packages for お使いの GitHub Enterprise Server インスタンス, see "Enterprise 向けの GitHub Packages を使い始める."

About migration from the Docker registry

Container registry は、GitHub の Docker レジストリに置き換えられます。 If the Docker registry on お使いの GitHub Enterprise Server インスタンス contains images, you must manually migrate the images to the Container registry.

Note: GitHub Enterprise Server 3.6 では、Organization に格納されている Docker イメージの移行がサポートされています。 今後のリリースでは、ユーザー所有のイメージの移行がサポートされます。

Docker レジストリ、docker.HOSTNAME の名前空間を使用するあらゆるスクリプトまたは GitHub Actions ワークフローは、containers.HOSTNAME の Container registry に移行した後も引き続き動作します。 For more information about the impact of migration to the Container registry, see "Dockeerレジストリからコンテナレジストリへの移行."

Migrating organizations to the Container registry

You can start a migration of all your organizations' Docker images to the Container registry. The duration of the migration operation depends on the total number of images to migrate, and the overall load on your instance. After a successful migration, GitHub Enterprise Server will display a summary, and all future uploads of Docker images will use the Container registry.

If a site administrator has configured email notifications for お使いの GitHub Enterprise Server インスタンス, you will receive an email after the migration is complete. For more information, see "通知のためのメール設定."

Notes:

  • During the migration, the CPU and memory usage for your instance will increase. To ensure the performance of the instance for your users, GitHub recommends that you begin a migration during a period of reduced activity.
  • During the migration, do not modify settings for your enterprise or run ghe-config-apply from an administrative SSH session. These actions will trigger a configuration run, which can restart services and may interrupt the migration.
  • After the migration, storage pressure on your instance will increase due to the duplication of image files in the Docker registry and the Container registry. A future release of GitHub Enterprise Server will remove the duplicated files when all migrations are complete.

For more information about monitoring the performance and storage of お使いの GitHub Enterprise Server インスタンス, see "モニターダッシュボードへのアクセス."

  1. GitHub Enterprise Server の右上で、ご自分のプロフィール フォトをクリックしてから、 [Enterprise 設定] をクリックします。

    GitHub Enterprise Server のプロファイル写真をクリックしたときに表示されるドロップダウン メニューのスクリーンショット。 [エンタープライズ設定] オプションが濃いオレンジ色の枠線で強調表示されています。

  2. Enterprise アカウントのサイドバーで、 [設定] をクリックします。

  3. In the left sidebar, click Packages.

  4. To the right of the number of packages to migrate, click Start migration. During the migration, GitHub Enterprise Server will display progress on this page.

After the migration completes, the page will display the results. If a migration fails, the page will show the organizations that own the package that caused the failure.

Re-running a failed organization migration

Prior to migration, if a user has created a package in the Container registry that has an identical name to an existing package in the Docker registry, the migration will fail.

  1. Delete the affected container in the Container registry. For more information, see "パッケージを削除および復元する."

  2. GitHub Enterprise Server の右上で、ご自分のプロフィール フォトをクリックしてから、 [Enterprise 設定] をクリックします。

    GitHub Enterprise Server のプロファイル写真をクリックしたときに表示されるドロップダウン メニューのスクリーンショット。 [エンタープライズ設定] オプションが濃いオレンジ色の枠線で強調表示されています。

  3. Enterprise アカウントのサイドバーで、 [設定] をクリックします。

  4. 左側のサイドバーで、 [パッケージ] をクリックします。

  5. To the right of the number of packages to migrate, click Re-run migration. During the migration, GitHub Enterprise Server will display progress on this page.

  6. If the migration fails again, start from step 1 and re-run the migration.