Die Migrationstypen
Es gibt drei Migrationstypen, die von Ihnen durchgeführt werden können:
- Eine Migration von einer GitHub Enterprise Server-Instanz zu einer anderen vorhandenen GitHub Enterprise Server-Instanz. Sie können eine beliebige Anzahl an Repositorys migrieren, die einem Benutzer oder einer Organisation auf der Instanz gehören. Vor dem Durchführen einer Migration müssen Sie über Websiteadministratorzugriff auf beide Instanzen verfügen.
- Eine Migration von einer GitHub.com-Organisation zu einer GitHub Enterprise Server-Instanz. Sie können eine beliebige Anzahl an Repositorys migrieren, die einer Organisation gehören. Vor dem Durchführen einer Migration müssen Sie über Verwaltungszugriff auf die GitHub.com-Organisation und über Website-Administratorzugriff auf die Zielinstanz verfügen.
- Testausführungen sind Migrationen, die Daten in eine Staging-Instanz importieren. Mit diesen kann nachvollzogen werden, was passieren würde, wenn eine Migration auf GitHub.com angewendet würde. Es wird dringend empfohlen, dass Sie einen Probelauf auf einer Testinstanz durchführen, bevor Sie Daten in Ihre Produktionsinstanz importieren.
Note
Die Verwendung von „ghe-migrator“ zum Übertragen einer GitHub Enterprise Server-Instanz zwischen Hypervisoren wird nicht empfohlen. Stattdessen wird empfohlen, die Instanz mit GitHub Enterprise Server Backup Utilities zu sichern und am neuen Speicherort wiederherzustellen, oder ein Replikats am neuen Speicherort zu erstellen und dann ein Failover zur Replikatappliance auszuführen. Weitere Informationen findest du unter Konfigurieren von Sicherungen auf einer Instanz, Hochverfügbarkeitsreplikat erstellen und Initiieren eines Failovers zu deiner Replikat-Appliance.
Migrierte Daten
Bei „ghe-migrator“ dreht sich alles um ein Repository. Die meisten einem Repository zugeordneten Daten können migriert werden. Beispielsweise migriert ein Repository in einer Organisation das Repository und die Organisation sowie die dem Repository zugeordneten Benutzer, Teams, Issues und Pull Requests.
Die Elemente in der folgenden Tabelle können mit einem Repository migriert werden. Alle Elemente, die nicht in der Liste der migrierten Daten angezeigt werden, können nicht migriert werden, einschließlich Git LFS-Objekten.
Note
Forkbeziehungen bleiben nach einer Migration nicht bestehen.
| Einem migrierten Repository zugeordnete Daten | Notizen |
|---|---|
| Benutzer | @mentions der Benutzer werden neu geschrieben, um dem Ziel zu entsprechen. |
| Organisationen | Der Name und die Details einer Organisation werden migriert. |
| Repositorys | Links zu Git-Strukturen, Blobs, Commits und Zeilen werden neu geschrieben, um dem Ziel zu entsprechen. Interne Repositorys werden als private Repositorys migriert. Der Archivstatus wird gelöscht. |
| Wikis | Alle Wiki-Daten werden migriert. |
| Teams | @mentions der Benutzer werden neu geschrieben, um dem Ziel zu entsprechen. |
| Meilensteine | Zeitstempel werden beibehalten. |
| Projects (classic)-Boards | Projekte (klassisch), die dem Repository und der Organisation, welcher das Repository gehört, zugeordnet sind, werden migriert. Projects, die völlig neue Benutzeroberfläche für Projekte, wird nicht unterstützt. |
| Probleme | Issue-Verweise und Zeitstempel werden beibehalten. |
| Issue-Kommentare | Querverweise auf Kommentare werden für die Zielinstanz neu geschrieben. |
| Pull Requests | Querverweise auf Pull Request werden neu geschrieben, um dem Ziel zu entsprechen. Zeitstempel werden beibehalten. |
| Pull-Request-Reviews | Pull-Request-Reviews und zugeordnete Daten werden migriert. |
| Pull-Request-Review-Kommentare | Querverweise auf Kommentare werden für die Zielinstanz neu geschrieben. Zeitstempel werden beibehalten. Kommentare auf Dateiebene werden nicht migriert. |
| Commit-Kommentare | Querverweise auf Kommentare werden für die Zielinstanz neu geschrieben. Zeitstempel werden beibehalten. |
| Releases | Die Daten sämtlicher Versionen werden migriert. |
| Bei Pull Requests oder Issues ergriffene Maßnahmen | Alle Änderungen an Pull Requests oder Issues, beispielsweise das Zuweisen von Benutzern, das Umbenennen von Titeln und das Ändern von Kennzeichnungen, werden zusammen mit den Zeitstempeln für die jeweilige Aktion beibehalten. |
| Dateianlagen | Dateianhänge für Issues und Pull Requests wurden migriert. Sie können diese als Bestandteil der Migration deaktivieren. |
| webhooks | Nur aktive Webhooks werden migriert. |
| Repository-Deployment-Schlüssel | Repository-Deployment-Schlüssel werden migriert. |
| Geschützte Branches | Die Einstellungen für geschützte Branches und die zugeordneten Daten werden migriert. |
Informationen zur Migration externer Authentifizierungsdaten
Wenn der Quellspeicherort für Ihre Migration ein GitHub-Produkt ist, das LDAP- oder SAML-Authentifizierung verwendet, werden externe Authentifizierungsdaten, die mit Benutzerkonten verknüpft sind, nicht von ghe-migrator migriert. Weitere Informationen zu Authentifizierungsoptionen findest du unter GitHub Enterprise Server, unter „Informationen zur Authentifizierung für dein Unternehmen“ in der GitHub Enterprise Server-Dokumentation oder in der GitHub Enterprise Cloud-Dokumentation.
Wenn Sie zu einer Zielinstanz migrieren und dann die externe Authentifizierung konfigurieren, müssen sich Benutzer mit einem Benutzerkonto bei der Zielinstanz anmelden, das denselben Benutzernamen oder dieselbe Benutzer-ID wie das Konto in der Quellinstanz aufweist. Administratoren können das externe Attribut überprüfen, das eine Instanz zum Zuordnen von Benutzerkontonamen aus der Verwaltungskonsole verwendet. Weitere Informationen finden Sie unter Zugreifen auf die Verwaltungskonsole.