Migrer vos dépôts de GitLab vers GitHub

Prerequisites

• Vous devez avoir terminé toutes les phases précédentes de ce guide.
• Le projet GitLab doit être activé pour les exportations. Consultez Activer l’exportation de projet et la configuration Sidekiq pour les importations dans la documentation GitLab.
• 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 GitLab 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.

Exécution d’une exécution d’évaluation

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.

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

Migration d’un référentiel unique

Pour migrer un référentiel, utilisez la gh gl2gh migrate-repo commande.

gh gl2gh migrate-repo \
  --gitlab-server-url GITLAB_SERVER_URL \
  --gitlab-group SOURCE_GROUP \
  --gitlab-project SOURCE_PROJECT \
  --github-org DESTINATION \
  --github-repo NEW_REPO_NAME \
  --use-github-storage

gh gl2gh migrate-repo \
  --gitlab-server-url GITLAB_SERVER_URL \
  --gitlab-group SOURCE_GROUP \
  --gitlab-project SOURCE_PROJECT \
  --github-org DESTINATION \
  --github-repo NEW_REPO_NAME \
  --use-github-storage

Remplacez les espaces réservés dans la commande ci-dessus par les valeurs suivantes.

Si vous n’utilisez GitHub-owned blob storagepas, consultez Configurer le stockage d’objets blob.

Arguments supplémentaires

Génération d’un script de migration

Si vous souhaitez migrer plusieurs référentiels à GitHub Enterprise Cloud la fois, utilisez-le GitHub CLI pour générer un script de migration. Le script résultant contient une migrate-repo commande par dépôt.

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

gh gl2gh generate-script \
  --gitlab-server-url GITLAB_SERVER_URL \
  --github-org DESTINATION \
  --output FILENAME \
  --use-github-storage

gh gl2gh generate-script \
  --gitlab-server-url GITLAB_SERVER_URL \
  --github-org DESTINATION \
  --output FILENAME \
  --use-github-storage

Remplacez les espaces réservés dans la commande ci-dessus par les valeurs suivantes.

Par défaut, le script inclut chaque projet que le jeton peut accéder. Pour étendre le script, ajoutez --gitlab-group GROUPou --gitlab-group GROUP --gitlab-project PROJECT pour un seul projet.

Si vous n’utilisez GitHub-owned blob storagepas, consultez Configurer le stockage d’objets blob.

Arguments supplémentaires

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 --github-repo correspondant.
• Si vous souhaitez modifier la visibilité d’un nouveau référentiel, ajoutez ou mettez à jour l’indicateur correspondant --target-repo-visibility .

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.

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