Этап 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.