Phase 3. Installer et configurer GitHub Enterprise Importer

Étape 1 : Installer ADO2GH extension of the GitHub CLI

GitHub Enterprise Importer est une collection d’extensions pour GitHub CLI. S’il s’agit de votre première migration, vous devez installer GitHub CLI et ADO2GH extension.

1. Installez GitHub CLI. *

   • Si vous avez déjà GitHub CLI installé, exécutez gh --version pour vous assurer que vous exécutez la version 2.4.0 ou ultérieure. Si vous avez une version antérieure, visitez le référentiel GitHub CLI pour obtenir des instructions de mise à niveau.

2. Installez ADO2GH extension.

   Shell

   gh extension install github/gh-ado2gh
   

3. ADO2GH extension of the GitHub CLI est mis à jour toutes les semaines.

   Shell

   gh extension upgrade github/gh-ado2gh
   

Dès que vous avez besoin d’aide sur ADO2GH extension, vous pouvez utiliser l’indicateur --help avec une commande. Par exemple, gh ado2gh --help liste toutes les commandes disponibles et gh ado2gh migrate-repo --help liste toutes les options disponibles pour la commande migrate-repo.

Étape 2 : Définir des variables d’environnement

Avant de pouvoir utiliser ADO2GH extension pour migrer vers GitHub Enterprise Cloud, vous devez créer des personal access token qui peuvent accéder aux organisations source et de destination, puis définir les personal access token en tant que variables d’environnement.

1. Vérifiez que vos personal access token pour GitHub et Azure DevOps soient prêts. Consultez Phase 2. Gérer l’accès.

2. Définissez les variables d’environnement pour les données personal access tokens, en remplaçant TOKEN dans les commandes ci-dessous par les données personal access tokens que vous avez créées précédemment. Utilisez GH_PAT pour l’organisation de destination et ADO_PAT pour l’organisation source.

   • Si vous utilisez le Terminal, utilisez la commande export.

     Shell

     export GH_PAT="TOKEN"
     export ADO_PAT="TOKEN"
     

   • Si vous utilisez PowerShell, utilisez la commande $env.

     Shell

     $env:GH_PAT="TOKEN"
     $env:ADO_PAT="TOKEN"
     

3. Si vous migrez vers GitHub Enterprise Cloud avec résidence des données, pour des raisons pratiques, définissez une variable d'environnement pour l'URL de l'API de base de votre entreprise.

   Vérifiez que vous remplacez SUBDOMAIN par le sous-domaine de votre entreprise. Par exemple, si le sous-domaine de votre entreprise est acme, la TARGET_API_URL valeur est https://api.acme.ghe.com.

   • Si vous utilisez le Terminal, utilisez la commande export.

     Shell

     export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     

   • Si vous utilisez PowerShell, utilisez la commande $env.

     Shell

     $env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     

   Vous allez utiliser cette variable avec l’option --target-api-url dans les commandes que vous exécutez avec les données GitHub CLI.

Prochaines étapes

Dans la phase suivante, vous allez utiliser GitHub Enterprise Cloud pour préparer la migration. Consultez Phase 4. Préparer votre migration d’Azure DevOps vers GitHub.