Hinweis
Enterprise Live Migrations ist in Öffentliche Vorschau und kann geändert werden.
Ist unsere GitHub Enterprise Server Instanz bereit?
ELM ist in den neuesten Patchversionen für GitHub Enterprise Server 3.17 und höher verfügbar. In dieser Dokumentation wird davon ausgegangen, dass Sie die folgende Patchversion oder höher verwenden. Die Anweisungen funktionieren möglicherweise nicht in früheren Versionen.
3.21.23.20.43.19.83.18.113.17.17
Ihre GitHub Enterprise Server Instanz muss auch:
- Verwenden Sie eine HTTPS-URL . HTTP-URLs werden nicht unterstützt.
- Ausgehenden Datenverkehr zum Migrationsziel zulassen.
- Aktivieren Sie Migrationen im Abschnitt „Migrationen“ der Verwaltungskonsole.
- Bereiten Sie sich während der Migration auf eine zusätzliche Last vor: Die Repositoryarchivierung verursacht alle Probleme und Pullanforderungen im Repository, die von MySQL abgerufen und in Elasticsearch neu indiziert werden.
Wie sieht unsere Zielorganisation aus?
Sie können Repositories zu einer neuen oder vorhandenen Organisation auf GHE.com migrieren. ELM erstellt die Zielorganisation, wenn sie noch nicht vorhanden ist.
Eine Plattformmigration ist eine gute Gelegenheit, Ihre Organisation und Teamstruktur zu überdenken. Siehe Bewährte Methoden zum Organisieren von Arbeiten in Ihrem Unternehmen.
Welche Repositorys werden migriert?
ELM unterstützt bis zu 10 gleichzeitige Repositorymigrationen aus einer einzigen GitHub Enterprise Server Instanz und 20 gleichzeitige Migrationen pro Zielunternehmen.
Planen Sie, welche Repositorys Sie zuerst mit ELM migrieren und welche Sie später oder mit einem anderen Migrationstool migrieren können. Repositories, die wahrscheinlich von ELM profitieren werden, sind:
- Wichtige Repositorys, bei denen lange Ausfallzeiten Ihr Unternehmen stören würden
- Große Monorepos, die für andere Migrationstools zu groß sind
Öffentliche Repositorys sind nicht auf GHE.com verfügbar und werden von ELM abgelehnt. Sie können die Sichtbarkeit dieser Repositorien GitHub Enterprise Server ändern, bevor Sie beginnen.
Sie sollten überprüfen, ob die von Ihnen ausgewählten Repositorys keine Releaseressourcen enthalten, die über 2 GB sind, da dies der Grenzwert für ELM.
Wer führt die Migration aus?
Die Person, die eine ELM Migration ausführt, muss:
- Websiteadministratorzugriff auf die GitHub Enterprise Server Instanz haben
- Als Unternehmensbesitzer im GHE.com Unternehmen agieren
Diese Person muss die folgenden Aufgaben ausführen:
- Erstellen Sie personal access tokens (classic) vor der Migration sowohl im Quell- als auch im Zielunternehmen.
- Überwachen Sie während der Migration den Migrationsstatus, und reagieren Sie auf Probleme.
Bei gleichzeitigen ELM Migrationen aus einer GitHub Enterprise Server Instanz muss dieselbe Person alle elm Befehle mit denselben Token ausführen.
Nach der Migration muss jemand einige Nachverfolgungsaufgaben GHE.comausführen. Jeder Organisationsbesitzer kann dies tun.
Was sollten meine Entwickler wissen?
Bevor Sie beginnen, kommunizieren Sie mit Entwicklern, die:
- Das Repository wird an einen neuen Speicherort verschoben. Benutzer können das Quell-Repository während der Migration weiterhin verwenden, bis der Operator den endgültigen Übernahmevorgang an den neuen Speicherort beginnt. Nach dem Cutover wird das Quell-Repository archiviert und ist daher schreibgeschützt, es sei denn, die Archivierung wird von einem Repository-Administrator aufgehoben.
- Während die Migration ausgeführt wird, sollten Entwickler keine erzwungenen Pushs an das Repository vornehmen, da diese den Git-Verlauf auf eine Weise unterbrechen, die ELM nicht beheben kann.
- Bestimmte Aktionen, die Entwickler während des Migrationsprozesses ausführen, werden möglicherweise nicht im migrierten Repository wiedergegeben. Ausführliche Informationen finden Sie in den nicht unterstützten Aktionen in Migrierte Daten für Livemigrationen von GitHub Enterprise Server zu GHE.com.
Nächste Schritte
Wenn Sie bereit sind, eine Migration auszuführen, lesen Sie Migrieren Ihres Repositorys mit Enterprise Live-Migrationen.