Bestimmen Sie, wie viel Sie migrieren müssen
Bestimme deinen Zeitplan, der weitgehend deinen Ansatz bestimmen wird. Als ersten Schritt zum Bestimmen deines Zeitplans machst du eine Bestandsaufnahme der zu migrierenden Elemente.
- Anzahl von Repositorys
- Anzahl der Pull Requests
Hinweis
Der Zeitplan für die Migration hängt weitgehend von der Anzahl der Pull Requests in einem Repository ab. Wenn Sie 1.000 Repositorys migrieren möchten und jedes Repository durchschnittlich über 100 Pullanforderungen verfügt, ist Ihre Migration wahrscheinlich sehr schnell. Wenn Sie nur 100 Repositorys migrieren möchten, aber die Repositorys jeweils über 75.000 Pullanforderungen im Durchschnitt verfügen, dauert die Migration viel länger und erfordert mehr Planung und Tests.
Wir empfehlen den inventory-report-Befehl im ADO2GH extension of the GitHub CLI. Dieser Befehl stellt eine Verbindung mit der Azure DevOps-API her und erstellt dann mehrere CSV-Dateien.
repos.csv enthält Informationen zu Ihren Repositorys, einschließlich der Anzahl der Pullanforderungen.
Um die CSV-Dateien zu erstellen, verwenden Sie den folgenden Befehl und ersetzen Sie YOUR_ADO_ORG durch Ihre Organisation in Azure DevOps.
gh ado2gh inventory-report --ado-org YOUR_ADO_ORG
gh ado2gh inventory-report --ado-org YOUR_ADO_ORG
Nachdem Sie die Repositorys inventarisieren, die Sie migrieren müssen, bewerten Sie Ihre Bestandsdaten im Hinblick auf Ihre gewünschte Zeitachse.
- Wenn deine Organisation eine größere Anzahl von Änderungen verträgt, kannst du möglicherweise auch alle deine Repositorys gleichzeitig migrieren und so deine Migration in wenigen Tagen abschließen.
- Wenn Sie Über Teams verfügen, die nicht gleichzeitig migrieren können, möchten Sie Möglicherweise Ihre Migrationen stapeln und an die Zeitachsen der Teams anpassen und ihren Migrationsaufwand erweitern.
Bestimmen Sie die Organisationsstruktur von GitHub
Plane als Nächstes, welche Organisationsstruktur du in GitHub erstellen möchtest. In ADO und GitHub wird die Arbeit eines Unternehmens unterschiedlich organisiert.
- ADO: Organisation > Teamprojekt > Repositorys
- GitHub: Unternehmen > Organisation > Repositorys
Nach der Migration zu GitHub solltest du nur über ein Unternehmenskonto und eine kleine Anzahl von Organisationen verfügen, die sich im Besitz dieses Unternehmens befinden. Jede Organisation in ADO sollte einer einzelnen Organisation in GitHub entsprechen.
Hinweis
Das Konzept eines Teamprojekts, das zum Gruppieren von Repositorys in ADO verwendet wird, gibt es in GitHub nicht. Es wird nicht empfohlen, eine Organisation für GitHub für jedes Teamprojekt in ADO zu erstellen, da dies zu einer großen Liste nicht gruppierter Repositorys innerhalb jeder Organisation führen kann. Du kannst jedoch den Zugriff auf Repositorygruppen verwalten, indem du Teams erstellst.
Wenn Sie Ihren Migrationsaufwand in Batches unterteilen möchten, kann ihnen die neue Struktur helfen, diese zu ermitteln. Wenn du in ADO mehrere Organisationen hast und die Repositorys jeder Organisation Batches mit angemessener Größe ergeben, solltest du die Batchverarbeitung nach Organisation in Betracht ziehen.
Aufgaben zur Strukturierung von Organisationen mit dem Unternehmensmigrationstool
Konfigurieren von Repositoryberechtigungen
Da Berechtigungen in GitHub anders funktionieren als in ADO, versucht GitHub Enterprise Importer nicht, Repositoryberechtigungen von ADO zu migrieren.
Wenn Sie ADO2GH CLI verwenden, erstellt GitHub Enterprise Importer zwei Teams in GitHub für jedes Teamprojekt in ADO. Jedem Team wird eine andere Zugriffsebene auf alle Repositorys gewährt, die aus dem Teamprojekt stammen.
| Mannschaft | Zugriff auf migrierte Repositorys |
|---|---|
| TEAM-PROJECT-Wartungsteam | Maintainer (Teambetreuer) |
| TEAM-PROJECT-Administratoren | Administrierende Person |
Um Zugriff auf migrierte Repositorys zu gewähren, kannst du diesen Teams Personen hinzufügen. Dies kann manuell in GitHub erfolgen. Wenn du die Teams während deiner Migration mit Azure Active Directory-Gruppen (AAD) verknüpfen möchtest, kannst du dies auch über die Gruppenmitgliedschaft in AAD verwalten. Weitere Informationen zur manuellen Verwaltung der Teammitgliedschaft findest du unter Organisationsmitglieder zu einem Team hinzufügen.
Nächste Schritte
In der nächsten Phase führen Sie einen Testlauf durch und migrieren dann Ihre Repositories. Weitere Informationen findest du unter Phase 5. Migrieren Ihrer Repositorys von Azure DevOps zu Github.