• 모든 네임스페이스에 대한 컴퓨트 할당량 설정
• 특정 네임스페이스에 대한 컴퓨트 할당량 설정
• 컴퓨트 사용량 보기
  • 그룹에 대한 사용량 할당량 보고서 보기
  • 개인 네임스페이스용 사용량 할당량 보고서 보기
• 추가 컴퓨팅 분 구매
  • 그룹용 컴퓨팅 분 구매
  • 개인 네임스페이스용 컴퓨팅 분 구매
• 컴퓨팅 사용량 계산 방법
  • 비용 계수
    • GitLab 프로젝트에 대한 커뮤니티 기여의 비용 요인
  • GitLab SaaS의 추가 비용
  • 월별 연산 사용량 재설정
  • 구입된 연산 분의 월별 이월
• 할당량 초과 시 발생하는 일
  • GitLab SaaS 사용 알림
  • 특별한 할당량 한계
• 컴퓨팅 할당량 사용량 줄이기
• 컴퓨팅 사용량 재설정
  • 개인 네임스페이스의 사용량 재설정
  • 그룹 네임스페이스의 사용량 재설정

컴퓨트 할당량

GitLab 16.1에서 “CI/CD 분”을 “컴퓨트 할당량” 또는 “컴퓨트 분”으로 이름이 변경되었습니다.

관리자는 프로젝트가 인스턴스 러너에서 실행 작업을 매월 사용할 수 있는 시간을 제한할 수 있습니다. 이 한도는 컴퓨트 할당량으로 추적됩니다.

기본적으로 단일 작업의 실행 시간 1분당 컴퓨트 분 1개가 사용됩니다. 파이프라인의 총 실행 시간은 모든 작업의 지속 시간 합계입니다. 작업은 동시에 실행될 수 있으므로 총 사용량은 파이프라인의 종단 지속 기간보다 높을 수 있습니다.

GitLab.com에서는:

• 모든 프로젝트에 대해 컴퓨트 할당량이 활성화되지만, 특정 프로젝트는 컴퓨트 분을 느린 속도로 사용합니다.
• GitLab.com 네임스페이스의 기본 월별 컴퓨트 할당량은 해당 라이선스 티어에 따라 결정됩니다.
• 월간 할당량에 비해 더 많은 컴퓨트 분이 필요한 경우, 추가 컴퓨트 분을 구매할 수 있습니다.

자체 관리 GitLab 인스턴스에서는:

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

트리거 작업은 러너에서 실행되지 않으므로 downstream 파이프라인 상태를 기다리기 위해 strategy:depend를 사용하더라도 컴퓨트 분을 사용하지 않습니다. 트리거된 하향 파이프라인은 다른 파이프라인과 마찬가지로 컴퓨트 분을 사용합니다.

프로젝트 러너는 컴퓨트 할당량의 적용 대상이 아닙니다.

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

GitLab Premium에서 13.9으로 이동되었습니다.

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

전제 조건:

• GitLab 관리자여야 합니다.

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

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

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

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

GitLab Premium에서 13.9으로 이동되었습니다.

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

전제 조건:

• GitLab 관리자여야 합니다.

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

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

대신 그룹 업데이트 API 또는 사용자 업데이트 API를 사용할 수도 있습니다.

컴퓨트 사용량 보기

전제 조건:

• 네임스페이스에 연결된 빌드를 보려면 접근 권한이 있어야 합니다.
• Usage Quotas 페이지에 대한 액세스 권한은 관련 네임스페이스 또는 그룹에서의 역할에 따라 달라집니다.

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

프로젝트 러너의 지속 시간 당 프로젝트 도입됨 - GitLab 15.0.

전제 조건:

• 그룹의 소유자 역할이어야 합니다.

그룹의 컴퓨트 사용량을 보려면:

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

프로젝트 목록에는 현재 월에만 컴퓨트 사용 또는 인스턴스 러너 사용이 있는 프로젝트가 표시됩니다. 리스트에는 네임스페이스 및 그의 하위 그룹에 있는 모든 프로젝트가 컴퓨트 사용량의 내림차순으로 표시됩니다.

개인 네임스페이스용 사용량 할당량 보고서 보기

• 인스턴스 러너 지속시간 표시는 GitLab 15.0에서 도입되었습니다.

필수 조건:

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

개인 네임스페이스의 컴퓨팅 사용량을 볼 수 있습니다.

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

프로젝트 목록은 현재 월에 컴퓨팅 사용량 또는 인스턴스 러너 사용량이 있는 개인 프로젝트를 보여줍니다. 목록은 컴퓨팅 사용량의 내림차순으로 정렬됩니다.

추가 컴퓨팅 분 구매

GitLab SaaS를 사용 중이라면, 추가 컴퓨팅 분을 구매할 수 있습니다. 이러한 추가 컴퓨팅 분은:

• 구독에 포함된 월간 할당량이 소진된 후에만 사용됩니다.
• 다음 달로 이월됩니다(월말에 남아있는 경우).
• 구매 후 12개월 이용 가능하며, 모든 컴퓨팅 분이 소진될 때까지 유효합니다. 컴퓨팅 분의 만료는 강제되지 않습니다.

예를 들어, GitLab SaaS 프리미엄 라이선스를 사용하는 경우:

• 월간 컴퓨팅 분이 10,000입니다.
• 추가 5,000 컴퓨팅 분을 구매합니다.
• 총 제한은 15,000 컴퓨팅 분입니다.

한 달에 13,000 컴퓨팅 분을 사용하는 경우, 다음 달 추가 컴퓨팅 분은 2,000이 됩니다. 한 달에 9,000 컴퓨팅 분을 사용하는 경우, 추가 컴퓨팅 분은 유지됩니다.

시험 구독으로 구매한 추가 컴퓨팅 분은 시험이 종료된 후 또는 유료 요금제로 업그레이드한 후에 사용할 수 있습니다.

추가 컴퓨팅 분의 가격은 GitLab 요금 페이지에서 확인할 수 있습니다.

그룹용 컴퓨팅 분 구매

필수 조건:

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

그룹의 추가 컴퓨팅 분을 구매할 수 있습니다. 구매한 컴퓨팅 분을 다른 그룹으로 이전할 수 없으므로 올바른 그룹을 선택하십시오.

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
2. 설정 > 사용 할당량을 선택합니다.
3. 파이프라인을 선택합니다.
4. 추가 컴퓨팅 분 구매를 선택합니다.
5. 거래 세부 정보를 완료합니다.

결제가 처리된 후, 추가 컴퓨팅 분이 그룹 네임스페이스에 추가됩니다.

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

필수 조건:

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

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

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

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

컴퓨팅 사용량 계산 방법

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

작업 지속시간 * 비용 계수

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

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

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

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

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

비용 계수

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

• 내부, 공개 및 비공개 프로젝트의 경우 1입니다.
• 공개 프로젝트의 경우 다음과 같은 예외가 있습니다:
  • 오픈 소스 프로그램용 GitLab의 프로젝트에 대해 0.5입니다.
  • 오픈 소스 프로그램용 GitLab의 프로젝트의 포크에 대해 0.008입니다. 작업 실행 시간이 125분씩 되면 1컴퓨팅 분을 사용합니다.
• GitLab 프로젝트에 대한 커뮤니티 기여의 비용 계수는 동적으로 할인됩니다.

자체 관리형 인스턴스의 비용 계수는 다음과 같습니다:

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

GitLab 프로젝트에 대한 커뮤니티 기여의 비용 요인

GitLab이 유지보수하는 오픈 소스 프로젝트에 기여하는 경우, 커뮤니티 기여자는 인스턴스 러너에서 최대 300,000분까지 사용할 수 있습니다. 300,000분의 최대값은 GitLab 제품의 일부 프로젝트에 독점적으로 기여하는 경우에만 가능합니다. 인스턴스 러너에서 사용 가능한 총 분은 다른 프로젝트의 파이프라인으로부터 사용된 연산 분을 감안하여 줄어듭니다. 300,000분은 모든 SaaS 계층에 적용되며, 비용 계산은 다음과 같습니다:

• 월별 연산 할당량 / 300,000 작업 처리 시간 분 = 비용 요인

예를 들어, 프리미엄 계층의 월별 연산 할당량이 10,000인 경우:

• 10,000 / 300,000 = 0.03333333333 비용 요인.

이러한 감소된 비용 요인의 경우:

• 병합 요청 소스 프로젝트는 gitlab-com/www-gitlab-com나 gitlab-org/gitlab와 같이 GitLab이 유지보수하는 프로젝트의 포크여야 합니다.
• 병합 요청 대상 프로젝트는 포크의 부모 프로젝트여야 합니다.
• 파이프라인은 병합 요청, 병합된 결과, 또는 병합 트레인 파이프라인이어야 합니다.

GitLab 관리자는 ci_minimal_cost_factor_for_gitlab_namespaces라는 플래그로 줄어든 비용 요인에 네임스페이스를 추가할 수 있습니다.

GitLab SaaS의 추가 비용

GitLab SaaS 러너는 러너 유형(Linux, Windows, macOS) 및 가상 머신 구성에 따라 다른 비용 요인을 갖습니다.

월별 연산 사용량 재설정

각 달의 첫 번째 날에 모든 인스턴스 러너를 사용하는 네임스페이스에 대한 누적된 연산 사용량이 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를 사용하여 필요할 때만 실행되도록 만드세요.
• 일부 작업에 대해 개인 러너를 사용하세요.
• 포크에서 작업하고 부모 프로젝트에 병합 요청을 제출하는 경우 유지자에게 부모 프로젝트에서 파이프라인을 실행할 것을 요청할 수 있습니다(merge_request_pipelines.md#run-pipelines-in-the-parent-project).

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

더 많은 세부 정보는 파이프라인 효율성 가이드를 참조하세요.

컴퓨팅 사용량 재설정

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

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

1. 관리자 영역의 사용자에서 사용자를 찾으세요.
2. 수정을 선택하세요.
3. 제한 사항에서 컴퓨팅 사용량 재설정을 선택하세요.

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

1. 관리자 영역의 그룹에서 그룹을 찾으세요.
2. 수정을 선택하세요.
3. 권한 및 그룹 기능에서 컴퓨팅 사용량 재설정을 선택하세요.