About migrations from Azure DevOps Cloud
You can use GitHub Enterprise Importer to migrate repositories from Azure DevOps to GitHub Enterprise Cloud (GitHub.com or GHE.com).
You can only use GitHub Enterprise Importer to migrate from Azure DevOps Cloud, not from Azure DevOps Server. If you currently use Azure DevOps Server and want to migrate to GitHub, you can migrate to Azure DevOps Cloud first. For more information, see Migrate to Azure DevOps on the Azure site.
Before you create your enterprise account on GitHub, decide whether your enterprise will use Enterprise Managed Users. This affects how your members authenticate and how you manage identities and access. See Выбор типа предприятия для GitHub Enterprise Cloud.
To learn more about the differences between GitHub and Azure DevOps, see Key differences between Azure DevOps and GitHub.
Alternative tooling for migrations to GHE.com
This journey describes migrations with GitHub Enterprise Importer. If downtime is a concern, Enterprise Live Migrations is an alternative tool that keeps repositories available to developers for most of the migration. See О живых миграциях с GitHub Enterprise Server на GHE.com.
ELM for Azure DevOps is in Публичный предварительный просмотр and only supports migrations to GHE.com, not GitHub.com. For more information, see Enterprise live migrations overview in the Microsoft Learn documentation.
Support for Azure Pipelines and Azure Boards
Both Azure Pipelines and Azure Boards can be fully integrated with your GitHub experience. You can configure your enterprise account and Azure DevOps so you can keep using these services while also benefitting from having your repositories hosted on GitHub.
If you want to migrate Azure Pipelines to GitHub Actions, contact your GitHub account manager.
Data that is migrated
GitHub Enterprise Importer currently supports migrating the following repository data from Azure DevOps to GitHub Enterprise Cloud.
- Git source (including commit history)
- Pull requests
- User history for pull requests
- Work item links on pull requests
- Attachments on pull requests
- Branch policies for the repository (user-scoped branch policies and cross-repo branch policies are not included)
Ограничения для перенесенных данных
Существуют пределы того, что GitHub Enterprise Importer может мигрировать. Некоторые из них обусловлены ограничениями GitHub, другие — ограничениями GitHub Enterprise Importer сами по себе.
Ограничения GitHub
- Ограничение размера 2 ГиБ для одного коммита Git: Размер отдельного коммита в репозитории Git не должен превышать 2 ГиБ. Если размер любого из ваших коммитов превышает 2 ГиБ, вам нужно будет разделить коммит на более мелкие коммиты, каждый из которых имеет размер 2 ГиБ или меньше.
- Ограничение размера 2 ГиБ для одной отправки: Ни одна отправка не может быть больше 2 ГиБ. Более крупные push-уведомления завершаются ошибкой
pack exceeds maximum allowed size. - Ограничение в 255 байт для ссылок на Git: Ни одна ссылка на Git, обычно называемая «ref», не может иметь имя больше 255 байт. Обычно это означает, что ваши ссылки не могут превышать 255 символов, но любые не-ASCII символы, такие как эмодзи, могут потреблять более одного байта. Если какая-либо из ссылок на Git слишком велика, мы вернем четкое сообщение об ошибке.
- Ограничение на размер файла 100 МиБ: После завершения миграции размер отдельного файла в репозитории Git не должен превышать 100 МиБ. Во время миграции репозитория этот лимит увеличивается до 400 МиБ. Рассмотрите возможность Git LFS (Git Large File Storage — поддержка хранения больших файлов в Git) хранения больших файлов.
Ограничения GitHub Enterprise Importer
- Ограничение размера 40 ГБ для репозитория Git (Публичный предварительный просмотр): это ограничение применяется только к исходному коду. Чтобы проверить, превышает ли архив репозитория ограничение, используйте средство git-sizer и просмотрите общий размер большого двоичного объекта в выходных данных. Средство git-sizer также помогает определить потенциальные проблемы, связанные с большими файлами, размером больших двоичных объектов, размером фиксации и числом деревьев, которые могут повлиять на миграцию.
- Ограничение размера файла до 400 МиБ: При миграции репозитория с GitHub Enterprise Importer, ни один файл в вашем Git-репозитории не может быть больше 400 МиБ. Рассмотрите возможность Git LFS (Git Large File Storage — поддержка хранения больших файлов в Git) хранения больших файлов.
- Git LFS (Git Large File Storage — поддержка хранения больших файлов в Git) объекты, не мигрированные: Они Importer могут мигрировать в репозитории, использующие Git LFS (Git Large File Storage — поддержка хранения больших файлов в Git), но сами объекты LFS не будут мигрированы. Их можно отправить в место назначения миграции в качестве последующей задачи после завершения миграции.
- Функции поиска отложенного кода: повторное индексирование индекса поиска может занять несколько часов после переноса репозитория, а поиски кода могут возвращать непредвиденные результаты до завершения повторной индексации.
- Наборы правил, настроенные для вашей организации, могут привести к сбою миграции: например, если вы настроили правило, требующее адреса электронной почты для автор фиксации
@monalisa.catзаканчиваться, а репозиторий, с которым вы переносите, содержит фиксации, которые не соответствуют этому правилу, миграция завершится ошибкой. - Содержимое манекена может быть недоступен для поиска: Манекены являются заполнителями пользователей, к которым связан импортированный контент (например, проблемы, запросы на вытягивание, комментарии и т. д.). При поиске содержимого, связанного с манекеном, например назначенными проблемами, проблемы могут быть не найдены. После восстановления манекена содержимое должно быть найдено с помощью нового владельца.