{"meta":{"title":"Migrer vos dépôts de Azure DevOps vers GitHub","intro":"Effectuez une exécution d’évaluation, puis migrez vos référentiels de Azure DevOps vers GitHub.","product":"Migrations","breadcrumbs":[{"href":"/fr/migrations","title":"Migrations"},{"href":"/fr/migrations/ado","title":"Migrer à partir de Azure DevOps"},{"href":"/fr/migrations/ado/migrate-your-repositories-from-azure-devops-to-github","title":"5. Migrer des dépôts"}],"documentType":"article"},"body":"# Migrer vos dépôts de Azure DevOps vers GitHub\n\nEffectuez une exécution d’évaluation, puis migrez vos référentiels de Azure DevOps vers GitHub.\n\n## Prerequisites\n\n* Vous devez avoir terminé toutes les phases précédentes de ce guide.\n* Assurez-vous que vous comprenez les données qui seront migrées et les limitations de prise en charge connues de l’importateur. Pour plus d’informations, consultez [Comprendre les migrations de Azure DevOps vers GitHub](/fr/migrations/ado/understand-migrations-from-azure-devops-to-github).\n* 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.\n\n## Générer un script de migration\n\nSi 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.\n\n> \\[!NOTE]\n> 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](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-macos?view=powershell-7.2) ou [Linux](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux?view=powershell-7.2) pour l’exécuter.\n\nPour générer un script de migration, exécutez la commande `gh ado2gh generate-script`.\n\n```shell copy\ngh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME\n```\n\nRemplacez les espaces réservés dans la commande ci-dessus par les valeurs suivantes.\n\n| Espace réservé | Valeur                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |\n| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| SOURCE         | Nom de l’organisation source                                                                                                                                                                                                                                                                                                                                                                                                                                                       |\n| DESTINATION    | Nom de l’organisation de destination                                                                                                                                                                                                                                                                                                                                                                                                                                               |\n| FILENAME       | Nom de fichier du script de migration résultant<br><br>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](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-macos?view=powershell-7.2) ou [Linux](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux?view=powershell-7.2). |\n\n### Arguments supplémentaires\n\n| Argument                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                |\n| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `--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://api.octocorp.ghe.com`.                                                                                                                                                                                                                                                               |\n| `--all`                           | Ajoutez des fonctionnalités supplémentaires au script, telles que le rewiring pipelines, la création d’équipes et la configuration des intégrations Azure Boards.                                                                                                                                                                                                                                                                                                          |\n| `--download-migration-logs`       | Téléchargez le journal de migration pour chaque référentiel migré. Pour plus d'informations sur les journaux de migration, veuillez consulter la section [Accès à vos journaux de migration pour GitHub Enterprise Importer](/fr/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer#downloading-all-the-repository-migration-logs-for-a-migration-script). |\n\n## Examen du script de migration\n\nAprès avoir généré le script, passez en revue le fichier et, éventuellement, modifiez le script.\n\n* S’il y a des dépôts que vous ne souhaitez pas migrer, supprimez ou commentez les lignes correspondantes.\n* 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-repo` correspondant.\n* 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.\n\n## Effectuer un essai\n\nPour 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 :\n\n* Indique si la migration d’un référentiel donné peut se terminer correctement.\n* Indique si vous pouvez récupérer le référentiel migré vers un état utilisable.\n* Combien de temps une migration prendra-t-elle pour s'exécuter.\n\nLes 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.\n\n1. Créez une organisation de test pour vos migrations d’essai.\n\n   Vous pouvez utiliser une seule organisation pour toutes les exécutions d’essai, ou vous pouvez créer une organisation de test pour chaque organisation de destination prévue. Pensez à inclure `-sandbox` à la fin des noms d’organisation pour clarifier que les organisations sont destinées uniquement à la validation de la migration et non à la production. Vous pouvez supprimer les organisations de test une fois que vous avez terminé.\n\n2. Exécutez les migrations d’essai.\n\n3. Vérifiez que vous êtes en mesure d’effectuer les tâches de suivi dans [Tâches de suivi](/fr/migrations/ado/follow-up-tasks).\n\n4. Demandez aux utilisateurs de valider les résultats des migrations.\n\n5. Résolvez les problèmes découverts par vos migrations d’essai.\n\n6. Si vous le souhaitez, supprimez l’organisation de test.\n\n## Migrer des dépôts\n\nSi l'exécution de votre essai a été réussie et que vous avez pu effectuer les tâches de suivi, vous pouvez passer à la migration réelle.\n\n> \\[!WARNING] Nous vous recommandons de suspendre vos activités dans les référentiels que vous migrez. Toutes les modifications apportées pendant ou après la migration doivent être migrées manuellement.\n\nPour 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.\n\n* Si vous employez le Terminal, utilisez `./`.\n\n  ```shell copy\n  ./FILENAME\n  ```\n\n* Si vous employez PowerShell, utilisez `.\\`.\n\n  ```shell copy\n  .\\FILENAME\n  ```"}