Prerequisites
- You must have completed all previous phases of this guide.
- Assurez-vous que vous comprenez les données qui seront migrées et les limitations de prise en charge connues de l’importateur. For more information, see Understand migrations from Azure DevOps to GitHub.
- Bien que cela ne soit pas obligatoire, nous vous recommandons d’interrompre votre travail pendant votre migration de production. Importer ne prend pas en charge les migrations delta, donc aucune modification apportée pendant la migration ne sera migrée. Si vous choisissez de ne pas interrompre le travail pendant votre migration de production, vous devrez migrer manuellement ces modifications.
Generate a migration script
Si vous souhaitez migrer simultanément plusieurs dépôts vers GitHub Enterprise Cloud, utilisez GitHub CLI pour générer un script de migration. Le script résultant contiendra une liste de commandes de migration, une par dépôt.
Remarque
La génération d’un script génère un script PowerShell. Si vous utilisez le Terminal, vous devez générer le script avec l’extension de fichier .ps1 et installer PowerShell pour Mac ou Linux pour l’exécuter.
To generate a migration script, run the gh ado2gh generate-script command.
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
Remplacez les espaces réservés dans la commande ci-dessus par les valeurs suivantes.
| Espace réservé | Valeur |
|---|---|
| SOURCE | Nom de l’organisation source |
| DESTINATION | Nom de l’organisation de destination |
| FILENAME | Nom de fichier du script de migration résultant Si vous utilisez le Terminal, choisissez une extension de fichier .ps1, car le script généré exige l’exécution de PowerShell. Vous pouvez installer PowerShell pour Mac ou Linux. |
Additional arguments
| Argument | Description |
|---|---|
--target-api-url TARGET-API-URL | Si vous migrez vers GHE.com, ajoutez --target-api-url TARGET-API-URL, où TARGET-API-URL est l'URL de l'API de base pour le sous-domaine de votre entreprise. Par exemple : https:/. |
--all | Add additional functionality to the script, such as rewiring pipelines, creating teams, and configuring Azure Boards integrations. |
--download-migration-logs | Download the migration log for each migrated repository. For more information about migration logs, see Accès à vos journaux de migration pour GitHub Enterprise Importer. |
Reviewing the migration script
Après avoir généré le script, passez en revue le fichier et, éventuellement, modifiez le script.
- S’il y a des dépôts que vous ne souhaitez pas migrer, supprimez ou commentez les lignes correspondantes.
- Si vous souhaitez que les dépôts aient un nom différent dans l’organisation de destination, mettez à jour la valeur de l’indicateur
--target-repocorrespondant. - Si vous souhaitez modifier la visibilité d’un nouveau référentiel, mettez à jour la valeur de l’indicateur correspondant
--target-repo-visibility. Par défaut, le script définit la même visibilité que le référentiel source.
Perform a trial run
Pour vous aider à identifier les problèmes qui peuvent être propres à votre entreprise, nous vous recommandons vivement d’effectuer un essai de votre migration. Avec un essai, vous apprendrez :
- Indique si la migration d’un référentiel donné peut se terminer correctement.
- Indique si vous pouvez récupérer le référentiel migré vers un état utilisable.
- Combien de temps une migration prendra-t-elle pour s'exécuter.
Les exécutions d’essai peuvent se produire à tout moment et le travail n’a pas besoin d’arrêter pendant la migration. Pour réduire le temps nécessaire à l’exécution de vos migrations d’essai, vous pouvez planifier les lots de vos exécutions d’essai les unes à la suite des autres. Les utilisateurs de ces dépôts peuvent ensuite valider les résultats quand ils veulent.
-
Create a test organization for your trial migrations.
You can use a single organization for all trial runs, or you can create one test organization for each intended destination organization. Consider including
-sandboxat the end of the organization names, to clarify that the organizations are intended only for migration validation and not for production. You can delete the test organizations after you're done. -
Run the trial migrations.
-
Confirm that you are able to complete the follow-up tasks in Follow-up tasks.
-
Ask users to validate the results of the migrations.
-
Resolve any issues uncovered by your trial migrations.
-
Si vous le souhaitez, supprimez l’organisation de test.
Migrate repositories
If your trial run was successful, and you were able to complete the follow-up tasks, you can proceed to the real migration.
Avertissement
We recommend halting work in the repositories you are migrating. Any changes made during or after the migration will need to be manually migrated.
Pour migrer plusieurs référentiels, exécutez le script que vous avez généré. Remplacez FILENAME dans les commandes ci-dessous par le nom de fichier que vous avez fourni lors de la génération du script.
-
Si vous employez le Terminal, utilisez
./.Shell ./FILENAME
./FILENAME -
Si vous employez PowerShell, utilisez
.\.Shell .\FILENAME
.\FILENAME