컴퓨트 할당량

Tier: Premium, Ultimate Offering: GitLab.com, Self-Managed

- CI/CD minutes를 “compute quota” 또는 “compute minutes”로 GitLab 16.1에서 이름이 변경되었습니다.

note
CI/CD minutes라는 용어는 compute minutes로 변경됩니다. 이 전환 중에 UI 및 문서에서 CI/CD minutes, CI minutes, pipeline minutes, CI pipeline minutes, pipeline minutes quota, compute credits, compute units, compute minutes에 대한 참조가 표시될 수 있습니다. 자세한 정보는 epic 2150을 확인하십시오.

관리자는 인스턴스 실행자가 매월 프로젝트에서 작업을 실행하는 데 사용할 수있는 시간을 제한할 수 있습니다. 이 제한은 compute quota로 추적됩니다.

기본적으로 단일 작업에 대한 1분의 실행 시간은 1 compute minute를 사용합니다. 파이프라인의 총 실행 시간은 모든 작업의 기간의 합계입니다. 작업은 병렬로 실행 될 수 있으므로 총 사용량은 파이프라인의 종단 간 기간보다 높을 수 있습니다.

GitLab.com에서:

Self-Managed형 GitLab 인스턴스에서:

  • 컴퓨트 할당량은 기본적으로 비활성화됩니다.
  • 활성화되면 컴퓨트 할당량은 개인 프로젝트에만 적용됩니다.
  • 네임스페이스가 월간 할당량을 모두 사용하는 경우, 관리자는 추가 컴퓨트 분을 할당할 수 있습니다.

트리거 작업은 실행자에서 실행되지 않으므로 compute minutes를 소비하지 않습니다. 프로젝트 실행자는 컴퓨트 할당량의 대상이 아닙니다.

모든 네임스페이스에 대한 컴퓨트 할당량 설정

- 13.9에서 GitLab Premium으로 이동.

기본적으로 GitLab 인스턴스에는 컴퓨트 할당량이 없습니다. 할당량의 기본 값은 무제한인 0입니다. 그러나 이 기본 값을 변경할 수 있습니다.

전제 조건:

  • GitLab 관리자여야 합니다.

모든 네임스페이스에 적용되는 기본 할당량을 변경하려면:

  1. 왼쪽 사이드바에서 아래쪽에서 관리 영역을 선택합니다.
  2. 설정 > CI/CD를 선택합니다.
  3. Continuous Integration and Deployment를 확장합니다.
  4. Compute quota 상자에 제한을 입력합니다.
  5. 변경 사항 저장을 선택합니다.

특정 네임스페이스에 이미 할당량이 정의 된 경우, 이 값은 해당 할당량을 변경하지 않습니다.

특정 네임스페이스에 대한 컴퓨트 할당량 설정

- 13.9에서 GitLab Premium으로 이동.

전역 값을 무시하고 특정 네임스페이스에 대한 컴퓨트 할당량을 설정할 수 있습니다.

전제 조건:

  • GitLab 관리자여야 합니다.

네임스페이스에 대해 컴퓨트 할당량을 설정하려면:

  1. 왼쪽 사이드바에서 아래쪽에서 관리 영역을 선택합니다.
  2. 개요 > 그룹을 선택합니다.
  3. 업데이트하려는 그룹을 선택합니다.
  4. Compute quota 상자에 최대 컴퓨트 분 수를 입력합니다.
  5. 변경 사항 저장을 선택합니다.

대신 update group API 또는 update user API을 사용할 수도 있습니다.

note
컴퓨트 할당량은 최상위 그룹 또는 사용자 네임스페이스에만 설정할 수 있습니다. 하위 그룹에 할당량을 설정할 수 없습니다.

컴퓨트 사용량 보기

전제 조건:

  • 빌드에 대한 총 사용량과 네임스페이스에 연결된 사용량 할당량 요약을보려면 액세스해야합니다.
  • Usage Quotas 페이지에 대한 액세스는 연결된 네임스페이스 또는 그룹에서의 역할에 따라 달라집니다.

그룹에 대한 사용량 할당량 보기

- GitLab 15.0에서 프로젝트별 인스턴스 실행자 지속 시간 표시가 도입되었습니다.

전제 조건:

  • 그룹에 대한 소유자 역할이 있어야합니다.

그룹에 대한 컴퓨트 사용량을 보려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 그룹은 하위 그룹이 아니어야합니다.
  2. 설정 > Usage Quotas를 선택합니다.
  3. 파이프라인 탭을 선택합니다.

프로젝트 디렉터리은 현재 월에만 네임스페이스 및 하위 그룹의 모든 프로젝트를 컴퓨팅 사용량에 표시합니다. 디렉터리에는 컴퓨트 사용량의 내림차순으로 정렬된 프로젝트가 포함됩니다.

개인 네임스페이스에 대한 사용량 할당량 보기

- GitLab 15.0에서 인스턴스 실행자 지속 시간 표시가 도입되었습니다.

전제 조건:

  • 네임스페이스는 개인 네임스페이스 여야합니다.

개인 네임스페이스에 대한 컴퓨트 사용량을 볼 수 있습니다:

  1. 왼쪽 사이드바에서 아바타를 선택합니다.
  2. 프로필 편집을 선택합니다.
  3. 왼쪽 사이드바에서 Usage Quotas를 선택합니다.

프로젝트 디렉터리은 현재 월에만 개인 프로젝트의 컴퓨트 사용량이나 인스턴스 실행자 사용량을 표시합니다. 디렉터리은 컴퓨트 사용량의 내림차순으로 정렬됩니다.

추가 컴퓨트 분 구매

Tier: Free, Premium, Ultimate Offering: GitLab.com

GitLab.com을 사용하는 경우 추가 컴퓨트 분을 구매할 수 있습니다. 이 추가 컴퓨트 분은 다음을 포함합니다:

  • 구독에 포함 된 월간 할당량이 소진 된 후에만 사용됩니다.
  • 남은 경우 다음 달로 이월됩니다.
  • 구입 날짜로부터 12 개월 또는 모든 컴퓨트 분이 사용될 때까지 유효합니다. 컴퓨트 분의 만료는 강제되지 않습니다.

예를들어, GitLab.com Premium 라이선스로:

  • 월간 컴퓨트 할당량은 10,000 컴퓨트 분입니다.
  • 추가 5,000 컴퓨트 분을 구입합니다.
  • 총 한도는 15,000 컴퓨트 분입니다.

한 달에 13,000 컴퓨트 분을 사용하면 다음 달 추가 컴퓨트 분이 2,000개가 됩니다. 한 달에 9,000 컴퓨트 분을 사용하면 추가 컴퓨트 분은 동일하게 유지됩니다.

체험 구독에서 구매한 추가 컴퓨트 분은 체험 기간이 종료되거나 유료 요금제로 업그레이드한 후 사용할 수 있습니다.

추가 컴퓨트 분 요금은 GitLab Pricing page에서 확인할 수 있습니다.

그룹을 위한 컴퓨트 분 구매

Tier: Free, Premium, Ultimate Offering: GitLab.com

전제 조건:

  • 그룹에 대한 소유자 역할이 있어야합니다.

그룹을 위해 추가 컴퓨트 분을 구매할 수 있습니다. 구입한 컴퓨트 분을 다른 그룹으로 이전할 수 없으므로 올바른 그룹을 선택해야합니다.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > Usage Quotas를 선택합니다.
  3. 파이프라인을 선택합니다.
  4. 추가 컴퓨트 분 구매를 선택합니다.
  5. 거래의 세부 정보를 입력합니다.

결제가 처리되면 추가 컴퓨트 분이 그룹 네임스페이스에 추가됩니다.

개인 네임스페이스용 컴퓨팅 분에 대한 구매

Tier: Free, Premium, Ultimate Offering: GitLab.com

필수조건:

  • 네임스페이스는 개인 네임스페이스여어야 합니다.

개인 네임스페이스용 추가 컴퓨팅 분을 구매하려면:

  1. 왼쪽 사이드바에서 아바타를 선택하세요.
  2. 프로필 편집을 선택하세요.
  3. 왼쪽 사이드바에서 사용량 할당을 선택하세요.
  4. 추가 컴퓨팅 분 구매를 선택하세요. GitLab은 고객 포털로 리디렉션됩니다.
  5. GitLab.com의 개인 네임스페이스에 연결된 구독 카드를 찾아 추가 컴퓨팅 분 구매를 선택하고, 거래의 세부 정보를 완료하세요.

결제가 처리되면, 추가 컴퓨팅 분이 개인 네임스페이스에 추가됩니다.

컴퓨팅 사용량 계산 방법

GitLab은 작업의 컴퓨팅 사용량을 계산하기 위해 이 공식을 사용합니다:

작업 기간 * 비용 계수
  • 작업 기간: 인스턴스 러너에서 실행된 작업의 초당 시간으로, created 또는 pending 상태에서 보낸 시간은 포함되지 않습니다.
  • 비용 계수: 프로젝트 가시성을 기반으로 한 숫자입니다.

이 값은 컴퓨팅 분으로 변환되어 작업의 최상위 네임스페이스의 사용된 단위 수에 추가됩니다.

예를 들어, 사용자 alice가 파이프라인을 실행하는 경우:

  • gitlab-org 네임스페이스에서 파이프라인의 각 작업에 사용된 컴퓨팅 분이 gitlab-org 네임스페이스의 전체 사용량에 추가되며, alice 네임스페이스에는 추가되지 않습니다.
  • 자신의 네임스페이스의 개인 프로젝트 중 하나의 경우, 컴퓨팅 분이 alice 네임스페이스의 전체 사용량에 추가됩니다.

파이프라인에서 사용된 컴퓨팅은 파이프라인에서 실행된 모든 작업의 총 컴퓨팅 분입니다. 작업은 동시에 실행될 수 있기 때문에 총 컴퓨팅 사용량은 파이프라인의 종단 간 시간보다 높을 수 있습니다.

비용 계수

GitLab.com의 인스턴스 러너에서 실행되는 작업의 비용 계수는 다음과 같습니다:

Self-Managed형되는 인스턴스의 비용 요소는 다음과 같습니다:

  • 공개 프로젝트인 경우 0으로 컴퓨팅 분을 사용하지 않습니다.
  • 내부 및 비공개 프로젝트인 경우 1입니다.

GitLab 호스팅 러너 비용

GitLab 호스팅 러너에는 러너 유형(Linux, Windows, macOS) 및 가상 머신 구성에 따라 다양한 비용 요소가 있습니다.

GitLab 호스팅 러너 유형 머신 크기 비용 요소
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 standard 7
Linux arm64 medium 2
Linux arm64 large 3
macOS M1 medium 6 (상태: 베타)
Windows Server - 1 (상태: 베타)

컴퓨팅 사용량의 월 별 재설정

매 달 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은 새로운 작업을 처리하지 않습니다.

  • 인스턴스 러너가 가져와야 하는 비동작 중인 작업은 자동으로 삭제됩니다.
  • 다시 시도 중인 작업은 자동으로 삭제됩니다.
  • 어떤 작업이든, 실행 중인 경우에는 언제든지 해당 전체 네임스페이스의 사용량이 유예 기간에 의해 할당량을 초과할 수 있습니다.

실행 중인 프로젝트 러너의 작업은 컴퓨팅 할당량에 영향을 받지 않습니다.

GitLab.com 사용량 알림

GitLab.com에서는 앱 내 배너와 네임스페이스 소유자에게 이메일 알림을 전송하여:

  • 남은 컴퓨팅 분이 할당량의 30% 아래입니다.
  • 남은 컴퓨팅 분이 할당량의 5% 아래입니다.
  • 모든 컴퓨팅 할당량을 사용했을 때.

특수 할당량 제한

어떤 경우에는 할당량 제한이 다음 레이블 중 하나로 대체됩니다:

  • 무제한: 무제한 컴퓨팅 할당량 네임스페이스용.
  • 지원되지 않음: 활성 인스턴스 러너가 사용되지 않는 네임스페이스의 경우.

컴퓨팅 할당량 사용량 줄이기

프로젝트가 너무 많은 컴퓨팅 할당량을 사용하는 경우, 사용량을 줄이기 위해 몇 가지 전략을 사용할 수 있습니다:

오픈 소스 프로젝트를 관리하는 경우, 이러한 개선 사항은 기여자 fork 프로젝트의 컴퓨팅 할당량 소비를 줄여 더 많은 기여를 가능하게 할 수 있습니다.

자세한 내용은 파이프라인 효율성 가이드를 참조하세요.

컴퓨팅 사용량 재설정

Tier: Premium, Ultimate Offering: Self-Managed, GitLab Dedicated

관리자는 현재 월에 대해 해당하는 네임스페이스의 컴퓨팅 사용량을 재설정할 수 있습니다.

개인 네임스페이스의 사용량 재설정

  1. 관리자 영역에서 사용자를 찾습니다.
  2. 편집을 선택합니다.
  3. 제한에서 컴퓨팅 사용량 재설정을 선택합니다.

그룹 네임스페이스의 사용량 재설정

  1. 관리자 영역에서 그룹을 찾습니다.
  2. 편집을 선택합니다.
  3. 권한 및 그룹 기능에서 컴퓨팅 사용량 재설정을 선택합니다.