파일 내보내기를 사용하여 GitLab 데이터 마이그레이션

파일 내보내기를 사용하여 GitLab 데이터를 마이그레이션합니다.

히스토리 대상 인스턴스에서 충돌을 방지하기 위한 마일스톤 제목 이름 변경이 GitLab 18.6.7 이상, 18.7.5 이상, 18.8.5 이상에서 도입 되었습니다. 파일 내보내기는 오프라인 환경에서 작동하는 GitLab 데이터의 이식 가능한 패키지를 제공합니다. 이 마이그레이션 방법은 저장소, 이슈, 머지 리퀘스트, 댓글을 포함하여 대부분의 프로젝트 데이터를 보존합니다. 다음에 파일 내보내기를 사용하세요: 오프라인 환경 간 마이그레이션. 전체 그룹 구조 없이 특정 프로젝트 이동. 직접 전송 은 대부분의 상황에서 권장되는 마이그레이션 방법입니다. Note 데이터 백업을 위해 프로젝트 내보내기 파일을 사용하지 마세요. 프로젝트 내보내기 파일을 백업에 사용하는 것은 항상 작동하지 않으며, 모든 항목이 내보내지지는 않습니다. 알려진 문제 # 알려진 문제로 인해 PG::QueryCanceled: ERROR: canceling statement due to statement timeout 오류가 발생할 수 있습니다. 자세한 내용은 트러블슈팅 문서 를 참조하세요. GitLab 17.0, 17.1, 17.2에서 가져온 에픽 및 작업 항목이 원래 작성자 대신 가져오는 사용자에게 매핑됩니다. 머지 리퀘스트의 경우 가져오기 또는 내보내기 중에 최신 diff만 보존됩니다. 프로젝트를 가져오거나 내보낸 후에는 최신 diff 버전과 머지 리퀘스트의 최신 파이프라인만 표시됩니다. 가져오기 시 대상 네임스페이스 내에서 기존 마일스톤과 일치하는 제목을 가진 가져온 마일스톤은 제목이 업데이트됩니다. 새 제목에는 고유한 접미사가 추가됩니다. 예: 18.0 은 18.0 (imported-3d-1770206299) 가 됩니다. 이를 방지하려면 직접 전송을 시작하기 전에 소스 그룹 또는 프로젝트에서 마일스톤 이름을 변경하세요. 내보내기 파일을 업로드하여 프로젝트 마이그레이션 # 기존 프로젝트를 파일로 내보낸 다음 다른 GitLab 인스턴스로 가져올 수 있습니다. 사용자 기여 보존 # 사용자 기여를 보존하기 위한 요구사항은 GitLab.com 또는 GitLab Self-Managed 인스턴스로 마이그레이션하는지에 따라 다릅니다. GitLab Self-Managed에서 GitLab.com으로 마이그레이션할 때 # 파일 내보내기를 사용하여 프로젝트를 마이그레이션할 때 사용자 기여가 올바르게 매핑되려면 관리자 접근 토큰이 필요합니다. 따라서 GitLab Self-Managed 인스턴스에서 GitLab.com으로 파일 내보내기를 가져올 때 사용자 기여는 올바르게 매핑되지 않습니다. 대신 모든 GitLab 사용자 연결(예: 댓글 작성자)이 프로젝트를 가져오는 사용자로 변경됩니다. 기여 히스토리를 보존하려면 다음 중 하나를 수행하세요: 직접 전송을 사용하여 마이그레이션 . Professional Services 참여를 고려하세요. 자세한 내용은 Professional Services 카탈로그 를 참조하세요. GitLab Self-Managed로 마이그레이션할 때 # GitLab이 사용자