# Installer et configurer GitHub Enterprise Importer

ADO2GH extension of the GitHub CLI Installez et configurez votre environnement pour la migration.

## É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](https://github.com/cli/cli#installation).
   * 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](https://github.com/cli/cli#installation) pour obtenir des instructions de mise à niveau.

2. Installez le ADO2GH extension.

   ```shell copy
   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 copy
   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](/fr/enterprise-cloud@latest/migrations/ado/manage-access?token-backtrack#create-a-personal-access-token-classic-on-github) 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 copy
     export GH_PAT="TOKEN"
     export ADO_PAT="TOKEN"
     ```

   * Si vous utilisez PowerShell, utilisez la commande `$env`.

     ```shell copy
     $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 copy
     export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     ```

   * Si vous utilisez PowerShell, utilisez la commande `$env`.

     ```shell copy
     $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.