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

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

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

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

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

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

   Shell

   gh extension install github/gh-ado2gh
   

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

   Shell

   gh extension upgrade github/gh-ado2gh
   

В любой момент, когда вам нужна помощь с данными ADO2GH extension, можно использовать --help флаг с помощью команды. Например, gh ado2gh --help перечислит все доступные команды и gh ado2gh migrate-repo --help отобразит список всех параметров, доступных для migrate-repo команды.

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

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

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

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

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

     Shell

     export GH_PAT="TOKEN"
     export ADO_PAT="TOKEN"
     

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

     Shell

     $env:GH_PAT="TOKEN"
     $env:ADO_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.