오프라인 전송으로 그룹 및 프로젝트 마이그레이션
오브젝트 스토리지를 통해 GitLab 그룹과 프로젝트를 마이그레이션하는 방법을 설명합니다.
히스토리 GitLab 19.3에서 offline_transfer_exports , offline_transfer_imports , offline_transfer_ui 라는 기능 플래그와 함께 실험 기능 으로 도입 되었습니다. 기본적으로 비활성화되어 있습니다. Feature flag 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다. 이 기능은 테스트용으로 제공되며 프로덕션 환경에서 사용할 준비가 되지 않았습니다. 오프라인 전송은 원본 인스턴스와 대상 인스턴스 사이에 직접적인 네트워크 연결 없이 오브젝트 스토리지를 통해 인스턴스 간에 GitLab 그룹과 프로젝트를 복사합니다. 원본 인스턴스는 데이터를 스토리지 버킷으로 내보내고, 대상 인스턴스는 읽을 수 있는 버킷에서 데이터를 가져옵니다. 대상 인스턴스가 원본 인스턴스에 연결해야 하는 직접 전송을 통한 마이그레이션 과 달리, 오프라인 전송은 내보내기와 가져오기를 분리합니다. 내보내기 버킷과 가져오기 버킷은 같은 버킷일 필요가 없으며, 같은 오브젝트 스토리지 공급자를 사용할 필요도 없습니다. 대상 인스턴스가 내보내기 버킷에 접근할 수 없으면 내보내기 파일을 대상이 접근할 수 있는 버킷으로 옮깁니다. GitLab은 이 파일을 대신 옮겨 주지 않습니다. 파일을 옮길 때 오브젝트 키 구조를 그대로 유지합니다. 오프라인 전송은 모든 오브젝트 키를 내보내기 접두사로 구성합니다. <export_prefix>/metadata.json.gz <export_prefix>/<entity_prefix>/<relation>.<extension> <export_prefix>/<entity_prefix>/<relation>/batch_<number>.<extension> 예: 2026-04-16_19-39-00_export_dJtnb3CV/project_1/repository.tar.gz 최상위 내보내기 접두사는 가져오기를 시작할 때 직접 지정하므로 이름을 바꿀 수 있습니다. 내보내기 접두사 아래의 모든 항목은 같은 구조와 파일 이름을 유지해야 합니다. 인스턴스 사이에 직접 연결이 없다고 해서 어느 한쪽 인스턴스가 오프라인이라는 뜻은 아닙니다. 원본 인스턴스와 대상 인스턴스 모두 내보내기 또는 가져오기를 수행하려면 오브젝트 스토어에 대한 네트워크 접근이 여전히 필요합니다. 오프라인 전송은 기능 플래그와 애플리케이션 설정으로 이중 제어됩니다. 모두 기본적으로 꺼져 있으며, 특정 작업을 수행하려면 두 계층이 모두 켜져 있어야 합니다. 내보내기: offline_transfer_exports_enabled 애플리케이션 설정. 가져오기: offline_transfer_imports_enabled 애플리케이션 설정. 내보내기와 가져오기를 수행하려면 오프라인 전송 REST API 를 사용합니다. GitLab UI에서의 오프라인 전송 지원은 작업 항목 19870 에서 제안되었습니다. 버전 요구 사항 #