파일 익스포트를 사용하여 프로젝트 및 그룹 이전하기
직접 전송을 사용하여 그룹 및 프로젝트를 이전하는 것이 권장됩니다. 그러나 특정 상황에서는 파일 익스포트를 사용하여 그룹 및 프로젝트를 이전해야 할 수도 있습니다.
알려진 문제
- 알려진 문제로 인해
PG::QueryCanceled: ERROR: canceling statement due to statement timeout오류가 발생할 수 있습니다. 자세한 내용은 문제 해결 문서를 참조하십시오. - GitLab 17.0, 17.1 및 17.2에서 가져온 epic 및 작업 항목이 원래 작성자가 아닌 가져오는 사용자에게 매핑됩니다.
익스포트 파일을 업로드하여 프로젝트 이전
자체 호스팅된 GitLab 인스턴스나 GitLab.com의 기존 프로젝트는 파일로 내보내어 다른 GitLab 인스턴스로 가져올 수 있습니다.
사용자 기여 보존
사용자 기여를 보존하는 요구 사항은 GitLab.com이나 GitLab 자체 호스팅된 인스턴스로 이전하는 경우에 따라 다릅니다.
GitLab 자체 호스팅에서 GitLab.com으로 이전하는 경우
파일 익스포트를 사용하여 프로젝트를 이전할 때 관리자 액세스 토큰이 필요합니다. 따라서 자체 호스팅된 인스턴스에서 GitLab.com으로 파일을 가져올 때 사용자 기여가 정확하게 매핑되지 않습니다. 대신 모든 GitLab 사용자 연합(예: 코멘트 작성자)이 프로젝트를 가져오는 사용자로 변경됩니다. 기여 이력을 보존하려면 다음 중 하나를 수행하세요:
- 직접 전송을 사용.
- 전문 서비스를 이용하십시오. 자세한 내용은 전문 서비스 전체 카탈로그를 참조하십시오.
GitLab 자체 호스팅으로 이동하는 경우
GitLab이 사용자 및 사용자 기여를 올바르게 매핑하도록 하려면 다음이 있어야 합니다:
- 프로젝트의 최상위 그룹 소유자는 프로젝트에 액세스 권한이 있는 모든 멤버(직접 및 상속)의 정보가 내보내진 파일에 포함될 수 있도록 프로젝트를 내보내어야 합니다. 프로젝트 유지 관리자와 소유자는 프로젝트 내보내기를 시작할 수 있습니다. 그러나 그런 다음엔 직접 멤버만 내보내어집니다.
- 관리자는 가져오기를 수행해야 합니다.
- 필요한 사용자는 대상 GitLab 인스턴스에 존재해야 합니다. 관리자는 Rails 콘솔로 대량 사용자를 만들거나 UI에서 하나씩 확인된 사용자를 만들 수 있습니다.
- 사용자는 소스 GitLab 인스턴스에서 프로필에 공개 이메일을 설정하여 대상 GitLab 인스턴스에서의 기본 이메일 주소와 일치해야 합니다. 또한 프로젝트 내보내기 파일을 편집하여 사용자의 공개 이메일을 수동으로 추가할 수 있습니다.
기존 사용자의 이메일이 가져온 사용자의 이메일과 일치하는 경우 해당 사용자가 가져온 프로젝트의 직접 멤버로 추가됩니다.
앞의 조건 중 하나라도 충족되지 않으면 사용자 기여가 올바르게 매핑되지 않습니다. 대신 모든 GitLab 사용자 연합이 가져오는 사용자로 변경됩니다. 그 사용자는 다른 사용자가 생성한 병합 요청의 작성자가 됩니다. 원래 작성자를 언급하는 보조 코멘트는:
- 코멘트, 병합 요청 승인, 연결된 작업 및 항목에 추가됩니다.
- 병합 요청이나 이슈 생성자, 추가된 레이블 또는 제거된 레이블, 그리고 병합한 작업에 대한 정보에는 추가되지 않습니다.
프로젝트 익스포트 파일 편집
내보낸 파일에서 데이터를 추가하거나 제거할 수 있습니다. 예를 들어 다음을 수행할 수 있습니다:
- 사용자 공개 이메일을
project_members.ndjson파일에 수동으로 추가합니다. -
ci_pipelines.ndjson파일에서 줄을 제거하여 CI 파이프라인을 정리합니다.
프로젝트 익스포트 파일을 편집하려면:
- 내보낸
.tar.gz파일을 압축 해제합니다. - 해당 파일을 편집합니다. 예:
tree/project/project_members.ndjson. - 파일을 다시
.tar.gz파일로 압축합니다.
또한 project_members.ndjson 파일을 체크하여 모든 멤버가 내보내졌는지 확인할 수 있습니다.
호환성
- JSON 형식 프로젝트 파일 익스포트 지원은 제거되었음 (GitLab 15.11에서).
프로젝트 파일 익스포트는 NDJSON 형식입니다.
GitLab에서 내보낸 프로젝트 파일은 최신 버전에서 2 부수 버전 이전까지 지원됩니다.
예:
| 대상 버전 | 호환되는 소스 버전 |
|---|---|
| 13.0 | 13.0, 12.10, 12.9 |
| 13.1 | 13.1, 13.0, 12.10 |
가져오기 원본으로 파일 익스포트 설정
파일 익스포트를 사용하여 자체 호스팅된 GitLab 인스턴스에서 프로젝트를 이전하려면 GitLab 관리자는 다음을 수행해야 합니다:
- 소스 인스턴스에서 파일 익스포트를 사용하도록 설정합니다.
- 대상 인스턴스에서 파일 익스포트를 가져올 수 있도록 설정합니다. GitLab.com에서는 이미 파일 익스포트가 가져오기 원본으로 설정되어 있습니다.
대상 인스턴스에서 파일 익스포트를 가져올 수 있도록 설정하려면:
- 좌측 사이드바에서 하단에서 Admin을 선택합니다.
- Settings > General을 선택합니다.
- Import and export settings를 확장합니다.
- Import sources로 스크롤합니다.
- GitLab export 확인란을 선택합니다.
CE 및 EE 간
커뮤니티 에디션에서 엔터프라이즈 에디션으로 프로젝트를 내보낼 수 있으며 그 반대도 가능합니다. 호환성이 충족된다면입니다.
엔터프라이즈 에디션에서 커뮤니티 에디션으로 프로젝트를 내보내는 경우, 엔터프라이즈 에디션에만 유지되는 데이터가 유실될 수 있습니다. 자세한 내용은 EE에서 CE로 다운그레이드를 참조하십시오.
프로젝트 및 데이터 내보내기
프로젝트를 가져오려면 반드시 프로젝트를 내보내야 합니다.
필수 사항:
- 내보내는 항목 목록을 확인하십시오. 모든 항목이 내보내지는 않습니다.
- 프로젝트에 적어도 Maintainer 역할을 가져야 합니다.
프로젝트 및 데이터를 내보내려면 다음 단계를 따르십시오:
- 좌측 사이드 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- Settings > General을 선택합니다.
- Advanced를 확장합니다.
- Export project를 선택합니다.
- 내보내기가 생성된 후에는:
- 이메일에 포함된 링크를 따릅니다.
- 프로젝트 설정 페이지를 새로 고쳐서 Export project 영역에서 Download export를 선택합니다.
내보내기는 구성된 shared_path에 임시 공유 디렉터리로 생성되어 그 다음에는 구성된 uploads_directory로 이동됩니다. 24시간마다 워커가 이러한 내보내기 파일들을 삭제합니다.
내보내는 프로젝트 항목
내보내는 프로젝트 항목은 사용 중인 GitLab 버전에 따라 다릅니다. 특정 프로젝트 항목이 내보내는지 확인하려면 다음을 수행하세요.
-
exporters배열을 확인합니다. - GitLab 버전별로 프로젝트의
project/import_export.yml파일을 확인하세요. 예를 들어, GitLab 16.8의 경우 https://gitlab.com/gitlab-org/gitlab/-/blob/16-8-stable-ee/lib/gitlab/import_export/project/import_export.yml을 확인하세요.
빠른 개요를 위해 내보내는 항목은 다음과 같습니다.
- 프로젝트 및 위키 저장소
- 프로젝트 업로드
- 통합을 제외한 프로젝트 구성
- 이슈
- 병합 요청
- 커밋 코멘트(GitLab 15.10에 도입)
- 레이블
- 마일스톤
- 스니펫
- 릴리스
- 시간 추적 및 기타 프로젝트 엔터티
- 디자인 관리 파일 및 데이터
- LFS 객체
- 이슈 보드
- CI/CD 파이프라인 및 파이프라인 일정
- 보호된 브랜치 및 태그
- 푸시 규칙
- 이모지 반응
- 직접 프로젝트 구성원 (내보낸 프로젝트 그룹에 대해 최소한의 유지자 역할이 있는 경우)
- 직접 프로젝트 구성원으로 상속된 프로젝트 구성원 (내보낸 프로젝트 그룹에 대해 소유자 역할 또는 인스턴스의 관리자 액세스 권한이 있는 경우)
- 일부 병합 요청 승인 규칙:
내보내지 않는 프로젝트 항목
내보내지 않는 항목은 다음과 같습니다:
- 자식 파이프라인 히스토리
- 파이프라인 트리거
- 빌드 추적 및 아티팩트
- 패키지 및 컨테이너 레지스트리 이미지
- CI/CD 변수
- 웹훅
- 암호화된 토큰
- 필요한 승인 수(지정된)
- 저장소 크기 제한
- 보호된 브랜치에 푸시할 수 있는 배포 키
- 보안 파일
- Git 관련 이벤트에 대한 활동 로그(푸시 및 태그 생성과 같은)
- 프로젝트와 관련된 보안 정책
- 이슈 및 연결된 항목 간의 링크
- 관련 병합 요청에 대한 링크
파일 내보내기를 사용하여 프로젝트를 마이그레이션하는 경우 같은 내보내고 가져오기 메커니즘을 사용합니다. 그룹 및 인스턴스에서 템플릿을 사용하여 프로젝트를 생성합니다. 따라서 내보내는 항목 목록은 동일합니다.
프로젝트 및 해당 데이터 가져오기
프로젝트와 해당 데이터를 가져올 수 있습니다. 가져올 수 있는 데이터 양은 최대 가져오기 파일 크기에 따라 다릅니다.
- GitLab Self-Managed 인스턴스에서 Self-Managed 인스턴스 관리자는 최대 가져오기 파일 크기를 설정할 수 있습니다.
- GitLab.com의 경우 값이 5GB로 설정됩니다.
경고: 신뢰할 수 있는 소스에서만 프로젝트를 가져오세요. 신뢰할 수 없는 소스에서 프로젝트를 가져오면 공격자가 민감한 데이터를 도용할 수 있습니다.
사전 요구 사항
- GitLab 16.0에 도입된 유지자 역할 필수 요구 사항 및 GitLab 15.11.1 및 GitLab 15.10.5로 되역코드된 소유자 역할 요구 사항.
- 프로젝트와 해당 데이터를 내보냈어야 합니다.
- GitLab 버전을 비교하고 내보낸 GitLab 버전과 동일하거나 더 높은 GitLab 버전으로 가져오는지 확인합니다.
- 어떠한 문제에 대한 호환성을 검토합니다.
- 마이그레이션할 대상 그룹에서 최소한 유지자 역할이 필요합니다.
프로젝트 가져오기
프로젝트를 가져오려면:
- 왼쪽 사이드바의 상단에서 새로 만들기 () 및 새 프로젝트/저장소를 선택합니다.
- 프로젝트 가져오기를 선택합니다.
- 프로젝트 가져오기 소스에서 GitLab 내보내기를 선택합니다.
- 프로젝트 이름과 URL을 입력하세요. 그런 다음 이전에 내보낸 파일을 선택합니다.
- 프로젝트 가져오기를 선택합니다.
API를 사용하여 가져오기 상태를 조회할 수 있습니다. 조회한 결과로 가져오기 오류 또는 예외가 반환될 수 있습니다.
가져온 항목의 변경 사항
내보낸 항목은 다음과 같은 변경 사항과 함께 가져오게 됩니다:
- 소유자 역할을 가진 프로젝트 구성원은 유지자 역할로 가져오게 됩니다.
- 가져온 프로젝트에 포크에서 유래한 병합 요청이 포함되어 있는 경우, 이러한 병합 요청과 관련된 새 브랜치가 프로젝트에 생성됩니다. 따라서 새 프로젝트의 브랜치 수가 원본 프로젝트보다 많을 수 있습니다.
- 만약
내부가시성 레벨이 제한됐다면, 모든 가져온 프로젝트에는비공개가시성이 지정됩니다.
배포 키는 가져오지 않습니다. 배포 키를 사용하려면 가져온 프로젝트에서 이를 활성화하고 보호된 브랜치를 업데이트해야 합니다.
대형 프로젝트 가져오기
대형 프로젝트가 있는 경우 Rake 작업을 사용해 보세요.
최대 가져오기 파일 크기 설정
관리자는 최대 가져오기 파일 크기를 두 가지 방법 중 하나로 설정할 수 있습니다:
-
애플리케이션 설정 API의
max_import_size옵션으로. - 관리자 영역 UI에서.
기본값은 0 (무제한)입니다.
요율 제한
남용을 방지하기 위해, 기본적으로 사용자의 요율은 다음과 같이 제한됩니다:
| 요청 유형 | 제한 |
|---|---|
| Export | 분당 6개 프로젝트 |
| 내보내기 다운로드 | 그룹당 분당 1회 다운로드 |
| 가져오기 | 분당 6개 프로젝트 |
(Deprecated) 내보낸 파일을 업로드하여 그룹 이주하기
- GitLab 14.6에서 폐기되었습니다.
필수 조건:
- 이주할 그룹에 대한 소유자 역할.
파일 내보내기를 사용하면 다음을 수행할 수 있습니다:
- 어떤 그룹이든 파일로 내보내고 해당 파일을 다른 GitLab 인스턴스나 동일 인스턴스의 다른 위치에 업로드할 수 있습니다.
- GitLab UI 또는 API를 사용할 수 있습니다.
- 그룹마다 그룹 내의 각 프로젝트를 내보내고 가져오세요.
관리자 액세스 토큰을 사용하여 가져오기를 수행하면 GitLab이 사용자 기여를 올바르게 매핑합니다. GitLab은 자체 관리 인스턴스에서 GitLab.com으로 가져올 때 사용자 기여를 올바르게 매핑하지 않습니다. 자체 관리 인스턴스에서 GitLab.com으로 가져올 때 사용자 기여를 올바르게 매핑하려면 전문 서비스 팀의 유료 참여로 보존할 수 있습니다.
추가 정보
- 내보낸 파일은 임시 폴더에 저장되어 특정 작업자에 의해 24시간마다 삭제됩니다.
- 가져온 프로젝트에서 그룹 수준 관계를 보존하려면 그룹을 먼저 내보내고 가져오세요. 그러면 프로젝트를 원하는 그룹 구조로 가져올 수 있습니다.
- 가져온 그룹은
비공개가시성 수준을 갖습니다. 그러나 부모 그룹으로 가져오면 하위 그룹은 별도로 제한되지 않는 한 동일한 가시성 수준을 상속합니다. - 커뮤니티 에디션에서 엔터프라이즈 에디션으로 그룹을 내보낼 수 있으며 그 반대도 가능합니다. 엔터프라이즈 에디션에는 커뮤니티 에디션에 포함되지 않는 일부 그룹 데이터가 유지됩니다. 엔터프라이즈 에디션에서 그룹을 커뮤니티 에디션으로 내보내면 이 데이터를 잃을 수 있습니다. 자세한 내용은 EE를 CE로 다운그레이드를 참조해 주세요.
가져오기 파일 크기는 GitLab 자체 관리 인스턴스 또는 GitLab.com으로 가져올 때에 따라 달라집니다:
- GitLab 자체 관리 인스턴스로 가져올 경우, 가져오기 파일 크기에 제한이 없습니다. 관리자는 다음 중 하나로 이 동작을 변경할 수 있습니다:
-
애플리케이션 설정 API의
max_import_size옵션으로. - 관리자 영역에서.
-
애플리케이션 설정 API의
- GitLab.com에서는 5GB까지의 그룹 가져오기 파일을 가져올 수 있습니다.
호환성
- JSON 형식 프로젝트 파일의 지원이 GitLab 15.8에서 제거되었습니다.
그룹 파일 내보내기는 NDJSON 형식으로 이루어집니다.
GitLab에서 두 마이너 버전 이전에 내보내진 그룹 파일을 가져올 수 있습니다.
예를 들어:
| 대상 버전 | 호환되는 소스 버전 |
|---|---|
| 13.0 | 13.0, 12.10, 12.9 |
| 13.1 | 13.1, 13.0, 12.10 |
내보내진 그룹 항목
그룹을 파일로 내보낼 때 이주할 때 내보내고 가져올 항목이 기재된 import_export.yml 파일이 있습니다. 목적지 GitLab 인스턴스로 가져올 수 있는 항목을 확인하려면 해당 GitLab 버전의 브랜치에서 이 파일을 확인해 주세요. 예를 들어, 16-8-stable-ee 브랜치의 import_export.yml.
내보내진 그룹 항목은 다음과 같습니다:
- 마일스톤
- 그룹 라벨 (관련 라벨 우선 순위 없음)
- 보드와 보드 목록
- 뱃지
- 하위 그룹 (앞에서 언급된 모든 데이터 포함)
- 에픽
- 에픽 리소스 상태 이벤트. GitLab 15.4에 도입.
- 이벤트
- 위키
- 이터레이션 주기. GitLab 15.4에 도입.
내보내진 그룹 항목
내보내지 않은 항목은 다음과 같습니다:
- 프로젝트
- 러너 토큰
- SAML 검색 토큰
- 업로드
준비
- 가져올 그룹의 멤버 목록과 그들의 권한을 보존하려면 이러한 그룹의 사용자를 검토하세요. 원하는 그룹을 가져오기 전에 이러한 사용자가 존재하는지 확인하십시오.
- 사용자는 대상 GitLab 인스턴스에서 확인된 기본 이메일과 일치하는 공개 이메일을 설정해야 합니다. 대부분의 사용자들은 이메일 주소를 확인하라는 이메일을 받습니다.
그룹 내보내기
전제 조건:
- 그룹에 대한 소유자 역할이 있어야 합니다.
그룹 내용을 내보내려면 다음을 수행하세요:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 설정 > 일반을 선택합니다.
- 고급 섹션에서 그룹 내보내기를 선택합니다.
- 내보내기가 생성된 후에는:
- 이메일에 포함된 링크를 클릭합니다.
- 그룹 설정 페이지를 새로고침하고 프로젝트 내보내기 영역에서 내보내기 다운로드를 선택합니다.
그룹 가져오기
그룹을 가져오려면:
- 왼쪽 사이드바의 맨 위에서 새로 만들기()를 선택한 후 새 그룹을 선택합니다.
- 그룹 가져오기를 선택합니다.
- 파일로 그룹 가져오기 섹션에서 그룹 이름을 입력하고 연결된 그룹 URL을 수정하거나 수락합니다.
- 파일 선택을 선택합니다.
- 가져오려는 GitLab 내보내기 파일을 선택합니다.
- 가져오기를 시작하려면 가져오기를 선택합니다.
요금 한도
남용을 방지하기 위해 기본적으로 사용자의 요금은 다음과 같이 제한됩니다:
| 요청 유형 | 제한 |
|---|---|
| 내보내기 | 분당 6개 그룹 |
| 내보내기 다운로드 | 그룹당 분당 1회 다운로드 |
| 가져오기 | 분당 6개 그룹 |
도움말