# Сведения о миграции ghe-миграции

Вы можете использовать ghe-migrator данные из исходного места (организации GitHub.com или GitHub Enterprise Server экземпляра) в целевойGitHub Enterprise Server экземпляр.

## Типы миграций

С точки зрения времени доступно три типа миграции.

* Миграция с одного GitHub Enterprise Server экземпляра на другой существующий GitHub Enterprise Server . Вы можете перенести любое количество репозиториев, принадлежащих любому пользователю или организации в экземпляре. До выполнения миграции необходимо иметь доступ администратора сайта к обоим экземплярам.
* Миграция из GitHub.com организации в GitHub Enterprise Server экземпляр. Вы можете перенести любое количество репозиториев, принадлежащих организации. Перед выполнением миграции необходимо иметь [административный доступ](/ru/enterprise-server@3.22/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) к GitHub.com организации, а также доступ администратора сайта к целевому экземпляру.
* *Пробные запуски* — это миграции, в ходе которых импортируются данные в [промежуточный экземпляр](/ru/enterprise-server@3.22/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance). Они могут быть полезны, чтобы *понять, что* произойдёт, если миграция будет применена к ваш экземпляр GitHub Enterprise Server.
  **Настоятельно рекомендуется выполнить пробный запуск на промежуточном экземпляре перед импортом данных в рабочий экземпляр.**

> \[!NOTE]
> Использование ghe-migrator не **рекомендуется** для передачи GitHub Enterprise Server экземпляра между гипервизорами. Вместо этого мы предлагаем либо сделать резервную копию и восстановить его в новом месте с GitHub Enterprise Server Backup Utilitiesпомощью , либо создать копию в новом месте и затем переключиться на реплику. Дополнительные сведения см. в разделе AUTOTITLE, AUTOTITLE\[ и \[AUTOTITLE[](/ru/enterprise-server@3.22/admin/backing-up-and-restoring-your-instance/configuring-backups-on-your-instance). ]\(/admin/monitoring-and-managing-your-instance/configuring-high-availability/creating-a-high-availability-replica)]\(/admin/monitoring-and-managing-your-instance/configuring-high-availability/initiating-a-failover-to-your-replica-appliance)

## Перенесенные данные

При использовании ghe-migrator все вращалось вокруг репозитория. Большинство данных, связанных с репозиторием, можно перенести. Например, репозиторий в организации перенесет репозиторий *и* организацию, а также всех пользователей, команды, проблемы и запросы на вытягивание, связанные с репозиторием.

Элементы в таблице ниже можно перенести вместе с репозиторием. Любые элементы, не указанные в списке перенесённых данных, не могут быть перенесены в игру, включая Git LFS (Git Large File Storage — поддержка хранения больших файлов в Git) активы.

> \[!NOTE]
> Связи вилок не сохраняются после миграции.

| Данные, связанные с перенесенным репозиторием                          | Примечания.                                                                                                                                                                                                              |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Пользователи                                                           |                                                                                                                                                                                                                          |
| \*\*                                                                   |                                                                                                                                                                                                                          |
| @mentions                                                              |                                                                                                                                                                                                                          |
| \*\* пользователей перезаписываются в соответствии с целевым объектом. |                                                                                                                                                                                                                          |
| Организации                                                            | Переносятся название и данные об организации.                                                                                                                                                                            |
| Репозитории                                                            | Ссылки на деревья Git, большие двоичные объекты, фиксации и строки перезаписываются в соответствии с целевым объектом. Внутренние репозитории переносятся как частные репозитории. Состояние архива не задано.           |
| Вики-страницы                                                          | Все данные вики-статей переносятся.                                                                                                                                                                                      |
| Teams                                                                  |                                                                                                                                                                                                                          |
| \*\*                                                                   |                                                                                                                                                                                                                          |
| @mentions                                                              |                                                                                                                                                                                                                          |
| \*\* команд перезаписываются в соответствии с целевым объектом.        |                                                                                                                                                                                                                          |
| Milestones                                                             | Метки времени сохраняются.                                                                                                                                                                                               |
| Проблемы                                                               | Ссылки на проблемы и метки времени сохраняются.                                                                                                                                                                          |
| Комментарии к проблеме                                                 | Перекрестные ссылки на комментарии перезаписываются для целевого экземпляра.                                                                                                                                             |
| Запросы на включение внесенных изменений                               | Перекрестные ссылки на запросы на вытягивание перезаписываются в соответствии с целевым объектом. Метки времени сохраняются.                                                                                             |
| Проверки запросов на включение изменений                               | Переносятся проверки запросов на вытягивание и связанные данные.                                                                                                                                                         |
| Комментарии к проверке запроса на вытягивание                          | Перекрестные ссылки на комментарии перезаписываются для целевого экземпляра. Метки времени сохраняются. Комментарии на уровне файлов не переносятся.                                                                     |
| Комментарии к фиксации                                                 | Перекрестные ссылки на комментарии перезаписываются для целевого экземпляра. Метки времени сохраняются.                                                                                                                  |
| Выпуски                                                                | Все данные выпусков переносятся.                                                                                                                                                                                         |
| Действия, выполняемые для запросов на вытягивание или проблем          | Все изменения запросов на вытягивание или проблем, такие как назначение пользователей, переименование заголовков и изменение меток, сохраняются вместе с метками времени для каждого действия.                           |
| Вложенные файлы                                                        | Переносятся [вложения файлов для проблем и запросов на вытягивание](/ru/enterprise-server@3.22/get-started/writing-on-github/working-with-advanced-formatting/attaching-files). Его можно отключить в процессе миграции. |
| Веб-перехватчики                                                       | Переносятся только активные веб-перехватчики.                                                                                                                                                                            |
| Ключи развертывания репозитория                                        | Переносятся ключи развертывания репозитория.                                                                                                                                                                             |
| Защищенные ветви                                                       | Переносятся параметры защищенной ветви и связанные данные.                                                                                                                                                               |

## О миграции внешних данных проверки подлинности

Если исходное место для вашей миграции — GitHub продукт, использующий LDAP или SAML-аутентификацию, `ghe-migrator` он не мигрирует внешние данные аутентификации, связанные с учетными записями пользователей. Для получения дополнительной информации о вариантах аутентификации см. раздел «Об аутентификации для вашего предприятия» в [GitHub Enterprise Server документации](/ru/enterprise-server@3.22/admin/concepts/identity-and-access-management/identity-and-access-management-fundamentals) или [вGitHub Enterprise Cloud документах](/ru/enterprise-cloud@latest/admin/concepts/identity-and-access-management/identity-and-access-management-fundamentals).

Если выполнить миграцию в целевой экземпляр, а затем настроить внешнюю проверку подлинности, пользователи должны войти в целевой экземпляр с учетной записью пользователя, которая имеет то же имя пользователя или идентификатор пользователя, что и учетная запись в исходном экземпляре. Администраторы могут просматривать внешний атрибут, который экземпляр использует для отображения имён пользовательских аккаунтов из Консоль управления. Дополнительные сведения см. в разделе [Доступ к консоли управления](/ru/enterprise-server@3.22/admin/administering-your-instance/administering-your-instance-from-the-web-ui/accessing-the-management-console).