- 모든 네임스페이스에 대한 컴퓨팅 할당량 설정
- 특정 네임스페이스에 대한 컴퓨팅 할당량 설정
- 컴퓨팅 사용량 보기
- 추가 컴퓨팅 분 구매
- 컴퓨팅 사용량이 계산되는 방식
- 할당량 초과 시 동작
- 컴퓨팅 할당량 사용량 줄이기
- 컴퓨팅 사용량 재설정
컴퓨팅 할당량
GitLab 16.1에서 “CI/CD minutes”를 “컴퓨팅 할당량” 또는 “컴퓨팅 분”으로 이름이 변경되었습니다.
CI/CD minutes
용어가 컴퓨팅 분
으로 이름이 변경됩니다. 이 전환 중에 UI 및 문서에서 CI/CD minutes
, CI minutes
, pipeline minutes
, CI pipeline minutes
, pipeline minutes quota
, compute credits
, compute units
, compute minutes
에 대한 참조가 나올 수 있습니다. 자세한 내용은 epic 2150을 참조하세요.관리자는 프로젝트가 월별로 인스턴스 러너에서 실행될 수 있는 시간량을 제한할 수 있습니다. 이 한계는 컴퓨팅 할당량으로 추적됩니다.
기본적으로 단일 작업의 1분 실행 시간당 1분의 컴퓨팅 분을 사용합니다. 파이프라인의 총 실행 시간은 모든 작업의 기간의 합계입니다. 작업은 동시에 실행될 수 있기 때문에 총 사용량은 파이프라인의 종단 지속 시간보다 높을 수 있습니다.
GitLab.com에서:
- 모든 프로젝트에 대해 컴퓨팅 할당량이 활성화되어 있지만 특정 프로젝트는 더 낮은 속도로 컴퓨팅 분을 사용합니다.
- GitLab.com 네임스페이스의 기본 월별 컴퓨팅 할당량은 라이선스 티어에 의해 결정됩니다.
- 월간 할당량보다 더 많은 컴퓨팅 분이 필요한 경우 추가 컴퓨팅 분을 구매할 수 있습니다.
자체 호스팅된 GitLab 인스턴스에서:
- 기본적으로 컴퓨팅 할당량은 비활성화됩니다.
- 활성화된 경우, 컴퓨팅 할당량은 개인 프로젝트에만 적용됩니다.
- 네임스페이스가 월간 할당량을 모두 사용하는 경우, 관리자는 추가 컴퓨팅 분을 할당할 수 있습니다.
트리거 작업은 러너에서 실행되지 않기 때문에 strategy:depend
를 사용하여 다운스트림 파이프라인 상태를 기다리더라도 컴퓨팅 분을 사용하지 않습니다. 트리거된 다운스트림 파이프라인은 다른 파이프라인과 마찬가지로 컴퓨팅 분을 사용합니다.
프로젝트 러너는 컴퓨팅 할당량의 대상이 아닙니다.
모든 네임스페이스에 대한 컴퓨팅 할당량 설정
- GitLab 13.9에서 GitLab Premium으로 이동되었습니다.
기본적으로 GitLab 인스턴스에는 컴퓨팅 할당량이 없습니다.
할당량에 대한 기본값은 무제한인 0
입니다.
그러나 기본값을 변경할 수 있습니다.
전제 조건:
- GitLab 관리자여야 합니다.
모든 네임스페이스에 적용되는 기본 할당량을 변경하려면:
- 왼쪽 사이드바에서 가장 아래에서 관리 영역을 선택합니다.
- 설정 > CI/CD를 선택합니다.
- 지속적 통합 및 배포를 확장합니다.
- 컴퓨팅 할당량 상자에서 제한을 입력합니다.
- 변경 사항 저장을 선택합니다.
이미 특정 네임스페이스에 대한 할당량이 정의된 경우, 이 값은 해당 할당량을 변경하지 않습니다.
특정 네임스페이스에 대한 컴퓨팅 할당량 설정
- GitLab 13.9에서 GitLab Premium으로 이동되었습니다.
전역 값의 설정을 무시하고 특정 네임스페이스에 대한 컴퓨팅 할당량을 설정할 수 있습니다.
전제 조건:
- GitLab 관리자여야 합니다.
네임스페이스에 대한 컴퓨팅 할당량을 설정하려면:
- 왼쪽 사이드바에서 가장 아래에서 관리 영역을 선택합니다.
- 개요 > 그룹을 선택합니다.
- 업데이트하려는 그룹을 선택하여 편집을 선택합니다.
- 컴퓨팅 할당량 상자에 최대 컴퓨팅 분 수를 입력합니다.
- 변경 사항 저장을 선택합니다.
대신 그룹 업데이트 API 또는 사용자 업데이트 API를 사용할 수도 있습니다.
컴퓨팅 사용량 보기
전제 조건:
- 빌드에 대한 전체 사용량 및 네임스페이스에 대한 할당량 요약을 보려면 액세스해야 합니다.
- 사용량 할당량 페이지에 액세스할 수 있는 권한은 연관된 네임스페이스 또는 그룹에서의 역할에 따라 달라집니다.
그룹에 대한 사용량 할당량 보고서 보기
- GitLab 15.0에서 프로젝트별 인스턴스 러너 지속 시간 표시가 도입되었습니다.
전제 조건:
- 그룹의 소유자 역할이어야 합니다.
그룹의 컴퓨팅 사용량을 보려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다. 그룹은 하위 그룹이 아니어야 합니다.
- 설정 > 사용량 할당량을 선택합니다.
- 파이프라인 탭을 선택합니다.
프로젝트 디렉터리에는 현재 월에만 컴퓨팅 사용량 또는 인스턴스 러너 사용량이 있는 프로젝트가 표시됩니다. 디렉터리에는 네임스페이스와 하위 그룹의 모든 프로젝트가 컴퓨팅 사용량 내림차순으로 표시됩니다.
개인 네임스페이스의 사용량 할당량 리포트 보기
- GitLab 15.0에서 도입된 인스턴스 러너 지속 시간 표시 기능.
전제 조건:
- 해당 네임스페이스는 개인 네임스페이스여야 합니다.
개인 네임스페이스의 컴퓨팅 사용량을 확인할 수 있습니다:
- 왼쪽 사이드바에서 아바타를 선택합니다.
- 프로필 편집을 선택합니다.
- 왼쪽 사이드바에서 사용량 할당량을 선택합니다.
프로젝트 디렉터리에는 현재 달에 대한 컴퓨팅 사용 또는 인스턴스 러너 사용이 표시된 개인 프로젝트가 나열됩니다. 디렉터리은 컴퓨팅 사용량의 내림차순으로 정렬됩니다.
추가 컴퓨팅 분 구매
GitLab SaaS를 사용하는 경우 추가 컴퓨팅 분 팩을 구매할 수 있습니다. 추가 컴퓨팅 분은 다음과 같습니다:
- 월 구독에 포함된 월간 할당량이 소진된 후에만 사용됩니다.
- 남아 있는 경우, 다음 달로 이월됩니다.
- 구매 날짜로부터 12개월 동안 유효합니다. 모든 컴퓨팅 분이 사용되거나 유효 기간이 끝나면 만료됩니다.
예를 들어, GitLab SaaS Premium 라이선스를 보유한 경우:
- 월간 컴퓨팅 분이
10,000
입니다. - 추가
5,000
컴퓨팅 분을 구매합니다. - 총 제한은
15,000
컴퓨팅 분입니다.
한 달에 13,000
컴퓨팅 분을 사용하는 경우, 다음 달 추가 컴퓨팅 분은 2,000
이 됩니다. 한 달에 9,000
컴퓨팅 분을 사용하는 경우, 추가 컴퓨팅 분은 동일합니다.
시험 구독으로 구매한 추가 컴퓨팅 분은 시험이 종료된 후 또는 유료 요금제로 업그레이드된 후에 사용할 수 있습니다.
추가 컴퓨팅 분의 가격은 GitLab 가격 페이지에서 확인할 수 있습니다.
그룹을 위한 컴퓨팅 분 구매
전제 조건:
- 그룹의 소유자 역할이어야 합니다.
그룹을 위해 추가 컴퓨팅 분을 구매할 수 있습니다. 구매한 컴퓨팅 분을 다른 그룹으로 이전할 수 없으므로 올바른 그룹을 선택해야 합니다.
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 설정 > 사용량 할당량을 선택합니다.
- 파이프라인을 선택합니다.
- 추가 컴퓨팅 분 구매을 선택합니다.
- 거래 세부 정보를 입력합니다.
결제가 처리된 후, 추가 컴퓨팅 분은 그룹 네임스페이스에 추가됩니다.
개인 네임스페이스를 위한 컴퓨팅 분 구매
전제 조건:
- 해당 네임스페이스는 개인 네임스페이스여야 합니다.
개인 네임스페이스를 위해 추가 컴퓨팅 분을 구매하려면:
- 왼쪽 사이드바에서 아바타를 선택합니다.
- 프로필 편집을 선택합니다.
- 왼쪽 사이드바에서 사용량 할당량을 선택합니다.
- 추가 컴퓨팅 분 구매를 선택합니다. GitLab은 귀하를 Customers Portal로 리디렉션합니다.
- GitLab SaaS의 개인 네임스페이스에 연결된 구독 카드를 찾아 추가 컴퓨팅 분 구매를 선택한 후, 거래 세부 정보를 입력합니다.
결제가 처리된 후, 추가 컴퓨팅 분은 귀하의 개인 네임스페이스에 추가됩니다.
컴퓨팅 사용량이 계산되는 방식
GitLab은 작업의 컴퓨팅 사용량을 계산하기 위해 다음 공식을 사용합니다:
작업 지속 시간 * 비용 계수
-
작업 지속 시간: 인스턴스 러너에서 실행되는 작업이
생성됨
또는보류 중
상태에 소요된 시간은 포함되지 않는 초 단위의 시간입니다. - 비용 계수: 프로젝트 가시성에 기반한 숫자입니다.
이 값은 컴퓨팅 분으로 변환되어, 작업의 최상위 네임스페이스에 사용된 단위 수에 추가됩니다.
예를 들어, 사용자 alice
가 파이프라인을 실행하는 경우:
-
gitlab-org
네임스페이스에서, 파이프라인의 각 작업에 의해 사용된 컴퓨팅 분이alice
네임스페이스가 아닌gitlab-org
네임스페이스의 총 사용량에 추가됩니다. - 사용자의 네임스페이스에 있는 개인 프로젝트 중 하나에 대해서는 컴퓨팅 분이 사용자의 네임스페이스의 총 사용량에 추가됩니다.
한 파이프라인에서 사용되는 컴퓨팅 분은 파이프라인에서 실행된 모든 작업의 총 컴퓨팅 분입니다. 작업은 동시에 실행될 수 있으므로 총 컴퓨팅 사용량은 파이프라인의 종단 간 지속 시간보다 높을 수 있습니다.
비용 계수
GitLab.com에서 인스턴스 러너에서 실행되는 작업에 대한 비용 계수는 다음과 같습니다:
- 내부, 공개 및 비공개 프로젝트의 경우
1
입니다. - 공개 프로젝트의 경우 예외 사항:
-
오픈 소스용 GitLab의 프로젝트는
0.5
입니다. -
오픈 소스용 GitLab의 포크는
0.008
입니다. 작업 실행 시간 125분 당 1컴퓨팅 분을 사용합니다.
-
오픈 소스용 GitLab의 프로젝트는
- GitLab 프로젝트에 대한 커뮤니티 기여에 대한 비용 계수는 동적으로 할인됩니다.
Self-managed 인스턴스의 비용 계수는 다음과 같습니다:
- 공개 프로젝트의 경우
0
이므로 컴퓨팅 분을 사용하지 않습니다. - 내부 및 비공개 프로젝트의 경우
1
입니다.
GitLab 프로젝트에 대한 커뮤니티 기여의 비용 요소
커뮤니티 기여자는 GitLab이 유지보수하는 오픈 소스 프로젝트에 기여할 때 인스턴스 러너에서 최대 300,000분까지 사용할 수 있습니다. 300,000분의 최대값은 GitLab 제품의 일부인 프로젝트에 독점적으로 기여하는 경우에만 가능합니다(제품의 일부인 프로젝트). 인스턴스 러너에서 사용 가능한 총 분 수는 다른 프로젝트의 파이프라인에서 사용된 연산 분에 의해 감소됩니다. 300,000분은 모든 SaaS 티어에 적용되며, 비용 계산은 다음과 같습니다:
월별 연산 할당량 / 300,000 작업 지속 시간 분 = 비용 요소
예를 들어, Premium 티어의 월별 연산 할당량이 10,000인 경우:
- 10,000 / 300,000 = 0.03333333333 비용 요소.
이 줄은 감소된 비용 요소에 해당됩니다:
- Merge Request 소스 프로젝트는
gitlab-com/www-gitlab-com
나gitlab-org/gitlab
와 같이 GitLab이 유지보수하는 프로젝트의 포크여야 합니다. - Merge Request 대상 프로젝트는 해당 포크의 상위 프로젝트여야 합니다.
- 파이프라인은 Merge Request, Merge된 결과 또는 Merge Train 파이프라인이어야 합니다.
GitLab 관리자는 ci_minimal_cost_factor_for_gitlab_namespaces
라는 플래그로 줄어든 비용 요소에 네임스페이스를 추가할 수 있습니다
with a flag.
GitLab SaaS의 추가 비용
GitLab SaaS 러너는 러너 유형(Linux, Windows, macOS) 및 가상 머신 구성에 따라 다른 비용 요소가 있습니다.
GitLab SaaS 러너 유형 | 머신 사이즈 | 비용 요소 |
---|---|---|
Linux OS amd64 | small
| 1 |
Linux OS amd64 | medium
| 2 |
Linux OS amd64 | large
| 3 |
Linux OS amd64 | xlarge
| 6 |
Linux OS amd64 | 2xlarge
| 12 |
Linux OS amd64 + GPU 활성화 |
medium , GPU 표준
| 7 |
macOS M1 | medium
| 6 (Status: Beta) |
Windows Server | - | 1 (Status: Beta) |
월별 연산 사용량 재설정
매 달 1일에 누적된 연산 사용량이 0
으로 재설정되어야 합니다. 이는 인스턴스 러너를 사용하는 모든 네임스페이스에 대해 적용됩니다. 이는 귀하의 전체 할당량을 사용할 수 있음을 의미하며 계산은 다시 0
에서 시작합니다.
예를 들어, 월별 할당량이 10,000
연산 분인 경우:
-
4월 1일에, 연산 분은
10,000
입니다. - 4월 동안,
10,000
연산 분 중6,000
만 사용합니다. -
5월 1일에, 누적된 연산 사용량이
0
으로 재설정되어 5월에 사용할10,000
연산 분이 다시 생깁니다.
이전 달의 사용 데이터는 시간에 따른 소비의 역사적인 관점을 보여주기 위해 유지됩니다.
구매한 연산 분의 월별 이월
추가적인 연산 분을 구매하고 전체 금액을 사용하지 않은 경우, 남은 금액은 다음 달로 이월됩니다.
예를 들어:
-
4월 1일에, 추가
5,000
연산 분을 구매합니다. - 4월에는
5,000
추가 연산 분 중3,000
만 사용합니다. -
5월 1일에, 사용되지 않은 연산 분이 이월되어 5월에 사용할
2,000
추가 연산 분이 생깁니다.
추가 연산 분은 일회성 구매로 매월 갱신되지 않거나 새로 고침되지 않습니다.
할당량 초과 시 동작
연산 할당량이 현재 월에 사용된 경우, GitLab은 새 작업 처리를 중단합니다.
- 인스턴스 러너가 가져와야 하는 중지된 작업이 자동으로 삭제됩니다.
- 다시 시도되는 모든 작업이 자동으로 삭제됩니다.
- 전반적으로 네임스페이스 사용량이 우위 할당량을 초과하는 경우 어느 시점에서든지 실행 중인 작업이 기간 내에 삭제될 수 있습니다.
실행 중인 작업의 유예 기간은 1,000
연산 분입니다.
프로젝트 러너에서의 작업은 연산 할당량에 영향을 받지 않습니다.
GitLab SaaS 사용량 알림
GitLab SaaS에서 네임스페이스 소유자에게 다음과 같은 경우 인앱 배너가 표시되고 이메일 알림이 전송됩니다.
- 남은 연산 분이 할당량의 30% 미만인 경우.
- 남은 연산 분이 할당량의 5% 미만인 경우.
- 모든 연산 할당량이 사용된 경우.
특별 할당량 제한
일부 경우에는 할당량이 다음 레이블 중 하나로 대체됩니다:
- 무제한: 무제한 연산 할당량을 가진 네임스페이스.
- 지원되지 않음: 활성 인스턴스 러너가 활성화되지 않은 네임스페이스를 위해.
컴퓨팅 할당량 사용량 줄이기
프로젝트가 너무 많은 컴퓨팅 할당량을 사용하는 경우 사용량을 줄일 수 있는 몇 가지 전략이 있습니다:
- 프로젝트 미러를 사용하는 경우 미러 업데이트용 파이프라인이 비활성화되어 있는지 확인하세요.
- 예약 된 파이프라인의 빈도를 줄입니다.
- 필요하지 않을 때 파이프라인을 건너뛰세요.
- 새로운 파이프라인이 시작되면 자동으로 취소될 수 있는 중단 가능 작업을 사용하세요.
- 모든 파이프라인에서 실행할 필요가 없는 작업의 경우
rules
를 사용하여 필요할 때만 실행되도록 만드세요. - 일부 작업에 대해 사용자 지정 러너를 사용하세요.
- fork에서 작업하고 부모 프로젝트에 Merge Request을 제출하는 경우 유지자에게 부모 프로젝트에서 파이프라인을 실행하도록 요청할 수 있습니다(부모 프로젝트에서 파이프라인 실행).
오픈 소스 프로젝트를 관리하는 경우, 이러한 개선 사항은 기여자 fork 프로젝트의 컴퓨팅 할당량 소비를 줄여 더 많은 기여를 가능케 합니다.
더 많은 세부 정보는 파이프라인 효율성 가이드를 참조하세요.
컴퓨팅 사용량 재설정
관리자는 현재 달에 대한 네임스페이스의 컴퓨팅 사용량을 재설정할 수 있습니다.
개인 네임스페이스 사용량 재설정
- 관리 영역의 사용자를 찾으세요.
- 편집을 선택하세요.
- 제한 사항에서 컴퓨팅 사용량 재설정을 선택하세요.
그룹 네임스페이스 사용량 재설정
- 관리 영역의 그룹을 찾으세요.
- 편집을 선택하세요.
- 권한 및 그룹 기능에서 컴퓨팅 사용량 재설정을 선택하세요.