GitLab에서 리포지토리로 리포지토리를 GitHub마이그레이션하려면 원본 (GitLab의 프로젝트) 및 대상 (조직)에 대한 GitHub충분한 액세스 권한이 필요합니다. 이 문서의 단계를 완료하면 마이그레이션에 대한 액세스 및 권한이 준비됩니다.
마이그레이션을 수행할 사람 결정
마이그레이션을 수행할 사람이 조직 소유자가 ****GitHubGitHub 경우 조직 소유자는 먼저 마이그레이션자 역할을 부여해야 합니다.
- 조직 소유자이고 GitHub 직접 마이그레이션을 수행하려는 경우 이 가이드를 계속 읽을 수 있습니다.
- 다른 사람에게 이전 작업자 역할을 할당하려면 지금 바로 하세요. 그런 다음, 마이그레이션자는 이 가이드의 나머지 단계를 수행해야 합니다. 마이그레이션자 역할 부여하기을(를) 참조하세요.
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) 수 없습니다. 자세한 내용은 Enterprise에서 개인용 액세스 토큰에 대한 정책 적용을(를) 참조하세요.
| 작업 | 조직 소유자 | 마이그레이터 |
|---|---|---|
| 리포지토리 마이그레이션을 위한 마이그레이션자 역할 할당 | 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 에는 범위와 read_repository 범위가 api 있어야 합니다.
자체 관리형 GitLab 인스턴스의 경우 내보내기가 완료되고 사용자 특성이 유지되도록 토큰이 관리자에 속해야 합니다.
토큰을 만드는 방법을 알아보려면 GitLab 설명서를 참조 Personal access tokens 하세요.
GitHub에서 IP 허용 리스트를 구성하십시오.
GitHub의 IP 허용 목록 기능을 사용하는 경우, 아래의 GitHub IP 범위를 대상 조직의 허용 목록에 추가해야 합니다. 조직에 허용되는 IP 주소 관리 또는 IP 허용 목록을 사용하여 엔터프라이즈에 대한 네트워크 트래픽 제한을(를) 참조하세요.
대상 조직이 있는 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(2025년 7월 28일 추가)
- 2a0a:a440::/29
- 2606:50c0::/32
- 20.99.172.64/28(2025년 7월 28일 추가)
대상 조직이 있는 GHE.com 경우 허용해야 하는 범위는 데이터 상주 지역에 따라 달라집니다. REST API의 엔드포인트에서 /meta 사용하는 GitHub Enterprise Importer IP 범위의 up-to날짜 목록을 가져올 수 있습니다. 응답의 github_enterprise_importer 키에는 마이그레이션에 사용되는 IP 범위 목록이 포함되어 있습니다.
마이그레이션에서 리포지토리 규칙 집합을 무시하도록 허용
대상 조직 또는 엔터프라이즈에 규칙 집합이 사용하도록 설정된 경우 마이그레이션된 리포지토리의 기록이 해당 규칙을 위반할 수 있습니다. 규칙 집합을 사용하지 않도록 설정하지 않고 마이그레이션을 허용하려면 해당하는 각 규칙 집합에 대한 바이패스 목록에 "리포지토리 마이그레이션"을 추가합니다. 이 바이패스는 마이그레이션 중에만 적용됩니다. 완료되면 규칙 집합이 모든 새 기여에 적용됩니다.
바이패스 구성:
- 각 엔터프라이즈 또는 조직 규칙 집합으로 이동합니다.
- "바이패스 목록" 섹션에서 바이패스 추가를 클릭합니다.
- 리포지토리 마이그레이션을 선택합니다.
자세한 내용은 조직 내 리포지토리에 대한 규칙 세트 만들기 및 리포지토리 마이그레이션에 대한 규칙 집합 바이패스 설정을(를) 참조하세요.
GitLab에서 내보내기 사용
마이그레이션하려는 GitLab 프로젝트는 내보내기에서 사용하도록 설정해야 합니다. GitLab 설명서에서 가져오기에 대한 프로젝트 내보내기 및 Sidekiq 구성 사용을 참조하세요.