Этап 3. Установка и настройка GitHub Enterprise Importer

Установите ADO2GH extension of the GitHub CLI и настройте среду для миграции.

В этой статье

Шаг 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 tokens для GitHub и Azure DevOps. См . раздел AUTOTITLE.

  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.

Дальнейшие шаги

На следующем этапе вы используете GitHub Enterprise Cloud для подготовки к миграции. См . раздел AUTOTITLE.