Bitbucket Server에서 GitHub Enterprise Cloud로 마이그레이션 정보

GitHub Enterprise Importer에서 마이그레이션할 수 있는 데이터에 대해 알아봅니다.

이 문서의 내용

Bitbucket Server에서 마이그레이션 정보

GitHub Enterprise Importer를 사용하여 리포지토리를 Bitbucket Server에서 GitHub Enterprise Cloud(GitHub.com 또는 GHE.com)로 마이그레이션할 수 있습니다. Bitbucket Server에서의 마이그레이션은 Bitbucket Server 또는 Bitbucket Data Center 버전 5.14 이상에서만 지원됩니다.

마이그레이션되는 데이터

현재는 다음 리포지토리 데이터를 Bitbucket Server에서 GitHub Enterprise Cloud(으)로 마이그레이션하는 것만 지원합니다.

  • Git 원본(커밋 기록 포함)

  • 끌어오기 요청(설명, 끌어오기 요청 검토, 파일 및 라인 수준에서 댓글 끌어오기 요청 검토, 필수 검토자 및 첨부 파일 포함)

    참고 항목

    끌어오기 요청이 병합되었고 마이그레이션 전에 헤드 분기가 Bitbucket Server에서 삭제된 경우 끌어오기 요청을 보려고 할 때 500 오류가 발생할 수 있습니다. Bitbucket Server는 이러한 끌어오기 요청에 대한 개체에 대한 특정 Git 참조를 제거하므로, 끌어오기 요청과 연결된 Git 개체는 마이그레이션할 수 없습니다.

마이그레이션되지 않는 데이터

현재 다음 데이터는 마이그레이션되지 않습니다.

  • 사용자가 소유한 개인 리포지토리
  • 분기 권한
  • 커밋 주석
  • 리포지토리 설정
  • CI 파이프라인

마이그레이션된 데이터에 대한 제한 사항

GitHub Enterprise Importer에서 마이그레이션할 수 있는 항목에는 제한이 있습니다. 일부는 GitHub의 제한 사항으로 인해 발생하지만 다른 일부는 GitHub Enterprise Importer 자체의 제한 사항입니다.

GitHub의 제한 사항

  • 단일 Git 커밋에 대한 2GB 크기 제한: Git 리포지토리의 단일 커밋은 2GB보다 클 수 없습니다. 커밋이 2GB보다 큰 경우 커밋을 각각 2GB 이하인 더 작은 커밋으로 분할해야 합니다.
  • Git 참조에 대한 255바이트 제한: 일반적으로 "ref"라고 하는 단일 Git 참조는 255바이트보다 큰 이름을 가질 수 없습니다. 일반적으로 참고자료는 255자를 초과할 수 없지만 이모지와 같은 비 ASCII가 아닌 문자는 둘 이상의 바이트를 사용할 수 있습니다. Git 참고자료가 너무 크면 명확한 오류 메시지가 반환됩니다.
  • 100MB 파일 크기 제한: 마이그레이션을 완료한 후에는 Git 리포지토리의 단일 파일이 100MB를 초과할 수 없습니다. 리포지토리를 마이그레이션하는 동안 이 제한은 400MB로 늘어납니다. 대용량 파일을 저장하려면 Git LFS를 사용해 보세요. 자세한 내용은 대형 파일 관리을(를) 참조하세요.

GitHub Enterprise Importer의 제한 사항

  • 리포지토리 아카이브의 크기 제한 40GB(공개 미리 보기): Importer는 리포지토리 아카이브에 있는 git 데이터와 메타데이터를 합쳐 40GB가 넘는 리포지토리를 마이그레이션할 수 없습니다.
  • 400 MB file size limit: When migrating a repository with GitHub Enterprise Importer, no single file in your Git repository can be larger than 400 MB. Consider using Git LFS for storing large files. For more information, see 대형 파일 관리.
  • Git LFS objects not migrated: The Importer can migrate repositories that use Git LFS, but the LFS objects themselves will not be migrated. They can be pushed to your migration destination as a follow-up task after the migration is complete. For more information, see 리포지토리 복제.
  • Follow-up tasks required: When migrating between GitHub products, certain settings are not migrated and must be reconfigured in the new repository. For a list of follow-up tasks you'll need to complete after each migration, see GitHub 제품 간 마이그레이션의 개요.
  • Delayed code search functionality: Re-indexing the search index can take a few hours after a repository is migrated, and code searches may return unexpected results until re-indexing is complete.
  • Rulesets configured for your organization can cause migrations to fail: For example, if you configured a rule that requires email addresses for commit authors to end with @monalisa.cat, and the repository you're migrating contains commits that don't comply with this rule, your migration will fail. For more information about rulesets, see 규칙 세트 정보.
  • Mannequin content might not be searchable: Mannequins are placeholder users to which imported content (such as issues, pull requests, comments, etc.) is associated. When you search for content associated with a mannequin, such as assigned issues, the issues may not be found. Once a mannequin is reclaimed, the content should be found via the new owner. For more information, see GitHub Enterprise Importer에 대한 마네킹 회수.

시작

Bitbucket Server에서 마이그레이션하기 전에 마이그레이션 실행 방법을 계획해야 합니다. 데이터를 마이그레이션하기 전에 마이그레이션을 실행할 사용자를 선택해야 합니다. 마이그레이션의 원본과 대상 모두에 대해 필요한 액세스 권한을 해당 사용자에게 부여해야 합니다. 또한 먼저 평가판 마이그레이션을 실행하는 것이 좋습니다.

전체 마이그레이션 프로세스의 개요는 Bitbucket Server에서 GitHub Enterprise Cloud로 마이그레이션의 개요을(를) 참조하세요.