가져오기 및 내보내기 설정

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

가져오기 및 내보내기 관련 기능에 대한 설정입니다.

허용된 가져오기 소스 구성

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

  1. 관리 권한이 있는 사용자로 GitLab에 로그인합니다.
  2. 왼쪽 사이드바의 하단에서 Admin을 선택합니다.
  3. Settings > General을 선택합니다.
  4. Import and export settings 섹션을 확장합니다.
  5. 허용할 Import sources를 각각 선택합니다.
  6. Save changes를 선택합니다.

프로젝트 내보내기 활성화

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

  1. 관리 권한이 있는 사용자로 GitLab에 로그인합니다.
  2. 왼쪽 사이드바의 하단에서 Admin을 선택합니다.
  3. Settings > General을 선택합니다.
  4. Import and export settings 섹션을 확장합니다.
  5. Project export로 스크롤합니다.
  6. Enabled 체크박스를 선택합니다.
  7. Save changes를 선택합니다.

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

Status: Beta
caution
GitLab 16.1 및 이전 버전에서는 예정된 스캔 실행 정책과 함께 직접 전송을 사용하지 않아야 합니다. 직접 전송을 사용하는 경우 GitLab 16.2로 먼저 업그레이드하고 강제 적용 중인 프로젝트에서 보안 정책 봇이 활성화되어 있는지 확인하세요.
caution
이 기능은 베타 상태이며 사전 공지 없이 변경될 수 있습니다.
이 기능은 프로덕션 사용에 준비되지 않았습니다.

직접 전송을 통한 그룹 및 프로젝트 마이그레이션은 기본적으로 비활성화되어 있습니다.
직접 전송을 통한 그룹 및 프로젝트 마이그레이션을 활성화하려면:

  1. 관리 권한이 있는 사용자로 GitLab에 로그인합니다.
  2. 왼쪽 사이드바의 하단에서 Admin을 선택합니다.
  3. Settings > General을 선택합니다.
  4. Import and export settings 섹션을 확장합니다.
  5. Allow migrating GitLab groups and projects by direct transfer로 스크롤합니다.
  6. Enabled 체크박스를 선택합니다.
  7. Save changes를 선택합니다.

같은 설정은 API에서 bulk_import_enabled 속성으로
사용할 수 있습니다.

비공식 관리자 내보내기 활성화

엑스포트 파일을 다운로드하거나 프로젝트 또는 그룹 파일 내보내기를 트리거할 때 인스턴스 관리자가 생성하는 감사 이벤트를 방지하기 위해 비공식 관리자 내보내기를 활성화하세요. 비관리자로부터의 내보내기는 여전히 감사 이벤트를 생성합니다.

비공식 관리자 프로젝트 및 그룹 파일 내보내기를 활성화하려면:

  1. 왼쪽 사이드바의 하단에서 Admin을 선택합니다.
  2. Settings > General을 선택한 다음 Import and export settings를 확장합니다.
  3. Silent exports by admins로 스크롤합니다.
  4. Enabled 체크박스를 선택합니다.

관리자에게 기여 매핑 허용

  • GitLab 17.5에서 importer_user_mapping이라는 플래그와 함께 도입됨. 기본적으로 비활성화되어 있음.

가져온 사용자 기여를 관리자에게 매핑할 수 있도록 허용합니다.

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

  1. 왼쪽 사이드바에서 아래로 스크롤하여 Admin를 선택합니다.
  2. Settings > General을 선택한 다음 Import and export settings를 확장합니다.
  3. Allow contribution mapping to administrators로 스크롤합니다.
  4. Enabled 체크박스를 선택합니다.

최대 내보내기 크기

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

  1. 왼쪽 사이드바에서 아래로 스크롤하여 Admin를 선택합니다.
  2. Settings > General을 선택한 다음 Import and export settings를 확장합니다.
  3. Maximum export size (MiB)에서 값을 변경하여 증가 또는 감소시킵니다.

최대 가져오기 크기

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

  1. 왼쪽 사이드바에서 아래로 스크롤하여 Admin를 선택합니다.
  2. Settings > General을 선택합니다.
  3. Import and export settings를 확장합니다.
  4. Maximum import size (MiB)에서 값을 변경하여 증가 또는 감소시킵니다.

이 설정은 GitLab 내보내기 파일에서 가져온 리포지토리에만 적용됩니다.

서버에 대한 구성된 값보다 큰 크기를 선택하면 오류가 발생할 수 있습니다. 문제 해결 섹션을 참조하여 자세한 내용을 확인하세요.

GitLab.com 리포지토리 크기 제한에 대한 내용은 계정 및 제한 설정을 읽어보세요.

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

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

이 설정을 수정하려면:

  1. 왼쪽 사이드바에서 아래로 스크롤하여 Admin를 선택합니다.
  2. Settings > General을 선택합니다.
  3. Import and export settings를 확장합니다.
  4. Maximum import remote file size (MiB)에서 값을 변경하여 증가 또는 감소시킵니다. 파일 크기 제한을 설정하지 않으려면 0으로 설정합니다.

직접 전송을 통한 가져오기용 최대 다운로드 파일 크기

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

이 설정을 수정하려면:

  1. 왼쪽 사이드바에서 아래로 스크롤하여 Admin를 선택합니다.
  2. Settings > General을 선택합니다.
  3. Import and export settings를 확장합니다.
  4. Direct transfer maximum download file size (MiB)에서 값을 변경하여 증가 또는 감소시킵니다. 파일 다운로드 크기 제한을 설정하지 않으려면 0으로 설정합니다.

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

  • GitLab 16.3에서 도입됨.
  • GitLab 16.4에서 Maximum decompressed size 필드가 변경됨 Maximum decompressed file size for archives from imports.

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

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

Decompressed archive size validation failed.

이 설정을 수정하려면:

  1. 왼쪽 사이드바에서 아래로 스크롤하여 Admin를 선택합니다.
  2. Settings > General을 선택합니다.
  3. Import and export settings를 확장합니다.
  4. Maximum decompressed file size for archives from imports (MiB)의 다른 값을 설정합니다.

압축된 파일 압축 해제 시간 초과

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

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

  1. 왼쪽 사이드바 하단에서 Admin을 선택합니다.
  2. Settings > General을 선택합니다.
  3. Import and export settings를 확장합니다.
  4. Timeout for decompressing archived files (seconds)에 대한 다른 값을 설정합니다.

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

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

병합 요청을 가져올 때는 서버 과부하를 방지하기 위한 하드코딩된 한계가 있기 때문에 작업 제한이 적용되지 않습니다.

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

  • GitHub importer의 경우, 1000.
  • Bitbucket Cloud 및 Bitbucket Server importer의 경우, 100. Bitbucket importer는 아직 적절한 기본 한계를 결정하지 않았기 때문에 낮은 기본 한계를 가지고 있습니다. Self-managed GitLab 인스턴스 관리자는 더 높은 제한으로 실험해야 합니다.

이 설정을 수정하려면:

  1. 왼쪽 사이드바 하단에서 Admin을 선택합니다.
  2. Settings > General을 선택합니다.
  3. Import and export settings를 확장합니다.
  4. 원하는 importer에 대한 Maximum number of simultaneous import jobs에 대한 다른 값을 설정합니다.

문제 해결

오류: Help page documentation base url is blocked: execution expired

허용된 가져오기 소스와 같은 애플리케이션 설정을 활성화할 때 Help page documentation base url is blocked: execution expired 오류가 발생할 수 있습니다. 이 오류를 우회하려면:

  1. docs.gitlab.com 또는 리다이렉트 도움말 문서 페이지 URL을 허용 목록에 추가합니다.
  2. Save Changes를 선택합니다.