Migrating your enterprise to the Container registry from the Docker registry

You can migrate Docker images previously stored in the Docker registry on Ihre GitHub Enterprise Server-Instance to the Container registry.

Wer kann dieses Feature verwenden?

Enterprise owners can migrate Docker images to the Container registry.

In diesem Artikel

Hinweis: Die Container registry befindet sich für GitHub Enterprise Server derzeit in der Betaphase und kann noch geändert werden.

Sowohl GitHub Packages als auch die Unterdomänenisolation müssen aktiviert sein, um die Container registry verwenden zu können. Weitere Informationen findest du unter Arbeiten mit der Containerregistrierung.

About the Container registry

Die Container registry speichert Containerimages innerhalb deiner Organisation oder deines persönlichen Kontos und ermöglicht es dir, ein Image einem Repository zuzuordnen. Du kannst wählen, ob Berechtigungen von einem Repository geerbt oder präzise Berechtigungen unabhängig von einem Repository festgelegt werden sollen. Du kannst auch anonym auf öffentliche Containerimages zugreifen. For more information, see "Arbeiten mit der Containerregistrierung."

For more information about configuring GitHub Packages for Ihre GitHub Enterprise Server-Instance, see "Erste Schritte mit GitHub-Paketen für dein Unternehmen."

About migration from the Docker registry

Die Container registry ersetzt die Docker-Registrierung von GitHub. If the Docker registry on Ihre GitHub Enterprise Server-Instance contains images, you must manually migrate the images to the Container registry.

Note: GitHub Enterprise Server 3.6 unterstützt die Migration für in Organisationen gespeicherte Docker-Images. In einer künftigen Version wird die Migration von Images im Besitz von Benutzern unterstützt werden.

Alle Skripts oder GitHub Actions-Workflows, die den Namespace für die Docker-Registrierung, docker.HOSTNAME, verwenden, funktionieren auch nach der Migration zur Container registry unter containers.HOSTNAME. For more information about the impact of migration to the Container registry, see "Migrieren zur Containerregistrierung aus der Docker-Registrierung."

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 Ihre GitHub Enterprise Server-Instance, you will receive an email after the migration is complete. For more information, see "E-Mail für Benachrichtigungen konfigurieren."

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 Ihre GitHub Enterprise Server-Instance, see "Auf das Überwachungs-Dashboard zugreifen."

  1. Klicken Sie in der oberen rechten Ecke von GitHub Enterprise Server auf Ihr Profilfoto und dann auf Unternehmenseinstellungen.

    Screenshot des Dropdownmenüs, das angezeigt wird, wenn du auf GitHub Enterprise Server auf das Profilfoto klickst. Die Option „Unternehmenseinstellungen “ ist dunkelorange umrandet.

  2. Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Einstellungen.

  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 "Löschen und Wiederherstellen eines Pakets."

  2. Klicken Sie in der oberen rechten Ecke von GitHub Enterprise Server auf Ihr Profilfoto und dann auf Unternehmenseinstellungen.

    Screenshot des Dropdownmenüs, das angezeigt wird, wenn du auf GitHub Enterprise Server auf das Profilfoto klickst. Die Option „Unternehmenseinstellungen “ ist dunkelorange umrandet.

  3. Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Einstellungen.

  4. Klicke auf der linken Randleiste auf Pakete.

  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.