Migrieren deines Unternehmens von der Docker-Registrierung zur Containerregistrierung

Sie können Docker-Images, die zuvor in der Docker-Registry auf Ihre GitHub Enterprise Server-Instance gespeichert wurden, in die Container registry migrieren.

Wer kann dieses Feature verwenden?

Enterprise owners can migrate Docker images to the Container registry.

In diesem Artikel

Hinweis

Container registry befindet sich für Öffentliche Vorschau derzeit in der GitHub Enterprise Server. Änderungen sind vorbehalten.

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

Informationen zum 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. Weitere Informationen finden Sie unter Arbeiten mit der Containerregistrierung.

Weitere Informationen zum Konfigurieren von GitHub Packages für Ihre GitHub Enterprise Server-Instance finden Sie unter Erste Schritte mit GitHub-Paketen für Ihr Unternehmen.

Informationen zur Migration aus der Docker-Registrierung

Die Container registry ersetzt die Docker-Registrierung von GitHub. Wenn die Docker-Registry auf Ihre GitHub Enterprise Server-Instance Images enthält, müssen Sie die Images manuell in die Container registry migrieren.

Hinweis

GitHub Enterprise Server 3.6 unterstützt die Migration von in Organisationen gespeicherten 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. Weitere Informationen zu den Auswirkungen der Migration zu Container registry finden Sie unter Migrieren zur Containerregistrierung aus der Docker-Registrierung.

Migrieren von Organisationen zum Container registry

Sie können eine Migration aller Docker-Images Ihrer Organisationen zu Container registry starten. Die Dauer des Migrationsvorgangs hängt von der Gesamtanzahl der zu migrierenden Bilder und der Gesamtlast der Instance ab. Nach einer erfolgreichen Migration zeigt GitHub Enterprise Server eine Zusammenfassung an, und alle zukünftigen Uploads von Docker-Images verwenden Container registry.

Wenn ein Website-Administrator E-Mail-Benachrichtigungen für Ihre GitHub Enterprise Server-Instance konfiguriert hat, erhalten Sie nach Abschluss der Migration eine E-Mail. Weitere Informationen finden Sie unter E-Mail für Benachrichtigungen konfigurieren.

Während der Migration:

Während der Migration erhöht sich die CPU- und Speicherauslastung deiner Instanz. Um die Leistung der Instanz für Ihre Benutzer sicherzustellen, empfiehlt es sich, GitHub während eines Zeitraums reduzierter Aktivitäten eine Migration zu starten.

Warnung

Einstellungen für dein Unternehmen dürfen nicht geändert werden, und ghe-config-apply darf nicht über eine administrative SSH-Sitzung ausgeführt werden. Diese Aktionen lösen eine Konfigurationsausführung aus, wodurch die Dienste neu gestartet werden können, und die Migration unterbrochen werden kann.

Nach der Migration

Nach der Migration erhöht sich der Speicherdruck auf Ihre Instanz aufgrund der Duplizierung von Imagedateien in der Docker-Registrierung und der Container registry. Eine zukünftige Version von GitHub Enterprise Server wird die duplizierten Dateien entfernen, wenn alle Migrationen abgeschlossen sind.

Weitere Informationen zur Überwachung der Leistung und des Speichers von Ihre GitHub Enterprise Server-Instance finden Sie unter Informationen zu den Monitordashboards.

Starten einer Migration

  1. Klicke in der oberen rechten Ecke von GitHub Enterprise Server auf dein Profilbild und dann auf Enterprise settings.
  2. Klicken Sie oben auf der Seite auf "Einstellungen".
  3. Klicke auf der linken Randleiste auf Pakete.
  4. Klicke rechts neben der Anzahl der zu migrierenden Pakete auf Migration starten. Während der Migration zeigt GitHub Enterprise Server den Fortschritt auf dieser Seite an.

Nach Abschluss der Migration werden die Ergebnisse auf dieser Seite angezeigt. Wenn eine Migration fehlschlägt, werden auf der Seite die Organisationen im Besitz des Pakets angezeigt, das den Fehler verursacht hat.

Wiederholen einer fehlgeschlagenen Organisationsmigration

Vor der Migration schlägt die Migration fehl, wenn ein Benutzer in der Container registry ein Paket erstellt hat, das denselben Namen wie ein bereits vorhandenes Paket in der Docker-Registry hat.

  1. Löschen Sie den betroffenen Container in Container registry. Weitere Informationen finden Sie unter Löschen und Wiederherstellen eines Pakets.

  2. Klicke in der oberen rechten Ecke von GitHub Enterprise Server auf dein Profilbild und dann auf Enterprise settings.

  3. Klicken Sie oben auf der Seite auf "Einstellungen".

  4. Klicke auf der linken Randleiste auf Pakete.

  5. Klicke rechts neben der Anzahl der zu migrierenden Pakete auf Migration wiederholen. Während der Migration zeigt GitHub Enterprise Server den Fortschritt auf dieser Seite an.

  6. Wenn die Migration erneut fehlschlägt, beginne bei Schritt 1, und wiederhole die Migration.