Migrieren deines Unternehmens von der Docker-Registrierung zur Containerregistrierung

Du kannst Docker-Images, die zuvor in der Docker-Registry auf Ihre GitHub Enterprise Server-Instance gespeichert waren, in die Container registry migrieren.

Wer kann dieses Feature verwenden?

Enterprise owners can migrate Docker images to the Container registry.

In diesem Artikel

Note

Der Container registry befindet sich für GitHub Enterprise Server derzeit in der beta. Ä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 findest du unter Arbeiten mit der Containerregistrierung.

Informationen zur 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 findest du unter Arbeiten mit der Containerregistrierung.

Weitere Informationen zum Konfigurieren von GitHub Packages für Ihre GitHub Enterprise Server-Instance findest du unter Erste Schritte mit GitHub-Paketen für dein Unternehmen.

Informationen zur Migration aus der Docker-Registrierung

Die Container registry ersetzt die Docker-Registrierung von GitHub. Wenn die Docker-Registrierung auf Ihre GitHub Enterprise Server-Instance Images enthält, musst du die Images manuell in die Container registry migrieren.

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. Weitere Informationen zu den Auswirkungen der Migration zur Container registry findest du unter Migrieren zur Containerregistrierung aus der Docker-Registrierung.

Migrieren von Organisationen zur Container registry

Du kannst eine Migration aller Docker-Images deiner Organisation zur 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 bei allen künftigen Uploads von Docker-Images wird die Container registry verwendet.

Wenn ein Siteadministrator 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 deine Benutzer zu gewährleisten, empfiehlt GitHub, dass du die Migration in einer Zeit mit geringerer Aktivität vornimmst.

Warning

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 Speicherbedarf deiner Instanz aufgrund der Duplizierung von Imagedateien in der Docker-Registrierung und Container registry. In einer künftigen Version von GitHub Enterprise Server werden die duplizierten Dateien entfernt, sobald alle Migrationen abgeschlossen sind.

Weitere Informationen zum Überwachen von Leistung und Speicherung von Ihre GitHub Enterprise Server-Instance findest du unter Überwachungs-dashboard.

Starten einer Migration

  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. 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 Status 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

Wenn ein Benutzer vor der Migration ein Paket in der Container registry erstellt hat, dessen Name mit dem eines vorhandenen Pakets in der Docker-Registrierung identisch ist, schlägt die Migration fehl.

  1. Lösche den betroffenen Container aus der Container registry. Weitere Informationen finden Sie unter 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. Klicke rechts neben der Anzahl der zu migrierenden Pakete auf Migration wiederholen. Während der Migration zeigt GitHub Enterprise Server den Status auf dieser Seite an.

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