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

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

다이렉트 트랜스퍼를 사용하여 GitLab 그룹 및 프로젝트를 마이그레이션하려면: 사전 요구사항 을 충족하는지 확인합니다. 사용자 기여 및 사용자 멤버십 매핑을 검토합니다. 소스 GitLab 인스턴스에 연결 합니다. 가져올 그룹 및 프로젝트를 선택 하고 마이그레이션을 시작합니다. 임포트 결과 검토 . 문제가 있는 경우: 마이그레이션을 취소 하거나 재시도 합니다. 문제 해결 문서 를 참조합니다. 사전 요구사항 # 히스토리 GitLab 18.6.7 이상, 18.7.5 이상, 18.8.5 이상에서 대상 인스턴스의 충돌을 방지하기 위한 마일스톤 제목 이름 변경 도입 . 다이렉트 트랜스퍼를 사용하여 마이그레이션하기 전에 다음 사전 요구사항을 확인하세요. 네트워크 및 스토리지 공간 # 인스턴스 또는 GitLab.com 간의 네트워크 연결은 HTTPS를 지원해야 합니다. 방화벽은 소스와 대상 GitLab 인스턴스 간의 연결을 차단하지 않아야 합니다. 소스 및 대상 GitLab 인스턴스는 전송된 프로젝트와 그룹의 아카이브를 만들고 추출하기 위해 /tmp 디렉토리에 충분한 여유 공간이 있어야 합니다. 버전 # 성공적이고 성능이 좋은 마이그레이션의 가능성을 극대화하려면: 소스 및 대상 인스턴스를 모두 GitLab 16.8 이상으로 업그레이드합니다. 자세한 내용은 에픽 9036 을 참조하세요. 버그 수정 및 기타 개선을 위해 가능한 한 최신 버전 간에 마이그레이션합니다. 소스 및 대상 인스턴스가 동일한 버전이 아닌 경우, 소스 인스턴스는 대상 인스턴스보다 두 개의 마이너 버전 이상 이전이어서는 안 됩니다. 이 요구사항은 GitLab.com에서 GitLab Dedicated로의 마이그레이션에는 적용되지 않습니다. 구성 # Sidekiq가 제대로 구성 되었는지 확인합니다. 두 GitLab 인스턴스 모두 인스턴스 관리자에 의해 애플리케이션 설정에서 다이렉트 트랜스퍼에 의한 그룹 마이그레이션이 활성화 되어 있어야 합니다. 소스 GitLab 인스턴스에 대한 api 범위의 개인 접근 토큰 이 있어야 합니다. 소스 및 대상 인스턴스에서 필요한 권한이 있어야 합니다. 다음에 대해: 대부분의 사용자는 다음이 필요합니다: 마이그레이션할 소스 그룹에서 Owner 권한. 해당 네임스페이스에서 하위 그룹을 만들 수 있는 대상 네임스페이스의 권한. 필요한 권한이 없는 두 인스턴스의 관리자는 대신 API 를 사용하여 임포트를 시작할 수 있습니다. 프로젝트 스니펫을 가져오려면 스니펫이 소스 프로젝트에서 활성화 되어 있는지 확인합니다. 오브젝트 스토리지에 저장된 항목을 가져오려면 다음 중 하나를 수행해야 합니다: proxy_download 구성 . 대상 GitLab 인스턴스가 소스 GitLab 인스턴스의 오브젝트 스토리지에 접근할 수 있는지 확인합니다. 소스 인스턴스 또는 그룹의 프로젝트를 만드는 데 필요한 최소 기본 권한 이 아무도 없음 으로 설정된 경우 프로젝트가 있는 그룹을 가져올 수 없습니다. 필요한 경우 이 설정을 변경할 수 있습니다: 전체 인스턴스 에 대해. 특정 그룹 에 대해