# Установка и настройка 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](https://github.com/cli/cli#installation).
   * Если уже установлена GitHub CLI , запустите `gh --version` , чтобы убедиться, что у вас версия 2.4.0 или новее. Если у вас более старая версия, посетите [GitHub CLI репозиторий](https://github.com/cli/cli#installation) для инструкций по обновлению.

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

   ```shell copy
   gh extension install github/gh-ado2gh
   ```

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

   ```shell copy
   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. Посмотрите [Управление доступом](/ru/enterprise-cloud@latest/migrations/ado/manage-access?token-backtrack#create-a-personal-access-token-classic-on-github) , если вы ещё не создали токен.

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

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

     ```shell copy
     export GH_PAT="TOKEN"
     export ADO_PAT="TOKEN"
     ```

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

     ```shell copy
     $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 copy
     export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     ```

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

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

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