Phase 5. Migrer vos référentiels d’Azure DevOps vers Github

Effectuez une exécution d’évaluation, puis migrez vos référentiels d’Azure DevOps vers GitHub.

Dans cet article

Prerequisites

  • Vous devez avoir terminé toutes les phases précédentes de ce guide.
  • 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, veuillez consulter la section Phase 1. Comprendre les migrations d’Azure DevOps vers 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.

Générer un script de migration

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.

Pour générer un script de migration, exécutez la commande gh ado2gh generate-script.

Shell
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
SOURCENom de l’organisation source
DESTINATIONNom de l’organisation de destination
FILENAMENom 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.

Arguments supplémentaires

ArgumentDescriptif
--target-api-url TARGET-API-URLSi 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.
--allAjoutez des fonctionnalités supplémentaires au script, telles que le recâblage des pipelines, la création d'équipes et la configuration d’intégrations Azure Boards.
--download-migration-logsTé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.

Examen du script de migration

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-repo correspondant.
  • 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.

Effectuer un essai

  1. Créez une organisation de test pour vos migrations d’essai.

    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é.

  2. Exécutez les migrations d’essai.

  3. Vérifiez que vous êtes en mesure d’effectuer les tâches de suivi dans Phase 6. Tâches de suivi.

  4. Demandez aux utilisateurs de valider les résultats des migrations.

  5. Résolvez les problèmes découverts par vos migrations d’essai.

  6. Si vous le souhaitez, supprimez l’organisation de test.

Migrer des dépôts

Si 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.

Avertissement

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.

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

  • Si vous employez PowerShell, utilisez .\.

    Shell
    .\FILENAME

Prochaines étapes

Dans la phase suivante et finale, vous allez effectuer des tâches de suivi, vérifier les journaux et préparer vos référentiels à utiliser. Consultez Phase 6. Tâches de suivi.