Установка и настройка GitHub Enterprise Importer

Шаг 1: Установите GL2GH extension of the GitHub CLI

GitHub Enterprise Importer — это коллекция расширений для GitHub CLI. Если это ваша первая миграция, вам нужно будет установить GitHub CLI и .GL2GH extension

1. Установите GitHub CLI.

   • Инструкции по установке для GitHub CLI см. в репозитории GitHub CLI.
   • Если уже установлена GitHub CLI , запустите gh --version , чтобы убедиться, что у вас версия 2.4.0 или новее. Если у вас более старая версия, посетите GitHub CLI репозиторий для инструкций по обновлению.

2. Установите GL2GH extension.

   Shell

   gh extension install github/gh-gl2gh
   

3. Часто GL2GH extension of the GitHub CLI обновляется. Чтобы убедиться, что вы используете последнюю версию, обновите расширение.

   Shell

   gh extension upgrade github/gh-gl2gh
   

Шаг 2: Задайте переменные среды

Прежде чем использовать GL2GH extension миграцию GitHub Enterprise Cloud, необходимо создать personal access tokens, которые могут получить доступ к источнику и назначению, а затем задать s personal access tokenв качестве переменных среды.

1. Убедитесь, что у вас есть ваши personal access tokenвозможности для GitHub обоих и GitLab готовы. Посмотрите Управление доступом для миграции из GitLab в GitHub , если вы ещё не создали токен.

2. Задайте переменные среды для personal access tokens, заменив TOKEN в командах ниже на personal access tokens, которые вы создали ранее. Используется GH_PAT для целевой организации и GITLAB_PAT для исходного экземпляра GitLab.

   • Если вы используете терминал, используйте export команду.

     Shell

     export GH_PAT="TOKEN"
     export GITLAB_PAT="TOKEN"
     

   • Если вы используете PowerShell, используйте $env команду.

     Shell

     $env:GH_PAT="TOKEN"
     $env:GITLAB_PAT="TOKEN"
     

3. Если вы переходите на GitHub Enterprise Cloud с размещением данных, для удобства, установите переменную среды для базового URL API для вашего предприятия.

   Убедитесь, что вы заменили SUBDOMAIN его на поддомен вашего предприятия. Например, если поддоменом вашего предприятия является acme, значением TARGET_API_URL будет .https://api.acme.ghe.com

   • Если вы используете терминал, используйте export команду.

     Shell

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

   • Если вы используете PowerShell, используйте $env команду.

     Shell

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

   Вы используете эту переменную с --target-api-url опцией в командах, которые выполняете с GitHub CLI.