다이렉트 트랜스퍼를 사용하여 그룹 및 프로젝트 마이그레이션

다이렉트 트랜스퍼를 사용하여 GitLab 인스턴스 간에 그룹 및 프로젝트를 마이그레이션합니다.

직접 전송으로 GitLab 그룹과 프로젝트를 마이그레이션하려면 다음 단계를 따릅니다. 사전 요구사항 을 충족하는지 확인합니다. 사용자 기여 및 사용자 멤버십 매핑을 검토합니다. 소스 GitLab 인스턴스를 연결 합니다. 가져올 그룹과 프로젝트를 선택 하고 마이그레이션을 시작합니다. 임포트 결과를 검토 합니다. 문제가 발생하면 다음을 수행할 수 있습니다. 마이그레이션을 취소 하거나 재시도 합니다. 문제 해결 문서 를 참고합니다. 사전 요구사항 # 히스토리 대상 인스턴스에서 충돌을 피하기 위해 마일스톤 제목을 변경하는 기능이 GitLab 18.6.7 이상, 18.7.5 이상, 18.8.5 이상에서 도입되었습니다 . 직접 전송으로 마이그레이션하기 전에 다음 사전 요구사항을 확인합니다. 네트워크 및 스토리지 공간 # 인스턴스 사이 또는 GitLab.com과의 네트워크 연결이 HTTPS를 지원해야 합니다. 방화벽이 소스 GitLab 인스턴스와 대상 GitLab 인스턴스 사이의 연결을 차단하지 않아야 합니다. 전송되는 프로젝트와 그룹의 아카이브를 만들고 추출할 수 있도록, 소스 GitLab 인스턴스와 대상 GitLab 인스턴스의 /tmp 디렉터리에 충분한 여유 공간이 있어야 합니다. 버전 # 마이그레이션 성공률과 성능을 높이려면 다음을 권장합니다. 소스 인스턴스와 대상 인스턴스를 모두 GitLab 16.8 이상으로 업그레이드합니다. 자세한 내용은 에픽 9036 을 참고합니다. 버그 수정과 그 밖의 개선 사항을 적용받도록 가능한 한 최신 버전 사이에서 마이그레이션합니다. 소스 인스턴스와 대상 인스턴스의 버전이 같지 않은 경우, 소스 인스턴스는 대상 인스턴스보다 마이너 버전 기준 두 단계를 초과해 낮아서는 안 됩니다. 이 요구 사항은 GitLab.com에서 GitLab Dedicated로 마이그레이션하는 경우에는 적용되지 않습니다. 구성 # Sidekiq가 올바르게 구성 되어 있는지 확인합니다. 두 GitLab 인스턴스 모두 인스턴스 관리자가 애플리케이션 설정에서 직접 전송을 통한 그룹 마이그레이션을 활성화해야 합니다. 소스 GitLab 인스턴스에 대해 api 스코프를 가진 개인 액세스 토큰 이 있어야 합니다. 소스 인스턴스와 대상 인스턴스에서 필요한 권한이 있어야 합니다. 구체적으로는 다음과 같습니다. 대부분의 사용자는 다음이 필요합니다. 마이그레이션할 소스 그룹에 대한 Owner 권한. 대상 네임스페이스에서 하위 그룹을 만들 수 있는 권한. 필요한 권한이 없는 두 인스턴스의 관리자는 대신 API 로 임포트를 시작할 수 있습니다. 프로젝트 스니펫을 가져오려면 소스 프로젝트에서 스니펫이 활성화 되어 있어야 합니다. 오브젝트 스토리지에 저장된 항목을 가져오려면 다음 중 하나를 수행해야 합니다. proxy_download 를 구성 합니다. 대상 GitLab 인스턴스가 소스 GitLab 인스턴스의 오브젝트 스토리지에 접근할 수 있도록 합니다. 소스 인스턴스 또는 그룹의 Default minimum role required to create projects