Чтобы перенести репозитории из GitLab GitHubв, вам нужен достаточный доступ к источнику (проекту в GitLab) и назначению (в организации).GitHub После выполнения действий, описанных в этой статье, доступ и разрешения будут готовы к миграции.
Решите, кто будет осуществлять миграцию
Если лицо, осуществляющее миграцию, неGitHub является владельцем организации, GitHub владелец организации должен сначала предоставить ему роль мигратора.
- Если вы владелец GitHub бизнеса и планируете провести миграцию самостоятельно, вы можете продолжить чтение этого руководства.
- Если вы хотите назначить роль мигратора кому-то другому, сделайте это сейчас. Затем мигратор должен выполнить остальные шаги из этих руководств. См . раздел AUTOTITLE.
Создать on personal access token (classic)GitHub
Далее нужно создать приложение personal access token (classic) , с которым GL2GH extension of the GitHub CLI вы будете общаться GitHub. Объёмы, необходимые для вас GitHubpersonal access token (classic) , зависят от вашей роли и задачи, которую вы хотите выполнить.
Примечание.
Можно использовать только personal access token (classic), а не fine-grained personal access token. Это означает, что вы не можете использовать GitHub Enterprise Importer , если ваша организация использует политику «Запретить personal access tokens (classic) доступ к вашей организации». Дополнительные сведения см. в разделе Применение политик для персональных маркеров доступа в вашей организации.
| Задача | Владелец организации | Средство переноса |
|---|---|---|
| Назначение роли миграции для миграций репозитория | admin:org | |
| Выполнение миграции репозитория (целевая организация) | ||
repo, , workflow``admin:org | ||
repo, , workflow``read:org | ||
| Скачивание журнала миграции | ||
repo, , workflow``admin:org | ||
repo, , workflow``read:org | ||
| Восстановление манекенов | ||
repo, , workflow``admin:org |
Чтобы узнать, как создать токен, см. Управление личными маркерами доступа.
personal access token Создание в GitLab
GitLab personal access token должен иметь api области и read_repository области.
Для экземпляров GitLab, управляемый самостоятельно, маркер должен принадлежать администратору, чтобы экспорт был завершен и пользователь сохраняется.
Сведения о создании маркера см Personal access tokens . в документации по GitLab.
Настройте списки разрешений IP на GitHub
Если вы используете GitHubфункцию IP-разрешения в списке, необходимо добавить следующие GitHub диапазоны IP в список разрешений для организации-получателя. См[. раздел AUTOTITLE или Управление разрешенными IP-адресами для организации](/enterprise-cloud@latest/admin/configuring-settings/hardening-security-for-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list).
Если ваша целевая организация включена GitHub.com, необходимо разрешить следующие IP-адреса:
- 192.30.252.0/22
- 185.199.108.0/22
- 140.82.112.0/20
- 143.55.64.0/20
- 135.234.59.224/28 (добавлено 28 июля 2025 года)
- 2a0a:a440::/29
- 2606:50c0::/32
- 20.99.172.64/28 (добавлено 28 июля 2025 года)
Если ваша целевая организация включена GHE.com, диапазоны, которые необходимо разрешить, зависят от региона расположения данных. Список диапазонов IP-адресов, используемых GitHub Enterprise Importer/meta с конечной точкой REST API, можно получить up-to-date. Ключ github_enterprise_importer в ответе содержит список диапазонов IP-адресов, используемых для миграции.
Разрешить миграциям обходить наборы правил репозитория
Если в целевой организации или предприятии включены наборы правил, история мигрированного репозитория может нарушать эти правила. Чтобы позволить миграцию без отключения ваших правил, добавьте «Миграции репозитория» в список обхода для каждого применимого набора правил. Этот обход действует только во время миграции. После завершения правила будут применяться ко всем новым взносам.
Для настройки обхода:
- Перейдите к каждому набору правил для каждого предприятия или организации.
- В разделе «Список обхода» нажмите « Добавить обход».
- Выберите миграции репозиторий.
Дополнительные сведения см. в разделе [AUTOTITLE и Создание наборов правил для репозиториев в организации](/enterprise-cloud@latest/migrations/troubleshooting/setting-ruleset-bypasses-for-repository-migrations).
Включение экспорта в GitLab
Для экспорта необходимо включить проекты GitLab, которые необходимо перенести. См. раздел "Включить экспорт проекта " и конфигурацию Sidekiq для импорта в документации по GitLab.