설정 가져오기 및 내보내기

Tier: Free, Premium, Ultimate Offering: Self-managed

수입 및 수출 관련 기능에 대한 설정입니다.

허용된 가져오기 원본 구성

다른 시스템에서 프로젝트를 가져오기 전에 해당 시스템의 가져오기 원본을 활성화해야 합니다.

  1. 관리자 액세스 수준을 갖춘 사용자로 GitLab에 로그인합니다.
  2. 왼쪽 사이드바에서 맨 아래에 관리자를 선택합니다.
  3. 설정 > 일반을 선택합니다.
  4. 수입 및 내보내기 설정 섹션을 확장합니다.
  5. 각 가져오기 원본을 선택합니다.
  6. 변경 사항 저장을 선택합니다.

프로젝트 내보내기 활성화

프로젝트 및 해당 데이터를 내보내기를 활성화하려면:

  1. 관리자 액세스 수준을 갖춘 사용자로 GitLab에 로그인합니다.
  2. 왼쪽 사이드바에서 맨 아래에 관리자를 선택합니다.
  3. 설정 > 일반을 선택합니다.
  4. 수입 및 내보내기 설정 섹션을 확장합니다.
  5. 프로젝트 내보내기로 스크롤합니다.
  6. 활성화 확인란을 선택합니다.
  7. 변경 사항 저장을 선택합니다.

직접 전송을 통한 그룹 및 프로젝트의 마이그레이션 활성화

Status: Beta

경고: GitLab 16.1 이전에는 예약된 스캔 실행 정책을 사용하지 말아야 합니다. 직접 전송을 사용하는 경우에는 먼저 GitLab 16.2로 업그레이드하고 강제로 적용하는 프로젝트에서 보안 정책 봇이 활성화되어 있는지 확인하십시오.

경고: 이 기능은 베타 상태이며 사전 통지 없이 변경될 수 있습니다. 이 기능은 프로덕션 환경에 사용하기에 적합하지 않습니다.

그룹 및 프로젝트의 직접 전송을 기본적으로 비활성화되어 있습니다. 그룹 및 프로젝트의 직접 전송을 활성화하려면:

  1. 관리자 액세스 수준을 갖춘 사용자로 GitLab에 로그인합니다.
  2. 왼쪽 사이드바에서 맨 아래에 관리자를 선택합니다.
  3. 설정 > 일반을 선택합니다.
  4. 수입 및 내보내기 설정 섹션을 확장합니다.
  5. GitLab 그룹 및 프로젝트의 직접 전송을 허용으로 스크롤합니다.
  6. 활성화 확인란을 선택합니다.
  7. 변경 사항 저장을 선택합니다.

동일한 설정은 API에서 bulk_import_enabled 속성으로 사용 가능합니다.

조용한 관리자 내보내기 활성화

  • GitLab 17.0에 플래그인 export_audit_events와 함께 소개됨. 기본적으로 비활성화됨.
  • GitLab 17.1에서 일반적으로 사용 가능하게 됨. 기능 플래그 export_audit_events 제거됨.
  • GitLab 17.1에서 파일 내보내기 다운로드를 위해 소개됨.

조용한 관리자 프로젝트 및 그룹 파일 내보내기를 활성화하여 인스턴스 관리자가 프로젝트 또는 그룹 파일 내보내기를 트리거하거나 내보낸 파일을 다운로드할 때 감사 이벤트가 발생하지 않도록 합니다. 관리자가 아닌 사용자의 내보내기는 여전히 감사 이벤트를 생성합니다.

조용한 관리자 프로젝트 및 그룹 파일 내보내기를 활성화하려면:

  1. 왼쪽 사이드바에서 맨 아래에 관리자를 선택합니다.
  2. 설정 > 일반을 선택하고 수입 및 내보내기 설정을 확장합니다.
  3. 관리자에 의한 조용한 내보내기로 스크롤합니다.
  4. 활성화 확인란을 선택합니다.

기여자 매핑을 관리자에게 허용

  • GitLab 17.5에 플래그 로 소개됨으로 기본적으로 비활성화됨.

가져온 사용자 기여를 관리자에게 매핑하는 것을 허용합니다.

가져온 사용자 기여를 관리자에게 매핑하려면:

  1. 왼쪽 사이드바에서 맨 아래에 관리자를 선택합니다.
  2. 설정 > 일반을 선택하고 수입 및 내보내기 설정을 확장합니다.
  3. 관리자에게 기여 매핑을 허용으로 스크롤합니다.
  4. 활성화 확인란을 선택합니다.

최대 내보내기 크기

GitLab에서 내보내는 최대 파일 크기를 수정하려면:

  1. 왼쪽 사이드바에서 맨 아래에 관리자를 선택합니다.
  2. 설정 > 일반을 선택하고 수입 및 내보내기 설정을 확장합니다.
  3. 최대 내보내기 크기 (MiB)의 값을 변경하여 증가 또는 감소시킵니다.

최대 가져오기 크기

GitLab에서 가져오는 파일의 최대 크기를 수정하려면:

  1. 왼쪽 사이드바에서 맨 아래에 관리자를 선택합니다.
  2. 설정 > 일반을 선택합니다.
  3. 수입 및 내보내기 설정을 확장합니다.
  4. 최대 가져오기 크기 (MiB)의 값을 변경하여 증가 또는 감소시킵니다.

이 설정은 GitLab 내보내기 파일에서 가져오는 저장소에만 적용됩니다.

구성된 값보다 큰 크기를 선택하면 웹 서버의 구성 값보다 큰 크기로 설정하는 경우 오류가 발생할 수 있습니다. 자세한 내용은 문제 해결 섹션을 참조하십시오.

GitLab.com 저장소 크기 제한에 대한 자세한 내용은 계정 및 제한 설정을 읽으십시오.

가져오기용 원격 파일 최대 크기

기본적으로 외부 객체 저장소(예: AWS)에서 가져오는 파일의 최대 원격 파일 크기는 10 GiB입니다.

이 설정을 수정하려면:

  1. 왼쪽 사이드바에서 맨 아래에 관리자를 선택합니다.
  2. 설정 > 일반을 선택합니다.
  3. 수입 및 내보내기 설정을 확장합니다.
  4. 최대 가져오기 원격 파일 크기 (MiB)의 값을 변경하여 증가 또는 감소시킵니다. 파일 크기 제한을 없애려면 0을 설정하십시오.

직접 전송에 의한 가져 오기의 최대 다운로드 파일 크기

기본적으로, 직접 전송에 의한 가져오기의 최대 다운로드 파일 크기는 5 GiB입니다.

이 설정을 수정하려면 다음을 수행하세요.

  1. 왼쪽 사이드바에서 아래쪽에 관리자를 선택합니다.
  2. 설정 > 일반을 선택합니다.
  3. 가져오기 및 내보내기 설정을 확장합니다.
  4. 직접 전송 최대 다운로드 파일 크기 (MiB)의 값을 변경하여 증가 또는 감소시킵니다. 다운로드 파일 크기 제한을 두지 않으려면 0으로 설정하세요.

가져온 아카이브의 최대 압축 해제 파일 크기

  • GitLab 16.3에서 소개됨.
  • GitLab 16.4에서 가져온 아카이브의 최대 압축 해제 파일 크기 필드 이름 변경됨.

파일 내보내기 또는 직접 전송을 사용하여 프로젝트를 가져올 때, 가져온 아카이브의 최대 압축 해제 파일 크기를 지정할 수 있습니다. 기본값은 25 GiB입니다.

압축 파일을 가져올 때, 압축 해제된 크기는 최대 압축 해제 파일 크기 제한을 초과할 수 없습니다. 압축 해제된 크기가 구성된 제한을 초과하는 경우 다음 오류가 반환됩니다. 

압축 해제된 아카이브 크기 유효성 검사에 실패했습니다.

이 설정을 수정하려면 다음을 수행하세요.

  1. 왼쪽 사이드바에서 아래쪽에 관리자를 선택합니다.
  2. 설정 > 일반을 선택합니다.
  3. 가져오기 및 내보내기 설정을 확장합니다.
  4. 가져온 아카이브의 최대 압축 해제 파일 크기 (MiB)에 다른 값을 설정합니다.

아카이브된 파일의 압축 해제 시간 제한

프로젝트를 가져올 때, 가져온 아카이브의 압축 해제를 위한 최대 시간을 지정할 수 있습니다. 기본값은 210초입니다.

GitLab에서 가져온 파일의 최대 압축 해제 파일 크기를 수정하려면:

  1. 왼쪽 사이드바에서 아래쪽에 관리자를 선택합니다.
  2. 설정 > 일반을 선택합니다.
  3. 가져오기 및 내보내기 설정을 확장합니다.
  4. 원하는 값으로 아카이브된 파일의 압축 해제 시간 제한 (초)을 설정합니다.

동시에 실행되는 최대 가져오기 작업 수

다음을 위해 동시에 실행되는 최대 가져오기 작업 수를 지정할 수 있습니다.

작업 제한은 병합 요청 가져오기에는 적용되지 않습니다. 이는 서버를 과부하시키지 않기 위해 병합 요청에 대한 하드 코딩된 제한이 있기 때문입니다.

기본 작업 제한은 다음과 같습니다.

  • GitHub 가져오기 도구의 경우, 1000입니다.
  • Bitbucket Cloud 및 Bitbucket Server 가져오기 도구의 경우, 100입니다. Bitbucket 가져오기 도구의 기본 제한이 낮은 이유는 아직 적절한 기본 제한을 결정하지 못했기 때문입니다. 자체 호스팅 GitLab 인스턴스의 관리자는 더 높은 제한을 실험해야 합니다.

이 설정을 수정하려면 다음을 수행하세요.

  1. 왼쪽 사이드바에서 아래쪽에 관리자를 선택합니다.
  2. 설정 > 일반을 선택합니다.
  3. 가져오기 및 내보내기 설정을 확장합니다.
  4. 원하는 가져오기 도구에 대한 동시에 실행되는 최대 가져오기 작업 수에 다른 값을 설정합니다.

문제 해결

오류: 도움말 페이지 문서 기본 URL이 차단됨: 실행 시간이 만료됨

가능한 가져오기 소스 구성와 같은 애플리케이션 설정을 활성화하는 동안 도움말 페이지 문서 기본 URL이 차단됨: 실행 시간이 만료됨 오류가 발생할 수 있습니다. 이 오류를 해결하려면:

  1. 허용 목록에 docs.gitlab.com 또는 리디렉션 도움말 문서 URL을 추가합니다.
  2. 변경 사항 저장을 선택합니다.