Docker レジストリからコンテナー レジストリへの Enterprise の移行

お使いの GitHub Enterprise Server インスタンス上の Docker レジストリに以前に格納されていた Docker イメージをContainer registryに移行できます。

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

Enterprise owners can migrate Docker images to the Container registry.

この記事で

メモ

現在、Container registry は パブリック プレビュー に対して GitHub Enterprise Server 段階であり、変更される可能性があります。

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

Container registry について

Container registry は、Organization または個人アカウント内にコンテナー イメージを格納し、イメージをリポジトリに関連付けることができます。 権限をリポジトリから継承するか、リポジトリとは別に細かい権限を設定するかを選ぶことができます。 パブリック コンテナー イメージに匿名でアクセスすることもできます。 詳細については、 AUTOTITLE を参照してください。

GitHub Packagesのお使いの GitHub Enterprise Server インスタンスの構成の詳細については、エンタープライズ向けの GitHub パッケージの始め方 を参照してください。

Docker レジストリからの移行について

Container registry は、GitHub の Docker レジストリに置き換えられます。 お使いの GitHub Enterprise Server インスタンス上の Docker レジストリにイメージが含まれている場合は、イメージをContainer registryに手動で移行する必要があります。

メモ

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

Docker レジストリ、GitHub Actions の名前空間を使用するあらゆるスクリプトまたは docker.HOSTNAME ワークフローは、Container registry の containers.HOSTNAME に移行した後も引き続き動作します。 Container registryへの移行の影響の詳細については、Dockeerレジストリからコンテナレジストリへの移行 を参照してください。

組織をContainer registryに移行する

すべての組織の Docker イメージの Container registryへの移行を開始できます。 移行操作の期間は、移行するイメージの合計数とインスタンスでの全体的な負荷によって異なります。 移行が成功すると、 GitHub Enterprise Server に概要が表示され、今後の Docker イメージのすべてのアップロードで Container registryが使用されます。

サイト管理者が お使いの GitHub Enterprise Server インスタンスの電子メール通知を構成している場合は、移行が完了した後に電子メールが届きます。 詳しくは、「通知のためのメール設定」をご覧ください。

移行中

移行中は、お使いのインスタンスの CPU とメモリの使用量が増加します。 ユーザーのインスタンスのパフォーマンスを確保するために、 GitHub は、アクティビティの減少期間中に移行を開始することをお勧めします。

警告

Enterprise の設定を変更したり、管理 SSH セッションから ghe-config-apply を実行したりしないでください。 これらのアクションによって構成の実行がトリガーされます。これによってサービスが再起動される場合があり、移行が中断される恐れがあります。

移行後

移行後、Docker レジストリと Container registryのイメージ ファイルの重複により、インスタンスのストレージ負荷が増加します。 GitHub Enterprise Serverの今後のリリースでは、すべての移行が完了すると、重複したファイルが削除されます。

お使いの GitHub Enterprise Server インスタンスのパフォーマンスとストレージの監視の詳細については、AUTOTITLE を参照してください。

移行の開始

  1. GitHub Enterprise Server の右上隅にあるプロフィール画像をクリックしてから、[Enterprise settings] をクリックします。
  2. ページの上部にある [ Settings] をクリックします。
  3. 左側のサイドバーで、 [パッケージ] をクリックします。
  4. 移行するパッケージ数の右側にある [移行の開始] をクリックします。 移行中、 GitHub Enterprise Server はこのページに進行状況を表示します。

移行が完了すると、このページに結果が表示されます。 移行が失敗した場合、このページには、エラーの原因となったパッケージを所有している Organization が表示されます。

失敗した Organization 移行の再実行

移行前に、ユーザーが Docker レジストリ内の既存のパッケージと同じ名前のパッケージを Container registry に作成した場合、移行は失敗します。

  1. Container registry内の影響を受けるコンテナーを削除します。 詳しくは、「パッケージを削除および復元する」をご覧ください。

  2. GitHub Enterprise Server の右上隅にあるプロフィール画像をクリックしてから、[Enterprise settings] をクリックします。

  3. ページの上部にある [ Settings] をクリックします。

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

  5. 移行するパッケージ数の右側にある [移行の再実行] をクリックします。 移行中、 GitHub Enterprise Server はこのページに進行状況を表示します。

  6. 移行が再び失敗した場合は、手順 1 から開始して移行をもう一度実行します。