Skip to main content

Azure DevOps에서 GitHub Enterprise Cloud로 마이그레이션 정보

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

Azure DevOps에서 얻는 마이그레이션 정보

GitHub Enterprise Importer를 사용하여 리포지토리를 Azure DevOps에서 GitHub Enterprise Cloud(GitHub.com 또는 GHE.com)로 마이그레이션할 수 있습니다.

GitHub Enterprise Importer만 사용하여 Azure DevOps Server가 아닌 Azure DevOps Cloud에서 마이그레이션할 수 있습니다. 현재 Azure DevOps Server를 사용하고 GitHub(으)로 마이그레이션하려는 경우 먼저 Azure DevOps Cloud로 마이그레이션할 수 있습니다. 자세한 내용은 Azure 사이트의 Azure DevOps로 마이그레이션을 참조하세요.

마이그레이션되는 데이터

현재 Azure DevOps에서 GitHub Enterprise Cloud(으)로 다음 리포지토리 데이터 마이그레이션만 지원합니다.

  • Git 원본(커밋 기록 포함)
  • 끌어오기 요청
  • 끌어오기 요청에 대한 사용자 기록
  • 끌어오기 요청의 작업 항목 링크
  • 끌어오기 요청의 첨부 파일
  • 리포지토리에 대한 분기 정책(사용자 범위 분기 정책 및 교차 리포지토리 분기 정책은 포함되지 않음)

Azure Pipelines를 GitHub Actions(으)로 마이그레이션하려면 GitHub 계정 관리자에게 문의하세요.

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

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의 제한 사항

  • Git 리포지토리의 40GB 크기 제한(공개 미리 보기): 이 제한은 소스 코드에만 적용됩니다. 리포지토리 보관이 한도를 초과하는지 확인하려면 git-sizer 도구를 사용하고 출력의 총 미확인 개체 크기를 검토합니다. git-sizer 도구는 또한 마이그레이션에 영향을 미칠 수 있는 큰 파일 보고서, 미확인 개체 크기, 커밋 크기 및 트리 수와 관련된 잠재적인 문제를 식별하는 데 도움이 됩니다.
  • 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에 대한 마네킹 회수.

시작

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

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