{"meta":{"title":"Установка и настройка GitHub Enterprise Importer","intro":"Установите ADO2GH extension of the GitHub CLI и настройте среду для миграции.","product":"Миграции","breadcrumbs":[{"href":"/ru/enterprise-cloud@latest/migrations","title":"Миграции"},{"href":"/ru/enterprise-cloud@latest/migrations/ado","title":"Migrate from Azure DevOps"},{"href":"/ru/enterprise-cloud@latest/migrations/ado/install-and-configure-github-enterprise-importer","title":"3. Настройка GitHub Enterprise Importer"}],"documentType":"article"},"body":"# Установка и настройка GitHub Enterprise Importer\n\nУстановите ADO2GH extension of the GitHub CLI и настройте среду для миграции.\n\n## Шаг 1: Установите ADO2GH extension of the GitHub CLI\n\nGitHub Enterprise Importer — это коллекция расширений для GitHub CLI. Если это ваша первая миграция, вам нужно будет установить GitHub CLI и .ADO2GH extension\n\n1. Установите GitHub CLI.\n   * Инструкции по установке для GitHub CLI см. в [репозитории GitHub CLI](https://github.com/cli/cli#installation).\n   * Если уже установлена GitHub CLI , запустите `gh --version` , чтобы убедиться, что у вас версия 2.4.0 или новее. Если у вас более старая версия, посетите [GitHub CLI репозиторий](https://github.com/cli/cli#installation) для инструкций по обновлению.\n\n2. Установите ADO2GH extension.\n\n   ```shell copy\n   gh extension install github/gh-ado2gh\n   ```\n\n3. Обновление ADO2GH extension of the GitHub CLI обновляется еженедельно. Чтобы убедиться, что вы используете последнюю версию, обновите расширение.\n\n   ```shell copy\n   gh extension upgrade github/gh-ado2gh\n   ```\n\nВ любой момент, когда вам нужна помощь с данными ADO2GH extension, можно использовать `--help` флаг с помощью команды. Например, `gh ado2gh --help` перечислит все доступные команды и `gh ado2gh migrate-repo --help` отобразит список всех параметров, доступных для `migrate-repo` команды.\n\n## Шаг 2: Задайте переменные среды\n\nПрежде чем вы сможете использовать ADO2GH extension для миграции в GitHub Enterprise Cloud, нужно создать personal access tokens, которые могут получить доступ к исходным и целевым организациям, а затем установить personal access tokens как переменные среды.\n\n1. Убедитесь, что у вас готовы personal access token для GitHub и Azure DevOps. Посмотрите [Управление доступом](/ru/enterprise-cloud@latest/migrations/ado/manage-access?token-backtrack#create-a-personal-access-token-classic-on-github) , если вы ещё не создали токен.\n\n2. Задайте переменные среды для personal access tokens, заменив TOKEN в командах ниже на personal access tokens, которые вы создали ранее. Используется `GH_PAT` для целевой организации и `ADO_PAT` для исходной организации.\n\n   * Если вы используете терминал, используйте `export` команду.\n\n     ```shell copy\n     export GH_PAT=\"TOKEN\"\n     export ADO_PAT=\"TOKEN\"\n     ```\n\n   * Если вы используете PowerShell, используйте `$env` команду.\n\n     ```shell copy\n     $env:GH_PAT=\"TOKEN\"\n     $env:ADO_PAT=\"TOKEN\"\n     ```\n\n3. Если вы переходите на GitHub Enterprise Cloud с размещением данных, для удобства, установите переменную среды для **базового URL API** для вашего предприятия.\n\n   Убедитесь, что вы заменили `SUBDOMAIN` его на поддомен вашего предприятия. Например, если поддоменом вашего предприятия является `acme`, значением `TARGET_API_URL` будет .`https://api.acme.ghe.com`\n\n   * Если вы используете терминал, используйте `export` команду.\n\n     ```shell copy\n     export TARGET_API_URL=\"https://api.SUBDOMAIN.ghe.com\"\n     ```\n\n   * Если вы используете PowerShell, используйте `$env` команду.\n\n     ```shell copy\n     $env:TARGET_API_URL=\"https://api.SUBDOMAIN.ghe.com\"\n     ```\n\n   Вы используете эту переменную с `--target-api-url` опцией в командах, которые выполняете с GitHub CLI."}