# GitLab에서 GitHub 마이그레이션에 대한 액세스 관리

GitLab GitHub에서 .로 마이그레이션하는 데 필요한 액세스를 설정합니다.

GitLab에서 리포지토리로 리포지토리를 GitHub마이그레이션하려면 **원본** (GitLab의 프로젝트) 및 **대상** (조직)에 대한 GitHub충분한 액세스 권한이 필요합니다. 이 문서의 단계를 완료하면 마이그레이션에 대한 액세스 및 권한이 준비됩니다.

## 마이그레이션을 수행할 사람 결정

마이그레이션을 수행할 사람이 조직 소유자가 \*\*\*\*GitHubGitHub 경우 조직 소유자는 먼저 마이그레이션자 역할을 부여해야 합니다.

* 조직 소유자이고 GitHub 직접 마이그레이션을 수행하려는 경우 이 가이드를 계속 읽을 수 있습니다.
* 다른 사람에게 이전 작업자 역할을 할당하려면 지금 바로 하세요. 그런 다음, 마이그레이션자는 이 가이드의 나머지 단계를 수행해야 합니다.
  [마이그레이션자 역할 부여하기](/ko/migrations/using-github-enterprise-importer/migrate-from-gitlab/grant-the-migrator-role)을(를) 참조하세요.

## personal access token (classic)을/를 GitHub에서 생성하다

다음으로, personal access token (classic)이(가) GL2GH extension of the GitHub CLI와 통신하기 위해 사용할 GitHub을(를) 만들어야 합니다. 필요한 GitHubpersonal access token (classic) 범위는 역할 및 완료하려는 작업에 따라 달라집니다.

> \[!NOTE]
> personal access token (classic)만 사용할 수 있으며 fine-grained personal access token은(는) 사용할 수 없습니다.즉, 조직에서 "조직에 액세스하지 못하도록 제한GitHub Enterprise Importer" 정책을 사용하는 경우 사용할 personal access tokens (classic) 수 없습니다. 자세한 내용은 [Enterprise에서 개인용 액세스 토큰에 대한 정책 적용](/ko/enterprise-cloud@latest/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-personal-access-tokens-in-your-enterprise#restricting-access-by-personal-access-tokens)을(를) 참조하세요.

| 작업                              | 조직 소유자                                                                                                                                                                                                                               | 마이그레이터                                                                                                                                                                                                                               |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 리포지토리 마이그레이션을 위한 마이그레이션자 역할 할당  | `admin:org`                                                                                                                                                                                                                          | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-dash" aria-label="Not applicable" role="img"><path d="M2 7.75A.75.75 0 0 1 2.75 7h10a.75.75 0 0 1 0 1.5h-10A.75.75 0 0 1 2 7.75Z"></path></svg> |
| 리포지토리 마이그레이션 실행(대상 조직)          |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| `repo`, , `workflow``admin:org` |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| `repo`, , `workflow``read:org`  |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| 마이그레이션 로그 다운로드                  |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| `repo`, , `workflow``admin:org` |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| `repo`, , `workflow``read:org`  |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| 마네킹 회수                          |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| `repo`, , `workflow``admin:org` | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-dash" aria-label="Not applicable" role="img"><path d="M2 7.75A.75.75 0 0 1 2.75 7h10a.75.75 0 0 1 0 1.5h-10A.75.75 0 0 1 2 7.75Z"></path></svg> |                                                                                                                                                                                                                                      |

토큰을 만드는 방법을 알아보려면 [개인용 액세스 토큰 관리](/ko/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic)을 참조하세요.

## personal access token GitLab에서 만들기

GitLab personal access token 에는 범위와 `read_repository` 범위가 `api` 있어야 합니다.

자체 관리형 GitLab 인스턴스의 경우 내보내기가 완료되고 사용자 특성이 유지되도록 토큰이 **관리자**에 속해야 합니다.

토큰을 만드는 방법을 알아보려면 GitLab 설명서를 참조 [Personal access tokens](https://docs.gitlab.com/user/profile/personal_access_tokens/) 하세요.

## GitHub에서 IP 허용 리스트를 구성하십시오.

GitHub의 IP 허용 목록 기능을 사용하는 경우, 아래의 GitHub IP 범위를 대상 조직의 허용 목록에 추가해야 합니다.
[조직에 허용되는 IP 주소 관리](/ko/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization) 또는 [IP 허용 목록을 사용하여 엔터프라이즈에 대한 네트워크 트래픽 제한](/ko/enterprise-cloud@latest/admin/configuring-settings/hardening-security-for-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)을(를) 참조하세요.

대상 조직이 있는 **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 범위 목록이 포함되어 있습니다.

## 마이그레이션에서 리포지토리 규칙 집합을 무시하도록 허용

대상 조직 또는 엔터프라이즈에 규칙 집합이 사용하도록 설정된 경우 마이그레이션된 리포지토리의 기록이 해당 규칙을 위반할 수 있습니다. 규칙 집합을 사용하지 않도록 설정하지 않고 마이그레이션을 허용하려면 해당하는 각 규칙 집합에 대한 바이패스 목록에 "리포지토리 마이그레이션"을 추가합니다.  이 바이패스는 마이그레이션 중에만 적용됩니다. 완료되면 규칙 집합이 모든 새 기여에 적용됩니다.

바이패스 구성:

1. 각 엔터프라이즈 또는 조직 규칙 집합으로 이동합니다.
2. "바이패스 목록" 섹션에서 **바이패스 추가**를 클릭합니다.
3. **리포지토리 마이그레이션을** 선택합니다.

자세한 내용은 [조직 내 리포지토리에 대한 규칙 세트 만들기](/ko/organizations/managing-organization-settings/creating-rulesets-for-repositories-in-your-organization) 및 [리포지토리 마이그레이션에 대한 규칙 집합 바이패스 설정](/ko/enterprise-cloud@latest/migrations/troubleshooting/setting-ruleset-bypasses-for-repository-migrations)을(를) 참조하세요.

## GitLab에서 내보내기 사용

마이그레이션하려는 GitLab 프로젝트는 내보내기에서 사용하도록 설정해야 합니다. GitLab 설명서에서 가져오기에 대한 [프로젝트 내보내](https://docs.gitlab.com/administration/settings/import_and_export_settings/#enable-project-export)[기 및 Sidekiq 구성](https://docs.gitlab.com/administration/sidekiq/configuration_for_imports/) 사용을 참조하세요.