설정 가져오기 및 내보내기

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

가져오기 및 내보내기 관련 기능 설정.

허용된 가져오기 원본 구성

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

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

프로젝트 내보내기 활성화

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

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

직접 전송에 의한 그룹 및 프로젝트 이전 활성화

Status: Beta
caution
GitLab 16.1 이전 버전에서는 예약된 스캔 실행 정책을 사용해서 직접 전송을 사용하지 말아야 합니다. 직접 전송을 사용하는 경우, 먼저 GitLab 16.2로 업그레이드하고 강제로 적용하는 프로젝트에서 보안 정책 봇이 활성화되어 있는지 확인합니다.
caution
이 기능은 베타 버전이며 사전 통지없이 변경될 수 있습니다. 이 기능은 제품 사용에 적합하지 않습니다.

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

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

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

최대 내보내기 크기

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에서 가져온 아카이브용 최대 비압축 파일 크기 필드가 최대 비압축 크기에서 변경되었습니다(https://gitlab.com/gitlab-org/gitlab/-/merge_requests/130081).

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

압축 파일을 가져올 때, 비압축 크기는 설정된 제한을 초과할 수 없습니다. 만약 비압축 크기가 설정된 제한을 초과하면 다음과 같은 오류가 반환됩니다: 

비압축 아카이브 크기 유효성 검사 실패.

이 설정을 수정하려면:

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

아카이브 파일의 비압축 시간 초과

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

이 설정을 수정하려면:

  1. 왼쪽 사이드바에서 아래로 이동하여 관리 영역을 선택합니다.
  2. 설정 > 일반을 선택합니다.
  3. 가져오기 및 내보내기 설정을 확장합니다.
  4. 아카이브 파일 비압축 시간 초과 (초)에 다른 값을 설정합니다.

동시 가져오기 작업의 최대 개수

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

작업 제한은 Merge Request의 경우에는 적용되지 않습니다. Merge Request에 대해 서버 과부하를 피하기 위해 하드 코딩된 제한이 존재합니다.

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

  • GitHub 가져오기의 경우 1000
  • Bitbucket Cloud 및 Bitbucket Server 가져오기의 경우 100. Bitbucket 가져오기의 경우 적절한 기본 제한을 아직 결정하지 못했기 때문에 Bitbucket 가져오기의 Self-Managed형 GitLab 인스턴스의 관리자는 더 높은 제한을 실험해 보아야 합니다.

이 설정을 수정하려면:

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