Installer et configurer GitHub Enterprise Importer

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

Run your migration

Article 4 de 7
Suivant:Configurer le stockage d’objets blob

Dans cet article

É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.
    • 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 GL2GH extension.

    Shell
    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
    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 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
      export GH_PAT="TOKEN"
export GITLAB_PAT="TOKEN"

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

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