# Installer et configurer GitHub Enterprise Importer

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

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

   ```shell copy
   gh extension install github/gh-gl2gh
   ```

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

   ```shell copy
   gh extension upgrade github/gh-gl2gh
   ```

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

Avant de pouvoir utiliser la GL2GH extension migration vers GitHub Enterprise Cloud, vous devez créer personal access tokendes s qui peuvent accéder à la source et à la destination, puis définir les personal access tokens en tant que variables d’environnement.

1. Assurez-vous d’avoir vos personal access tokens pour les deux GitHub et GitLab prêts. Voir [Gérer l’accès à une migration de GitLab vers GitHub](/fr/enterprise-cloud@latest/migrations/using-github-enterprise-importer/migrate-from-gitlab/manage-access) 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. Utiliser `GH_PAT` pour l’organisation de destination et `GITLAB_PAT` pour l’instance GitLab source.

   * Si vous utilisez le Terminal, utilisez la commande `export`.

     ```shell copy
     export GH_PAT="TOKEN"
     export GITLAB_PAT="TOKEN"
     ```

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

     ```shell copy
     $env:GH_PAT="TOKEN"
     $env:GITLAB_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.