Migrieren deines Unternehmens von der Docker-Registrierung zur Containerregistrierung

In diesem Artikel

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

Wer kann dieses Feature verwenden?

Enterprise owners can migrate Docker images to the Container registry.

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.

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 deine GitHub Enterprise Server-Instanz 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 deine GitHub Enterprise Server-Instanz Images enthält, musst du die Images manuell in die Container registry migrieren.

Hinweis: 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 zur Auswirkung 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 ist abhängig von der Gesamtanzahl der zu migrierenden Images und der Gesamtauslastung deiner Instanz . 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 deine GitHub Enterprise Server-Instanz konfiguriert hat, empfängst du nach Abschluss der Migration eine E-Mail. Weitere Informationen findest du unter E-Mail für Benachrichtigungen konfigurieren.

Hinweise :

  • 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.
  • Ändere während der Migration keine Einstellungen für dein Unternehmen, oder führe ghe-config-apply in einer administrativen SSH-Sitzung aus. Diese Aktionen lösen eine Konfigurationsausführung aus, wodurch die Dienste neu gestartet werden können, und kann die Migration unterbrechen.
  • 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 zur Überwachung von Leistung und Speicherung von deine GitHub Enterprise Server-Instanz findest du unter 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. Wähle auf der Randleiste des Unternehmenskontos die Option Einstellungen aus.

  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 findest du 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. Wähle auf der Randleiste des Unternehmenskontos die Option Einstellungen aus.

  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.