Installer et configurer GitHub Enterprise Importer

Étape 1 : Installer le 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 le ADO2GH extension.

1. Installez le GitHub CLI.

   • Pour obtenir des instructions d’installation pour GitHub CLI, consultez le dépôt GitHub CLI.
   • Si vous avez GitHub CLI déjà 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, consultez le GitHub CLI référentiel pour obtenir des instructions de mise à niveau.

2. Installez le ADO2GH extension.

   Shell

   gh extension install github/gh-ado2gh
   

3. La ADO2GH extension of the GitHub CLI est mise à jour chaque semaine. Pour être sûr d’utiliser la version la plus récente, mettez à jour l’extension.

   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 tokens qui peuvent accéder aux organisations source et de destination, puis définir les personal access tokens en tant que variables d’environnement.

1. Vérifiez que vous disposez de vos personal access token pour GitHub et Azure DevOps. Voir Gérer l’accès si vous n’avez pas déjà créé de jeton.

2. Définissez les variables d’environnement pour les personal access tokens, en remplaçant TOKEN dans les commandes ci-dessous par les 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 effectuez une migration vers GitHub Enterprise Cloud avec résidence des données, par commodité, définissez une variable d’environnement pour l’URL de l’API de base pour 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 le GitHub CLI.