Um Repositorys von GitLab zu GitHubmigrieren, benötigen Sie ausreichend Zugriff auf die Quelle (ein Projekt auf GitLab) und das Ziel (eine Organisation auf GitHub). Nachdem Sie die Schritte in diesem Artikel ausgeführt haben, sind Ihr Zugriff und Ihre Berechtigungen für Ihre Migration bereit.
Entscheiden, wer die Migration durchführen soll
Wenn es sich bei der Person, die die Migration durchführt, nicht um einen GitHub Organisationsbesitzer handelt, muss ihm ein GitHub Organisationsbesitzer zuerst die Migrationsrolle erteilen.
- Wenn Sie Besitzer einer GitHub Organisation sind und die Migration selbst durchführen möchten, können Sie diesen Leitfaden weiter lesen.
- Wenn Sie die Migrationsrolle einer anderen Person zuweisen möchten, führen Sie dies jetzt aus. Anschließend muss der Migrator die restlichen Schritte in diesen Leitfäden ausführen. Siehe Gewährung der Migriererolle.
Erstellen Sie ein personal access token (classic) auf GitHub
Als Nächstes müssen Sie ein personal access token (classic) erstellen, welches das GL2GH extension of the GitHub CLI zum Kommunizieren mit GitHub verwendet. Die Bereiche, die für Ihre GitHubpersonal access token (classic) Aufgabe erforderlich sind, hängen von Ihrer Rolle und der Aufgabe ab, die Sie abschließen möchten.
Hinweis
Du kannst nur ein personal access token (classic) verwenden, kein fine-grained personal access token. Dies bedeutet, dass Sie nicht verwenden GitHub Enterprise Importer können, wenn Ihre Organisation die Richtlinie "Zugriff auf Ihre Organisationen einschränken personal access tokens (classic) " verwendet. Weitere Informationen finden Sie unter Erzwingen von Richtlinien für persönliche Zugriffstoken in deinem Unternehmen.
| Aufgabe | Organisationsbesitzer | Migrator |
|---|---|---|
| Zuweisung der Migrator-Rolle für Repository-Migrationen | admin:org | |
| Ausführen einer Repositorymigration (Zielorganisation) | ||
repo, workflow``admin:org | ||
repo, workflow``read:org | ||
| Herunterladen eines Migrationsprotokolls | ||
repo, workflow``admin:org | ||
repo, workflow``read:org | ||
| Freigeben von Mannequins | ||
repo, workflow``admin:org |
Informationen zum Erstellen des Tokens finden Sie unter Verwalten deiner persönlichen Zugriffstoken.
Erstellen eines auf personal access token GitLab
Ihr GitLab personal access token muss über die Bereiche und read_repository Bereiche api verfügen.
Für selbstverwaltete GitLab-Instanzen muss das Token einem Administrator angehören, damit der Export abgeschlossen ist und die Benutzerzuordnung beibehalten wird.
Informationen zum Erstellen des Tokens finden Sie Personal access tokens in der GitLab-Dokumentation.
Konfigurieren Sie IP-Zulassungslisten auf GitHub
Wenn Sie die Funktion „IP-Zulassungsliste“ von GitHub verwenden, müssen Sie die nachfolgend aufgeführten IP-Bereiche von GitHub in die Zulassungsliste für die Zielorganisation aufnehmen. Weitere Informationen findest du unter Verwaltung erlaubter IP-Adressen für deine Organisation oder Einschränken des Netzwerkdatenverkehrs in deinem Unternehmen mit einer Liste zugelassener IP-Adressen.
Wenn Ihre Zielorganisation aktiviert GitHub.com ist, müssen Sie die folgenden IP-Adressen zulassen:
- 192.30.252.0/22
- 185.199.108.0/22
- 140.82.112.0/20
- 143.55.64.0/20
- 135.234.59.224/28 (hinzugefügt am 28. Juli 2025)
- 2a0a:a440::/29
- 2606:50c0::/32
- 20.99.172.64/28 (hinzugefügt am 28. Juli 2025)
Wenn Ihre Zielorganisation aktiviert GHE.com ist, hängen die Bereiche, die Sie zulassen müssen, von Ihrer Daten-Residency-Region ab. Sie können eine up-to-Datumsliste der IP-Bereiche abrufen, die /meta vom GitHub Enterprise Importer Endpunkt der REST-API verwendet werden. Der github_enterprise_importer-Schlüssel in der Antwort enthält eine Liste der IP-Bereiche, die für Migrationsvorgänge verwendet werden.
Ermöglicht, dass Migrationen Repository-Regelsätze umgehen.
Wenn die Zielorganisation oder das Unternehmen Regelsätze aktiviert hat, kann der Verlauf des migrierten Repositorys gegen diese Regeln verstoßen. Um die Migration zuzulassen, ohne Ihre Rulesets zu deaktivieren, fügen Sie „Repository-Migrationen” der Ausnahmeliste für jedes anwendbare Ruleset hinzu. Diese Umgehung gilt nur während der Migration. Sobald dies abgeschlossen ist, werden Regelsätze auf alle neuen Beiträge angewendet.
So konfigurieren Sie die Umgehung:
- Navigieren Sie zu jedem Unternehmens- oder Organisationsregelsatz.
- Klicken Sie im Abschnitt "Umgehungsliste" auf "Umgehungsumgehung hinzufügen".
- Wählen Sie Repository-Migrationen aus.
Weitere Informationen findest du unter Erstellen von Regelsätzen für Repositorys in deiner Organisation und Festlegen von Regelsatzumgehungen für Repositorymigrationen.
Exporte auf GitLab aktivieren
Die GitLab-Projekte, die Sie migrieren möchten, müssen für Exporte aktiviert sein. Siehe Aktivieren der Projektexport- und Sidekiq-Konfiguration für Importe in der GitLab-Dokumentation.