GitLab 프로젝트에는 Git 리포지터리와 Large File Storage(LFS)에 대한 스토리지 제한이 있습니다. 스토리지 제한에는 프로젝트의 리포지터리와 LFS만 포함됩니다. 컨테이너 레지스트리, 패키지 레지스트리, 빌드 아티팩트는 제한에 포함되지 않습니다.

프로젝트의 리포지터리와 LFS가 제한을 초과하면 해당 프로젝트는 읽기 전용 상태가 되고 일부 작업이 제한됩니다.

무료 제한#

GitLab.com의 Free 티어 네임스페이스에 속한 각 프로젝트에는 10GiB의 무료 스토리지가 제공됩니다.

프로젝트의 리포지터리와 LFS 스토리지를 10GiB 이상으로 늘리려면 스토리지를 추가로 구매해야 합니다.

고정 프로젝트 제한#

GitLab.com의 Premium 또는 Ultimate 티어에 속한 각 프로젝트에는 500GiB의 스토리지가 제공됩니다.

프로젝트가 스토리지 제한을 초과하면 그룹과 최상위 네임스페이스의 소유자에게 UI와 이메일로 알림이 전달됩니다.

스토리지 사용량을 관리하려면 계정 담당 팀 또는 GitLab 지원팀에 문의합니다.

만료된 스토리지#

구매한 스토리지가 구독 기간이 끝날 때 해제되지 않으면 만료된 스토리지가 남을 수 있습니다. 구매한 스토리지가 예기치 않게 줄어들었다면 만료된 스토리지가 계정에서 제거되었을 수 있습니다. 자세한 내용과 해결 방법은 지원팀에 문의합니다.

스토리지 보기#

프로젝트와 네임스페이스의 스토리지 사용량에 대해 다음 통계를 확인할 수 있습니다.

• GitLab.com 스토리지 제한 또는 GitLab Self-Managed 스토리지 제한을 초과한 스토리지 사용량.
• GitLab.com에서 사용 가능한 구매 스토리지.

사전 요구 사항:

• 프로젝트의 스토리지 사용량을 확인하려면 해당 프로젝트에 대한 Maintainer 또는 Owner 권한이나 네임스페이스에 대한 Owner 권한이 있어야 합니다.
• 그룹 네임스페이스의 스토리지 사용량을 확인하려면 해당 네임스페이스에 대한 Owner 권한이 있어야 합니다.

스토리지를 확인하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트나 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > Usage quotas를 선택합니다.
3. Storage 탭을 선택하여 네임스페이스 스토리지 사용량을 확인합니다.
4. 프로젝트의 스토리지 사용량을 확인하려면 하단 표에서 프로젝트를 선택합니다. 스토리지 사용량은 90분마다 갱신됩니다.

네임스페이스에 'Not applicable.' 이 표시되면 해당 네임스페이스의 아무 프로젝트에나 커밋을 푸시하여 스토리지를 다시 계산합니다.

스토리지와 네트워크 사용량은 이진 측정 체계(1024단위 배수)로 계산됩니다. 스토리지 사용량은 키비바이트(KiB), 메비바이트(MiB), 기비바이트(GiB) 단위로 표시됩니다. 1KiB는 2¹⁰바이트(1024바이트), 1MiB는 2²⁰바이트(1024키비바이트), 1GiB는 2³⁰바이트(1024메비바이트)입니다.

프로젝트 포크 스토리지 사용량 보기#

프로젝트 포크가 사용하는 스토리지에는 비용 계수가 적용되어, 포크가 실제 크기보다 적은 네임스페이스 스토리지를 사용합니다. 포크 스토리지 절감을 위한 비용 계수는 네임스페이스 스토리지에만 적용됩니다. 프로젝트 리포지터리 스토리지 제한에는 적용되지 않습니다.

포크가 사용한 네임스페이스 스토리지 양을 확인하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트나 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > Usage quotas를 선택합니다.
3. Storage 탭을 선택합니다. Total 칼럼에는 디스크상의 실제 포크 크기 대비 포크가 사용한 네임스페이스 스토리지 양이 표시됩니다.

비용 계수는 프로젝트 리포지터리, LFS 오브젝트, job 아티팩트, 패키지, 스니펫, 위키에 적용됩니다.

비용 계수는 Free 플랜 네임스페이스의 비공개 포크에는 적용되지 않습니다.

초과 스토리지 사용량#

초과 스토리지 사용량은 프로젝트 리포지터리와 LFS의 무료 스토리지 10GiB를 넘는 양입니다. 사용 가능한 구매 스토리지가 없으면 해당 프로젝트는 읽기 전용 상태가 됩니다. 읽기 전용 프로젝트에는 변경 사항을 푸시할 수 없습니다.

읽기 전용 상태를 해제하려면 네임스페이스에 스토리지를 추가로 구매해야 합니다. 구매가 완료되면 읽기 전용 상태가 해제되고 프로젝트가 자동으로 복원됩니다. 사용 가능한 구매 스토리지는 항상 0보다 커야 합니다.

Usage quotas 페이지의 Storage 탭에는 다음 내용이 표시됩니다.

• 사용 가능한 구매 스토리지가 부족한 상태입니다.
• 사용 가능한 구매 스토리지가 0이 되면 읽기 전용이 될 위험이 있는 프로젝트입니다.
• 사용 가능한 구매 스토리지가 0이어서 읽기 전용이 된 프로젝트입니다. 읽기 전용 프로젝트는 이름 옆에 정보 아이콘([information-o])이 표시됩니다.

전체 스토리지에는 무료 스토리지와 구매한 초과 스토리지가 포함됩니다. 남은 초과 스토리지는 백분율로 표시되며 다음과 같이 계산됩니다. 100% - ((사용한 초과 스토리지 - 구매한 초과 스토리지) × 100).

초과 스토리지 예시#

다음 예시는 한 네임스페이스에 속한 프로젝트의 초과 스토리지 시나리오를 보여 줍니다.

Red와 Green 프로젝트는 리포지터리와 LFS가 쿼터에 도달하여 읽기 전용입니다. 이 예시에서는 아직 스토리지를 추가로 구매하지 않았습니다.

Red와 Green 프로젝트의 읽기 전용 상태를 해제하기 위해 50GiB의 스토리지를 추가로 구매합니다.

일부 프로젝트의 리포지터리와 LFS가 10GiB 쿼터를 넘어 커지면 사용 가능한 구매 스토리지가 줄어듭니다.

이 예시의 내용은 다음과 같습니다.

• 사용 가능한 구매 스토리지는 40GiB입니다. 50GiB(구매 스토리지) - 10GiB(사용한 전체 초과 스토리지). 따라서 프로젝트는 더 이상 읽기 전용이 아닙니다.
• 초과 스토리지 사용률은 20%입니다. 10GiB / 50GiB × 100.
• 남은 구매 스토리지는 80%입니다.

스토리지 사용 관리#

Free GitLab.com 네임스페이스의 네임스페이스 Owner라면 스토리지 관리를 위해 해당 네임스페이스에 스토리지를 추가로 구매할 수 있습니다.

Premium 및 Ultimate 티어에서는 보유한 권한에 따라 리포지터리 크기를 줄일 수도 있습니다. 스토리지 사용량 분석과 관리를 자동화하는 방법은 스토리지 관리 자동화를 참고합니다.

스토리지 사용량 관리 외에 사용 가능한 자원을 늘리기 위해 다음 방안도 고려할 수 있습니다.

• 자격 요건을 충족한다면 커뮤니티 프로그램 구독을 신청합니다.
  • GitLab for Education
  • GitLab for Open Source
  • GitLab for Startups
• 스토리지 제한이 없는 GitLab Self-Managed 구독을 고려합니다.
• 선택 가능한 방안에 대한 자세한 내용은 전문가와 상담합니다.

더 많은 스토리지 구매#

사전 요구 사항:

• Owner 권한이 있거나 청구 계정 관리자여야 합니다.
• 청구 계정이 개인 또는 그룹 네임스페이스의 구독에 연결되어 있어야 합니다.

개인 네임스페이스에 대해#

1. GitLab.com에 로그인합니다.
2. 개인 홈페이지 또는 그룹 페이지에서 Settings > Usage quotas로 이동합니다.
3. Storage 탭을 선택합니다.
4. 읽기 전용인 각 프로젝트에 대해 Usage가 무료 쿼터와 구매 스토리지를 얼마나 초과했는지 합산합니다. 이 합계를 넘는 스토리지 단위를 구매해야 합니다.
5. Buy storage를 선택합니다. Customers Portal로 이동합니다.
6. Subscription details 섹션에서 드롭다운 목록으로 사용자 이름을 선택합니다.
7. 원하는 스토리지 팩 수량을 입력합니다.
8. Customer information 섹션에서 주소를 확인합니다.
9. Billing information 섹션에서 드롭다운 목록으로 결제 수단을 선택합니다.
10. Privacy Statement와 Terms of Service 체크박스를 선택합니다.
11. Buy storage를 선택합니다.

Purchased storage available 합계가 구매한 양만큼 증가합니다. 모든 프로젝트의 읽기 전용 상태가 해제되고, 초과 사용량은 추가 스토리지에서 차감됩니다.

그룹 네임스페이스에 대해#

GitLab.com을 사용한다면 기본 쿼터의 스토리지를 모두 소진한 뒤에도 파이프라인이 중단되지 않도록 스토리지를 추가로 구매할 수 있습니다. 추가 스토리지 가격은 GitLab 요금 페이지에서 확인할 수 있습니다.

GitLab.com에서 그룹에 스토리지를 추가로 구매하려면 다음 단계를 수행합니다.

결제가 처리되면 그룹 네임스페이스에서 추가 스토리지를 사용할 수 있습니다.

사용 가능한 스토리지를 확인하려면 앞의 세 단계를 그대로 수행합니다.

Purchased storage available 합계가 구매한 양만큼 증가합니다. 잠긴 모든 프로젝트가 잠금 해제되고, 초과 사용량은 추가 스토리지에서 차감됩니다.