GitLab(https://about.gitlab.com) 바로가기
GitLab(https://about.gitlab.com) 바로가기 자세히 보기 >
GitLab은 코드 저장소와 CI/CD를 함께 쓰는 개발 플랫폼이고, about.gitlab.com은 그 공식 소개 사이트입니다. 무료로 팀 작업을 시작했다가 가장 많이 막히는 지점은 GitLab.com 무료 등급의 사용자 5명 제한입니다. 아래에서 5명 제한과 세는 법, 읽기 전용 때 막히는 작업, 제한이 없는 경우, 저장공간 10GiB와 CI 컴퓨트 분 400분 한도를 공식 문서 기준으로 정리했습니다.
체크 포인트
비공개 그룹은 5명까지 — 6명째부터 그룹 전체가 읽기 전용이 되고 무료로는 늘릴 수 없습니다 · 저장공간 프로젝트당 10GiB — 넘으면 그 프로젝트는 푸시가 막힙니다 · CI 컴퓨트 분 월 400분 — 매월 1일 초기화되고 러너 크기만큼 빨리 줄어듭니다
GitLab 무료 등급 사용자 5명 제한
GitLab.com 무료 등급에서 비공개 최상위 그룹은 사용자를 5명까지만 둘 수 있습니다. 공식 문서 기준입니다.
| 구분 | 내용 |
|---|---|
| 적용 대상 | GitLab.com 무료 등급의 비공개 최상위 네임스페이스 |
| 한도 | 5명 |
| 새 그룹 | 생성 시점부터 적용 |
| 옛 그룹 | 2022년 12월 28일 이전 생성분은 2023년 6월 13일부터 적용 |
| 초과 시 | 그룹 전체 읽기 전용 |
| 무료 등급에서 늘리기 | 불가 |
가장 먼저 알아야 할 점은 이 한도를 무료 등급 안에서는 늘릴 수 없다는 것입니다. 공식 문서는 큰 팀이라면 Premium이나 Ultimate 유료 등급으로 올리라고 안내합니다. 유료 등급은 사용자 수 제한이 없습니다.
읽기 전용을 푸는 방법은 세 가지입니다.
- 그룹 멤버를 5명 이하로 줄입니다.
- Ultimate 무료 체험을 시작합니다. 체험 기간에는 멤버 수 제한이 없습니다.
- 유료 등급을 구매합니다.
회사에 이미 유료 그룹이 있다면 무료 그룹을 그 회사의 최상위 네임스페이스로 옮겨 구독에 포함시킬 수 있습니다. 다만 옮겨 오는 그룹에서 기존 유료 그룹에 없던 사람만큼 좌석이 늘어 추가 비용이 생길 수 있습니다. 유료 구독인데도 5명 제한이 걸렸다면 구독이 올바른 최상위 네임스페이스와 고객 포털 계정에 연결돼 있는지 확인하라고 공식 문서에 적혀 있습니다.
GitLab 사용자 5명 세는 법과 멤버 정리
5명은 그룹 하나가 아니라 최상위 네임스페이스 전체의 고유 사용자로 셉니다. 그룹·하위 그룹·프로젝트에 따로 들어간 사람이 모두 합쳐집니다.
| 구분 | 내용 |
|---|---|
| 세는 범위 | 그룹 + 하위 그룹 + 프로젝트의 모든 사용자 |
| 중복 | 여러 곳에 있는 같은 사람은 1명 |
| 예시 1 | 그룹 A, 하위 그룹 B, 프로젝트 C·D → 4명, 통과 |
| 예시 2 | 위 구조에 프로젝트 하나 더(E·F) → 6명, 초과 |
| 확인 위치 | 그룹 → 설정 → 사용량 할당량 → 좌석 탭 |
| 확인 권한 | 그룹 Owner |
공식 예시처럼 프로젝트 하나에 두 명을 더 넣는 순간 전체가 6명이 되어 초과합니다.
멤버를 정리하는 순서는 이렇습니다.
- 상단 검색에서 그룹을 찾아 들어갑니다.
- 왼쪽 메뉴에서 설정 → 사용량 할당량(Usage quotas)을 고릅니다.
- 좌석(Seats) 탭에서 네임스페이스 전체 멤버를 봅니다.
- 뺄 사람 옆의 사용자 제거(Remove user)를 누릅니다.
이 화면은 그룹 Owner만 볼 수 있습니다.
GitLab 읽기 전용 상태에서 막히는 작업
읽기 전용이 되면 코드는 볼 수 있지만 대부분의 쓰기 작업이 막힙니다. 막힌 작업을 시도하면 404 오류가 날 수 있다고 공식 문서에 적혀 있습니다.
| 기능 | 막히는 작업 |
|---|---|
| 머지 리퀘스트 | 생성·수정 불가 |
| CI/CD | 파이프라인·빌드 생성·편집·실행 불가, 배포·릴리스 편집 불가 |
| 저장소·LFS | 새 데이터 쓰기 불가 |
| 패키지 레지스트리 | 패키지 게시 불가 |
| 컨테이너 레지스트리 | 이미지 푸시, 정리 정책 생성·편집·삭제 불가 |
| 네임스페이스 | 새 사용자 초대 불가 |
사용자 수 때문이 아니라 저장공간 때문에 읽기 전용이 되는 경우도 있습니다. 이때는 그룹 전체가 아니라 한도를 넘은 프로젝트만 읽기 전용이 되고, 저장소에 푸시하거나 대용량 파일(LFS)을 추가할 수 없습니다. 프로젝트나 네임스페이스 페이지 위쪽 배너에 읽기 전용 상태가 표시됩니다.
두 경우는 푸는 방법이 다릅니다. 사용자 수 초과는 인원을 줄이거나 체험·유료로, 저장공간 초과는 저장공간을 추가로 사야 풀립니다.
GitLab 5명 제한이 없는 경우와 최상위 그룹 3개 제한
5명 제한은 GitLab.com 무료 등급의 비공개 최상위 그룹에만 걸립니다. 아래 경우에는 적용되지 않습니다.
| 구분 | 5명 제한 |
|---|---|
| 공개 최상위 그룹 | 제한 없음 |
| 개인 네임스페이스 | 제한 없음(기본 공개) |
| 개인 프로젝트 | 5명 넘게 초대 가능 |
| 유료 등급 | Premium·Ultimate는 사용자 제한 없음 |
| 자체 설치 | GitLab Self-Managed는 적용 안 됨 |
| 지원 프로그램 | 오픈소스·교육·스타트업 프로그램 |
개인 프로젝트는 5명 넘게 초대할 수 있지만, 공식 문서는 개인 프로젝트를 그룹으로 옮기라고 권합니다. 개인 프로젝트 상태로는 유료 등급, 추가 컴퓨트 분, 추가 저장공간을 살 수 없고 그룹 기능과 Ultimate 체험도 쓸 수 없기 때문입니다.
새로 생긴 제한도 있습니다. 2026년 1월 27일 이후 만든 무료 계정은 최상위 그룹을 3개까지만 만들 수 있습니다. 개인 네임스페이스는 이 3개에 들어가지 않고, Ultimate 체험 중인 계정에도 같은 제한이 걸립니다. 그룹을 더 만들려면 유료 등급으로 올려야 합니다.
GitLab 저장공간 프로젝트당 10GiB
무료 등급은 프로젝트마다 저장공간 10GiB를 줍니다. 계산에 들어가는 것은 저장소와 LFS뿐입니다.
| 구분 | 내용 |
|---|---|
| 무료 한도 | 프로젝트당 10GiB |
| 포함 | Git 저장소, 대용량 파일(LFS) |
| 제외 | 컨테이너 레지스트리, 패키지 레지스트리, 빌드 아티팩트 |
| 초과 시 | 그 프로젝트 읽기 전용, 푸시 불가 |
| 해제 | 네임스페이스 저장공간 추가 구매 |
| 유료 등급 | Premium·Ultimate 프로젝트당 500GiB |
한도는 네임스페이스 전체가 아니라 프로젝트 하나하나에 걸립니다. 공식 예시에서 프로젝트 네 개 가운데 10GiB를 채운 두 개만 읽기 전용이 되고, 8GiB와 2GiB인 프로젝트는 그대로 쓸 수 있습니다.
저장공간을 사면 10GiB를 넘은 만큼이 구매분에서 빠집니다. 사용 가능한 구매분은 항상 0보다 커야 하고, 0이 되면 다시 읽기 전용이 됩니다. 구독 기간이 끝날 때 회수되지 않은 구매분이 나중에 정리되면서 갑자기 줄어든 것처럼 보일 수도 있다고 문서에 적혀 있습니다.
사용량은 프로젝트나 그룹의 설정 → 사용량 할당량 → 저장공간 탭에서 봅니다. 프로젝트는 Maintainer 이상, 그룹은 Owner만 볼 수 있습니다.
GitLab CI 컴퓨트 분 월 400분과 계산법
GitLab이 제공하는 러너로 CI/CD 작업을 돌리면 컴퓨트 분이 줄어듭니다. 무료 등급은 네임스페이스마다 한 달 400분입니다.
| 구분 | 내용 |
|---|---|
| 무료 할당 | 네임스페이스당 월 400분 |
| 초기화 | 매월 1일 |
| 계산식 | 작업 시간(초) ÷ 60 × 비용계수 |
| 리눅스 기본(small) | 비용계수 1 |
| 리눅스 medium·large | 비용계수 2·3 |
| 리눅스 xlarge·2xlarge | 비용계수 6·12 |
러너를 키우면 그만큼 빨리 줄어듭니다. 2xlarge 러너로 10분짜리 작업을 돌리면 120분이 빠집니다. 작업이 동시에 돌면 각각 합산되므로 파이프라인이 끝까지 걸린 시간보다 사용량이 더 클 수 있습니다. 대기·생성 상태에 있던 시간은 빠지고, 하위 파이프라인을 부르기만 하는 트리거 작업은 분을 쓰지 않습니다.
주의할 점은 누구의 사용량으로 잡히느냐입니다. 그룹 안의 프로젝트에서 돌린 작업은 실행한 사람이 아니라 그 그룹의 최상위 네임스페이스에서 빠집니다. 내 개인 프로젝트에서 돌린 것만 내 네임스페이스에서 빠집니다.
추가로 산 컴퓨트 분은 월 할당 400분을 다 쓴 뒤에 쓰이고, 남으면 다음 달로 넘어갑니다. 공식 문서의 절약 방법은 미러 업데이트용 파이프라인 끄기, 예약 파이프라인 빈도 줄이기, 필요 없을 때 파이프라인 건너뛰기, 새 커밋이 오면 자동 취소되는 작업(interruptible) 쓰기입니다.
GitLab 자주 묻는 질문
Q. GitLab 무료로 몇 명까지 쓸 수 있나요?
GitLab.com 무료 등급의 비공개 최상위 그룹은 5명까지입니다. 그룹·하위 그룹·프로젝트의 고유 사용자를 모두 합쳐 세고, 넘으면 그룹 전체가 읽기 전용이 됩니다. 무료 등급에서는 이 한도를 늘릴 수 없습니다.
Q. GitLab 읽기 전용은 어떻게 풀어요?
멤버를 5명 이하로 줄이거나, Ultimate 무료 체험을 시작하거나, 유료 등급을 사면 풀립니다. 저장공간 10GiB를 넘어 읽기 전용이 된 프로젝트는 저장공간을 추가로 사야 풀립니다.
Q. GitLab 공개 프로젝트도 5명 제한이 있나요?
공개 최상위 그룹과 개인 네임스페이스에는 5명 제한이 적용되지 않습니다. 유료 등급, 자체 설치형 GitLab, 오픈소스·교육·스타트업 프로그램도 제외됩니다.
Q. GitLab 무료 CI는 한 달에 얼마나 쓸 수 있나요?
무료 등급 네임스페이스는 한 달에 컴퓨트 분 400분을 받고 매월 1일에 초기화됩니다. 기본 리눅스 small 러너는 1분에 1분씩 빠지지만 큰 러너는 비용계수만큼 더 빨리 줄어듭니다.
Q. GitLab 무료 계정은 그룹을 몇 개 만들 수 있나요?
2026년 1월 27일 이후 만든 무료 계정은 최상위 그룹을 3개까지 만들 수 있습니다. 개인 네임스페이스는 이 수에 들어가지 않고, 더 만들려면 유료 등급이 필요합니다.
GitLab.com을 무료로 팀과 함께 쓴다면 비공개 최상위 그룹의 5명 제한부터 확인해야 합니다. 그룹, 하위 그룹, 프로젝트에 흩어진 사람을 모두 합쳐 세고, 6명째가 되면 그룹 전체가 읽기 전용이 되어 머지 리퀘스트와 파이프라인, 새 초대가 막힙니다. 무료 등급에서는 한도를 늘릴 수 없으니 인원을 줄이거나 Ultimate 체험, 유료 등급 가운데 하나를 골라야 합니다. 공개 그룹, 개인 네임스페이스, 자체 설치형에는 이 제한이 없습니다. 2026년 1월 27일 이후 만든 무료 계정은 최상위 그룹이 3개까지입니다. 저장공간은 프로젝트당 10GiB, CI 컴퓨트 분은 네임스페이스당 월 400분이며 매월 1일에 초기화되고, 큰 러너일수록 비용계수만큼 빨리 줄어듭니다.