CI/CD 제한
GitLab v19.6요약
CI/CD 관련 인스턴스 제한 중 다수는 Admin 영역에서 관리할 수 있습니다. GitLab.com은 GitLab Self-Managed의 기본값과 다른 값을 사용할 수 있습니다. 인스턴스 설정에서 정의할 수 있는 CI/CD 변수의 개수에는 제한이 있습니다.
CI/CD 관련 인스턴스 제한 중 다수는 Admin 영역에서 관리할 수 있습니다. 나머지 제한은 GitLab Rails 콘솔로 인스턴스 구성을 수정해야만 변경할 수 있습니다.
GitLab.com은 GitLab Self-Managed의 기본값과 다른 값을 사용할 수 있습니다. GitLab.com의 CI/CD 제한 및 설정을 확인합니다.
인스턴스 CI/CD 변수 제한#
히스토리
- GitLab 17.1에서 도입되었습니다.
인스턴스 설정에서 정의할 수 있는 CI/CD 변수의 개수에는 제한이 있습니다. 이 제한은 새 변수를 만들 때마다 확인됩니다. 새 변수로 인해 변수 총개수가 제한을 초과하게 되면 새 변수는 생성되지 않습니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum number of Instance-level CI/CD variables that can be defined의 값을 설정합니다.
기본값은
25입니다. - Save changes를 선택합니다.
dotenv 파일 크기 제한#
히스토리
- GitLab 17.1에서 도입되었습니다.
dotenv 아티팩트의 최대 크기에 제한을 설정할 수 있습니다. 이 제한은 dotenv 파일이 아티팩트로 내보내질 때마다 확인됩니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum size of a dotenv artifact in bytes의 값을 설정합니다.
- Save changes를 선택합니다.
제한을 0으로 설정하면 비활성화됩니다. 기본값은 5 KB입니다.
dotenv 변수 제한#
히스토리
- GitLab 17.1에서 도입되었습니다.
dotenv 아티팩트 안에 들어가는 변수의 최대 개수에 제한을 설정할 수 있습니다. 이 제한은 dotenv 파일이 아티팩트로 내보내질 때마다 확인됩니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum number of variables in a dotenv artifact의 값을 설정합니다.
- Save changes를 선택합니다.
제한을 0으로 설정하면 비활성화됩니다. 기본값은 20입니다.
Plan limits API로도 이 제한을 설정할 수 있습니다.
파이프라인 변수 제한#
히스토리
- GitLab 19.6에서 도입되었습니다.
파이프라인의 파이프라인 변수 개수를 제한할 수 있습니다. 이 제한은 파이프라인이 생성될 때마다 확인됩니다.
각 값의 크기는 CI/CD 변수 값 제한으로 제한됩니다.
개수 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum number of pipeline variables in a single pipeline의 값을 설정합니다.
- Save changes를 선택합니다.
이 제한은 기본적으로 설정되어 있지 않습니다. 비활성화하려면 0으로 설정합니다.
Plan limits API로도 이 제한을 설정할 수 있습니다.
CI/CD 변수 값 제한#
히스토리
- GitLab 19.6에서 도입되었습니다.
CI/CD 변수 값의 크기를 제한할 수 있습니다. 이 제한은 모든 종류의 CI/CD 변수가 공유합니다. 파일 유형 값은 환경이 아닌 파일에 기록되므로 별도의 제한이 있습니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 다음 중 하나의 값을 설정합니다.
- Maximum size of a CI/CD variable value in bytes.
- Maximum size of a file type CI/CD variable value in bytes.
- Save changes를 선택합니다.
이 제한은 기본적으로 설정되어 있지 않습니다. 비활성화하려면 제한을 0으로 설정합니다.
Plan limits API로도 이 제한을 설정할 수 있습니다.
CycloneDX 아티팩트 크기 제한#
히스토리
- GitLab 19.3에서 도입되었습니다.
CycloneDX SBOM 아티팩트의 최대 크기에 제한을 설정할 수 있습니다. 이 제한은 CycloneDX 리포트가 아티팩트로 업로드될 때마다 확인됩니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum size of a CycloneDX artifact in MB의 값을 설정합니다.
- Save changes를 선택합니다.
제한을 0으로 설정하면 대신 최대 아티팩트 크기가 적용됩니다.
기본값은 1 MB입니다.
파이프라인의 최대 job 수#
히스토리
- 17.6에서 설정이 GitLab Enterprise Edition에서 GitLab Community Edition으로 이동되었습니다.
파이프라인의 최대 job 수를 제한할 수 있습니다. 파이프라인의
job 수는 파이프라인 생성 시점과 새 커밋 상태가 생성될 때 확인됩니다.
job이 너무 많은 파이프라인은 size_limit_exceeded 오류와 함께 실패합니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum number of jobs in a single pipeline의 값을 설정합니다.
- Save changes를 선택합니다.
제한을 0으로 설정하면 비활성화됩니다. 기본적으로 비활성화되어 있습니다.
활성 파이프라인의 job 수#
활성 파이프라인의 총 job 수는 프로젝트별로 제한할 수 있습니다. 이 제한은 새 파이프라인이 생성될 때마다 확인됩니다. 활성 파이프라인은 다음 상태 중 하나에 있는 파이프라인입니다:
createdpendingrunning
새 파이프라인으로 인해 총 job 수가 제한을 초과하게 되면 해당 파이프라인은
job_activity_limit_exceeded 오류와 함께 실패합니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Total number of jobs in currently active pipelines의 값을 설정합니다.
- Save changes를 선택합니다.
제한을 0으로 설정하면 비활성화됩니다. 기본적으로 비활성화되어 있습니다.
프로젝트에 대한 CI/CD 구독 수#
총 구독 수는 프로젝트별로 제한할 수 있습니다. 이 제한은 새 구독이 생성될 때마다 확인됩니다.
새 구독으로 인해 총 구독 수가 제한을 초과하게 되면 해당 구독은 유효하지 않은 것으로 간주됩니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum number of pipeline subscriptions to and from a project의 값을 설정합니다.
- Save changes를 선택합니다.
기본적으로 구독은 2개로 제한됩니다. 제한을 0으로 설정하면 비활성화됩니다.
파이프라인 스케줄 수#
총 파이프라인 스케줄 수는 프로젝트별로 제한할 수 있습니다. 이 제한은 새 파이프라인 스케줄이 생성될 때마다 확인됩니다. 새 파이프라인 스케줄로 인해 총 파이프라인 스케줄 수가 제한을 초과하게 되면 해당 파이프라인 스케줄은 생성되지 않습니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum number of pipeline schedules의 값을 설정합니다.
- Save changes를 선택합니다.
기본적으로 파이프라인 스케줄은 10개로 제한됩니다.
Plan Limits API를 사용할 수도 있습니다.
최대 needs 의존성 수#
단일 job이 가질 수 있는 needs 의존성의 최대 개수를 설정할 수 있습니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum number of needs dependencies that a job can have의 값을 설정합니다
- Save changes를 선택합니다.
이 제한은 비활성화할 수 없습니다. 기본값은 50입니다.
0으로 설정하면 모든 needs 의존성이 차단됩니다. 그러면 needs를 사용하도록 구성된 job이 있는
파이프라인은 job can only need 0 others 오류를 반환합니다.
job 변수 제한#
히스토리
- GitLab 19.6에서 도입되었습니다.
job의 job 변수 개수를 제한할 수 있습니다. 이 제한은 사용자가 변수가 있는 수동 job을 실행하거나 재시도할 때마다 확인됩니다.
각 값의 크기는 CI/CD 변수 값 제한으로 제한됩니다.
개수 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum number of job variables in a single job의 값을 설정합니다.
- Save changes를 선택합니다.
이 제한은 기본적으로 설정되어 있지 않습니다. 비활성화하려면 0으로 설정합니다.
Plan limits API로도 이 제한을 설정할 수 있습니다.
그룹 및 프로젝트에 등록된 러너 수#
히스토리
- GitLab 17.1에서 러너가 오래된 것으로 처리되는 타임아웃이 3개월에서 7일로 변경되었습니다.
등록된 러너의 총개수는 그룹과 프로젝트에 대해 제한됩니다. 새 러너가 등록될 때마다 GitLab은 지난 7일 동안 생성되었거나 활성 상태였던 러너를 기준으로 이 제한을 확인합니다. 러너 등록 토큰으로 결정되는 범위의 제한을 초과하면 러너 등록이 실패합니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 다음 중 하나의 값을 설정합니다:
- Maximum number of runners created or active in a group during the past seven days
- Maximum number of runners created or active in a project during the past seven days
- Save changes를 선택합니다.
제한을 0으로 설정하면 비활성화됩니다.
파이프라인 계층 크기 제한#
기본적으로 파이프라인 계층에는 최대 1000개의 다운스트림 파이프라인을 포함할 수 있습니다.
이 제한을 초과하면 파이프라인 생성이 downstream pipeline tree is too large 오류와 함께 실패합니다.
이 제한을 늘리는 것은 권장되지 않습니다. 기본 제한은 과도한 리소스 소비, 파이프라인 재귀 가능성, 데이터베이스 과부하로부터 GitLab 인스턴스를 보호합니다.
제한을 늘리는 대신, 큰 파이프라인 계층을 더 작은 파이프라인으로 나누어 CI/CD 구성을 재구성합니다.
단일 파이프라인 안에서 job 간 needs나 의존 관계가 있는 stage를 사용하는 방안을 고려합니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum number of downstream pipelines in a pipeline's hierarchy tree의 값을 설정합니다.
- Save changes를 선택합니다.
Plan Limits API를 사용할 수도 있습니다.
머지 트레인 병렬 파이프라인 제한#
히스토리
- GitLab 19.0에서 도입되었습니다.
기본적으로 각 머지 트레인은 최대 20개의 파이프라인을 병렬로 실행할 수 있습니다. 이 제한에 도달하면 파이프라인 슬롯이 확보될 때까지 추가 머지 리퀘스트가 큐에 대기합니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- CI/CD limits에서 Maximum parallel pipelines per merge train의 값을 설정합니다.
최솟값은
1입니다.1로 설정하면 병렬 처리 없이 머지 리퀘스트를 순차적으로 처리합니다. - Save changes를 선택합니다.
Plan Limits API를 사용할 수도 있습니다.
특정 프로젝트에는 다른 값을 설정할 수 있습니다.
job의 최대 실행 시간#
job의 기본 최대 실행 시간은 60분입니다. 60분을 넘겨 실행되는 job은 타임아웃됩니다.
job이 타임아웃되기 전까지 실행될 수 있는 최대 시간은 변경할 수 있습니다:
- 프로젝트 단위로는 해당 프로젝트의 프로젝트 CI/CD 설정에서 설정합니다. 이 제한은 10분에서 1개월 사이여야 합니다.
- 러너 단위로 설정합니다. 이 제한은 10분 이상이어야 합니다.
구성된 타임아웃 제한과 관계없이, GitLab은 60분 동안 비활성 상태였던 job을 모두 종료합니다. 비활성 job은 새 로그나 trace 갱신을 생성하지 않은 job입니다.
Git 푸시당 파이프라인 수#
히스토리
- GitLab 18.0에서 도입되었습니다.
이 제한을 늘리는 것은 권장되지 않습니다. 많은 변경 사항을 동시에 푸시하면 GitLab 인스턴스에 과도한 부하가 발생하고 파이프라인이 폭주할 수 있습니다.
여러 태그나 브랜치처럼 하나의 Git 푸시로 여러 변경 사항을 푸시할 때는
기본적으로 태그 또는 브랜치 파이프라인이 네 개까지만 트리거될 수 있습니다. 이 제한은 git push --all이나
git push --mirror를 사용할 때 많은 수의 파이프라인이 실수로 생성되는 것을 방지합니다.
머지 리퀘스트 파이프라인에도 제한이 적용됩니다. Git 푸시가 여러 머지 리퀘스트를 동시에 갱신하면, 제한에 도달하기 전까지 갱신된 머지 리퀘스트마다 머지 리퀘스트 파이프라인이 트리거될 수 있습니다.
GitLab Self-Managed와 GitLab.com의 기본값은 4입니다.
GitLab Self-Managed 인스턴스에서 이 제한을 변경하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Pipeline limit per Git push의 값을 변경합니다.
- Save changes를 선택합니다.
파이프라인 생성 속도 제한#
히스토리
- GitLab 15.0에서
ci_enforce_throttle_pipelines_creation이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. GitLab.com에서는 활성화되어 있습니다 - 18.3에서 기본적으로 활성화되었습니다.
- GitLab 19.2에서 CI Lint 속도 제한이
ci_enforce_ci_lint_rate_limit이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 19.5에서 모든 인스턴스의
ci_lint_limit_per_user가0으로 초기화되었습니다. - GitLab 19.6에서 CI Lint 속도 제한이 일반 공급되었습니다. 기능 플래그
ci_enforce_ci_lint_rate_limit가 제거되었습니다.
사용자와 프로세스가 분당 일정 개수를 넘는 파이프라인을 요청할 수 없도록 제한을 설정할 수 있습니다. 이러한 제한은 리소스를 절약하고 안정성을 높이는 데 도움이 됩니다. 각 제한은 1분 후에 초기화됩니다.
이 절에서 GitLab이 적용하는 속도 제한은 다음과 같습니다:
- 프로젝트, 커밋, 사용자 단위: 프로젝트, 커밋 SHA, 사용자의 같은 조합으로
생성되는 파이프라인을 제한합니다. 기본값은
0(제한 없음)입니다. - 사용자 단위: 한 사용자가 모든 프로젝트에서 생성한 총 파이프라인을 제한합니다. 기본값은
0(제한 없음)입니다. - CI lint 요청의 사용자 단위: 한 사용자가 모든 프로젝트에서 보낸 CI lint 요청을 제한합니다. CI lint 요청은 파이프라인 생성 제한에 포함되지 않지만, 파이프라인을 시뮬레이션하는 요청은 두 제한에 모두 포함됩니다.
기본적으로 ci_lint_limit_per_user는 0(제한 없음)으로 설정됩니다.
GitLab 19.5로 업그레이드하면 관리자가 이전에 제한을 설정했더라도 모든 인스턴스에서 이 값이 0으로 초기화됩니다.
CI lint 요청을 제한하려면 업그레이드한 후에 값을 다시 설정합니다.
예를 들어 사용자별 제한을 100으로 설정했고 한 사용자가 1분 안에 여러 프로젝트에 걸쳐
트리거 API로 파이프라인 생성 요청을 101건 보내면,
101번째 요청이 차단됩니다. 엔드포인트 접근은 1분 후에 다시 허용됩니다.
이 제한은 IP 주소별로 적용되지 않습니다.
제한을 초과하는 요청은 application_json.log 파일에 기록됩니다.
파이프라인 요청 제한 설정#
사전 요구 사항:
- 관리자 액세스 권한이 있어야 합니다.
파이프라인 요청 수를 제한하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Network를 선택합니다.
- Pipeline creation rate limits를 확장합니다.
- Max requests per minute per project, user, and commit에서 같은 프로젝트, 커밋, 사용자 조합의
파이프라인을 제한하려면
0보다 큰 값을 입력합니다. 분당 요청을 무제한으로 두려면0으로 설정합니다. - Max requests per minute per user에서 각 사용자가 생성하는 총 파이프라인을 제한하려면
0보다 큰 값을 입력합니다. 분당 요청을 무제한으로 두려면0으로 설정합니다. - Maximum number of CI Lint requests for a user에서 각 사용자가 보내는 CI lint 요청을
제한하려면
0보다 큰 값을 입력합니다. 분당 요청을 무제한으로 두려면0으로 설정합니다.
- Max requests per minute per project, user, and commit에서 같은 프로젝트, 커밋, 사용자 조합의
파이프라인을 제한하려면
- Save changes를 선택합니다.
속도 제한은 각각 독립적으로 평가됩니다:
- 한 프로젝트에서 같은 커밋 SHA에 대해 파이프라인을 여러 개 생성하는 사용자는 프로젝트, 사용자, 커밋 단위 제한의 적용을 받습니다.
- 서로 다른 프로젝트나 커밋에 걸쳐 파이프라인을 생성하는 사용자는 사용자 단위 제한의 적용을 받습니다.
- 여러 프로젝트에 걸쳐 CI lint 요청을 보내는 사용자는 CI lint 요청의 사용자 단위 제한의 적용을 받습니다.
- 제한을 초과하면 요청이 차단됩니다.
다운스트림 파이프라인 트리거 속도 제한#
하나의 소스에서 분당 트리거할 수 있는 다운스트림 파이프라인 개수를 제한합니다.
최대 다운스트림 파이프라인 트리거 속도는 특정 프로젝트, 사용자, 커밋 조합에 대해
분당 트리거할 수 있는 다운스트림 파이프라인 개수를 제한합니다.
기본값은 0이며, 이는 제한이 없다는 뜻입니다.
이 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum downstream pipeline trigger rate의 값을 설정합니다.
- Save changes를 선택합니다.
파이프라인 취소 속도 제한#
히스토리
- GitLab 19.5에서 도입되었습니다.
파이프라인을 취소하면 파이프라인 계층에 있는 취소 가능한 모든 job이 중지되므로, 취소 비용은 파이프라인 크기에 비례해 커집니다. 큰 파이프라인 하나에서든 프로젝트의 여러 파이프라인에 걸쳐서든 취소가 반복되면 인스턴스에 과도한 부하가 쌓일 수 있습니다. 이를 방지하기 위해 파이프라인을 취소할 수 있는 빈도를 제한할 수 있습니다.
이 속도 제한은 파이프라인 취소 REST API,
pipelineCancel GraphQL 뮤테이션 또는 GitLab UI로 수행한
파이프라인 취소에 적용됩니다.
이 제한은 자동 취소(예: auto_cancel_on_job_failure)에는 적용되지 않습니다.
GitLab은 다음 제한을 적용합니다.
- 사용자 및 파이프라인 단위: 분당
5개 요청으로 고정되어 있습니다. 이 제한은 구성할 수 없으며 항상 적용됩니다. - 사용자 및 프로젝트 단위: 구성할 수 있으며 기본값은 분당
120개 요청입니다. 이 프로젝트별 제한을 사용하지 않으려면0으로 설정합니다. 사용자 및 파이프라인 단위 제한은 계속 적용됩니다.
두 제한 중 하나라도 초과하면 취소 요청이 차단됩니다.
사용자 및 프로젝트 단위 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum pipeline cancellations per project의 값을 설정합니다.
- Save changes를 선택합니다.
파이프라인 재시도 속도 제한#
히스토리
- GitLab 19.5에서
rate_limit_pipeline_retry라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 19.6에서 일반 공급되었습니다. 기능 플래그
rate_limit_pipeline_retry가 제거되었습니다.
파이프라인을 재시도하면 재시도 가능한 모든 job이 복제되므로 재시도 비용은 파이프라인 크기에 비례해 커집니다. 큰 파이프라인 하나에서든 프로젝트의 여러 파이프라인에 걸쳐서든 재시도가 반복되면 인스턴스에 과도한 부하가 쌓일 수 있습니다. 이를 방지하기 위해 파이프라인을 재시도할 수 있는 빈도를 제한할 수 있습니다.
이 속도 제한은 파이프라인 재시도 REST API,
pipelineRetry GraphQL 뮤테이션 또는 GitLab UI로 수행한
파이프라인 재시도에 적용됩니다.
이 제한은 다른 코드 경로를 사용하는 retry 키워드로 트리거되는
자동 job 재시도에는 적용되지 않습니다.
GitLab은 다음 제한을 적용합니다.
- 사용자 및 파이프라인 단위: 분당
5개 요청으로 고정되어 있습니다. 이 제한은 구성할 수 없으며 항상 적용됩니다. - 사용자 및 프로젝트 단위: 구성할 수 있으며 기본값은 분당
200개 요청입니다. 이 프로젝트별 제한을 사용하지 않으려면0으로 설정합니다. 사용자 및 파이프라인 단위 제한은 계속 적용됩니다.
두 제한 중 하나라도 초과하면 재시도 요청이 차단됩니다.
사용자 및 프로젝트 단위 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum pipeline retries per project의 값을 설정합니다.
- Save changes를 선택합니다.
파이프라인 스케줄 관리 속도 제한#
히스토리
- GitLab 19.6에서
rate_limit_pipeline_schedule_management라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
이 기능의 제공 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
파이프라인 스케줄을 생성, 업데이트, 삭제하거나 소유권을 가져오면 프로젝트에 쓰기가 발생하고 스케줄의 다음 실행 시점이 다시 계산됩니다. 한 사용자가 변경을 반복하면 인스턴스에 과도한 부하가 쌓일 수 있습니다. 이를 방지하기 위해 사용자가 파이프라인 스케줄을 변경할 수 있는 빈도를 제한할 수 있습니다.
이 속도 제한은 파이프라인 스케줄 REST API,
pipelineScheduleCreate, pipelineScheduleUpdate, pipelineScheduleDelete,
pipelineScheduleTakeOwnership GraphQL 뮤테이션 또는 GitLab UI로 수행한 변경에 적용됩니다.
네 가지 동작 모두 같은 제한에 포함됩니다.
스케줄을 수동으로 실행하는 것은 별도로 제한됩니다.
GitLab은 사용자별로 모든 프로젝트에 걸쳐 분당 변경 횟수를 제한하며, 이 횟수는 구성할 수 있고
기본값은 300입니다. 이러한 변경에 대한 속도 제한을 사용하지 않으려면 0으로 설정합니다.
사용자가 제한을 초과하면 GitLab은 변경을 차단합니다.
제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum pipeline schedule changes per user의 값을 설정합니다.
- Save changes를 선택합니다.
파이프라인 트리거 토큰 관리 속도 제한#
히스토리
- GitLab 19.6에서
rate_limit_pipeline_trigger_management라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
이 기능의 제공 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
파이프라인 트리거 토큰을 생성, 업데이트, 삭제하면 프로젝트에 쓰기가 발생하며, 새 토큰의 경우 시크릿을 생성하고 저장합니다. 한 사용자가 변경을 반복하면 인스턴스에 과도한 부하가 쌓일 수 있습니다. 이를 방지하기 위해 사용자가 파이프라인 트리거 토큰을 변경할 수 있는 빈도를 제한할 수 있습니다.
이 속도 제한은 파이프라인 트리거 토큰 REST API,
pipelineTriggerCreate, pipelineTriggerUpdate, pipelineTriggerDelete GraphQL 뮤테이션
또는 GitLab UI로 수행한 변경에 적용됩니다.
세 가지 동작 모두 같은 제한에 포함됩니다. 토큰으로
파이프라인을 트리거하는 것은 대신
파이프라인 생성 속도 제한에 포함됩니다.
GitLab은 사용자별로 모든 프로젝트에 걸쳐 분당 변경 횟수를 제한하며, 이 횟수는 구성할 수 있고
기본값은 300입니다. 이러한 변경에 대한 속도 제한을 사용하지 않으려면 0으로 설정합니다.
사용자가 제한을 초과하면 GitLab은 변경을 차단합니다.
제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum pipeline trigger token changes per user의 값을 설정합니다.
- Save changes를 선택합니다.
job 재시도 및 수동 job 실행 속도 제한#
히스토리
- GitLab 19.5에서
rate_limit_job_retry와rate_limit_job_play라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 19.6에서 일반 공급되었습니다. 기능 플래그
rate_limit_job_retry와rate_limit_job_play가 제거되었습니다.
job을 재시도하거나 수동 job을 실행하면 새 job이 생성되고 파이프라인이 다시 평가되므로, 요청이 반복되면 인스턴스에 상당한 부하가 쌓입니다. 이를 방지하기 위해 job을 재시도하거나 실행할 수 있는 빈도를 제한할 수 있습니다.
이 속도 제한은 job 재시도 및 job 실행 REST API 엔드포인트,
jobRetry 및
jobPlay GraphQL 뮤테이션 또는 GitLab UI로 수행한
job 재시도와 수동 job 실행에 적용됩니다.
이 제한은 자동 재시도(예: CI/CD 구성의 retry:)나 자동 롤백에는 적용되지 않습니다.
GitLab은 다음 제한을 적용합니다.
- job 재시도, 사용자 및 job 단위: 분당
3개 요청으로 고정되어 있습니다. 구성할 수 없습니다. - job 재시도, 사용자 및 프로젝트 단위: 구성할 수 있으며 기본값은 분당
320개 요청입니다. 사용하지 않으려면0으로 설정합니다. - 수동 job 실행, 사용자 및 job 단위: 분당
3개 요청으로 고정되어 있습니다. 구성할 수 없습니다. - 수동 job 실행, 사용자 및 프로젝트 단위: 구성할 수 있으며 기본값은 분당
200개 요청입니다. 사용하지 않으려면0으로 설정합니다.
제한을 초과하면 요청이 차단됩니다.
사용자 및 프로젝트 단위 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum job retries per project와 Maximum manual job runs per project의 값을 설정합니다.
- Save changes를 선택합니다.
파이프라인 삭제 속도 제한#
히스토리
- GitLab 19.5에서
rate_limit_pipeline_delete라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 19.6에서 일반 공급되었습니다. 기능 플래그
rate_limit_pipeline_delete가 제거되었습니다.
파이프라인을 삭제하면 레코드가 제거되기 전에 파이프라인 트리의 모든 job이 취소되므로 작업량은 파이프라인 크기에 비례해 커집니다. 인스턴스를 과도한 부하로부터 보호하기 위해 사용자가 파이프라인을 삭제할 수 있는 빈도를 제한할 수 있습니다. 각 제한은 1분 후에 초기화됩니다.
이 속도 제한은 사용자가 파이프라인 삭제 REST API,
pipelineDestroy GraphQL 뮤테이션 또는 GitLab UI로
파이프라인을 삭제할 때 적용됩니다. 자동 정리, 프로젝트 삭제, 이슈 삭제로
제거되는 파이프라인에는 다른 코드 경로를 사용하므로 적용되지 않습니다.
GitLab은 다음 제한을 적용합니다.
- 사용자 및 파이프라인 단위: 분당
5개 요청으로 고정되어 있습니다. 이 제한은 구성할 수 없으며 항상 적용됩니다. - 사용자 및 프로젝트 단위: 구성할 수 있으며 기본값은 분당
400개 요청입니다. 이 프로젝트별 제한을 제거하려면0으로 설정합니다. 사용자 및 파이프라인 단위 제한은 계속 적용됩니다.
두 제한 중 하나라도 초과하면 삭제 요청이 차단됩니다.
사용자 및 프로젝트 단위 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum pipeline deletions per project의 값을 설정합니다.
- Save changes를 선택합니다.
job 삭제(erase) 속도 제한#
히스토리
- GitLab 19.5에서
rate_limit_job_erase라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 19.6에서 일반 공급되었습니다. 기능 플래그
rate_limit_job_erase가 제거되었습니다.
job을 erase하면 해당 job의 아티팩트와 로그가 제거됩니다. erase 요청 하나는 작지만, 요청을 많이 보내는 사용자는 인스턴스에 부담을 줄 수 있습니다. 예를 들어 프로젝트의 모든 job을 erase하는 스크립트는 분당 수백 개의 요청을 보낼 수 있습니다. 이러한 부하로부터 인스턴스를 보호하기 위해 사용자가 job을 erase할 수 있는 빈도를 제한할 수 있습니다.
이 속도 제한은 job erase REST API 또는 GitLab UI로 수행한 job erase에 적용됩니다.
GitLab은 다음 제한을 적용합니다.
- 사용자 및 job 단위: 분당
5개 요청으로 고정되어 있습니다. 이 제한은 구성할 수 없으며 항상 적용됩니다. - 사용자 및 프로젝트 단위: 구성할 수 있으며 기본값은 분당
400개 요청입니다. 이 프로젝트별 제한을 사용하지 않으려면0으로 설정합니다. 사용자 및 job 단위 제한은 계속 적용됩니다.
두 제한 중 하나라도 초과하면 erase 요청이 차단됩니다.
사용자 및 프로젝트 단위 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum job erasures per project의 값을 설정합니다.
- Save changes를 선택합니다.
job 취소 속도 제한#
히스토리
- GitLab 19.6에서 도입되었습니다.
한 사용자가 취소 요청을 많이 보내면 인스턴스에 상당한 부하가 걸릴 수 있습니다. 이를 방지하기 위해 각 사용자가 보낼 수 있는 취소 요청 수를 제한할 수 있습니다.
이 속도 제한은 job 취소 REST API,
jobCancel GraphQL 뮤테이션 또는 GitLab UI로 수행한
job 취소에 적용됩니다.
이 제한은 자체 제한이 있는 파이프라인 전체 취소의 일부로 취소된 job이나
중복 파이프라인의 자동 취소 같은 자동 취소에는 적용되지 않습니다.
GitLab은 다음 제한을 적용합니다.
- 사용자 및 job 단위: 분당
5개 요청으로 고정되어 있습니다. 이 제한은 구성할 수 없으며 항상 적용됩니다. - 사용자 및 프로젝트 단위: 구성할 수 있으며 기본값은 분당
150개 요청입니다. 이 프로젝트별 제한을 사용하지 않으려면0으로 설정합니다. 사용자 및 job 단위 제한은 계속 적용됩니다.
두 제한 중 하나라도 초과하면 취소 요청이 차단됩니다.
사용자 및 프로젝트 단위 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum job cancellations per project의 값을 설정합니다.
- Save changes를 선택합니다.
러너 job 목록 속도 제한#
히스토리
- GitLab 19.6에서
ci_rate_limit_runner_job_list_completed_statuses라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 19.6에서 REST API에
ci_rate_limit_rest_runner_job_list_completed_statuses라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - 제한의 적용이 GitLab 19.6에서
ci_enforce_runner_job_list_completed_statuses_limit라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
이 기능의 제공 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
완료된 상태로 필터링하여 러너의 job을 나열하는 요청이 반복되면 인스턴스에 상당한 부하가 걸릴 수 있습니다. 이를 방지하기 위해 각 사용자가 보낼 수 있는 이러한 요청 수를 제한할 수 있습니다.
이 속도 제한은 다음에 적용됩니다.
statuses인수에SUCCESS,FAILED또는CANCELED가 포함된 경우CiRunnerGraphQL 유형의jobs필드.status속성이success,failed또는canceled인 경우 러너가 처리한 모든 job 나열 REST API 엔드포인트.
이 제한은 다른 상태로만 필터링하거나 상태로 필터링하지 않은 요청에는 적용되지 않습니다. 대기 중처럼 러너의 job이 가질 수 없는 상태는 일치하는 job이 없습니다.
GitLab은 다음 제한을 적용합니다.
- 사용자 단위: 구성할 수 있으며 기본값은 분당
330개 요청입니다.
두 API에 대한 요청은 같은 사용자 단위 제한에 포함됩니다. 제한을 사용하지 않으려면 0으로 설정합니다.
제한을 초과하면 REST API는 429 Too Many Requests를 반환하고, GraphQL은 jobs 필드에 대해
오류를 반환합니다.
제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum runner job lists filtered by completed status per user의 값을 설정합니다.
- Save changes를 선택합니다.
사용자 프로젝트에 대한 러너 job 목록 속도 제한#
히스토리
- GitLab 19.6에서
ci_rate_limit_rest_runner_job_list_project_filtered라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
이 기능의 제공 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
사용자의 프로젝트로 필터링하여 러너의 job을 나열하는 요청이 반복되면 인스턴스에 상당한 부하가 걸릴 수 있습니다. 이를 방지하기 위해 각 사용자가 보낼 수 있는 이러한 요청 수를 제한할 수 있습니다.
이 속도 제한은 사용자의 프로젝트에 속한 job만 나열하는 러너가 처리한 모든 job 나열 REST API 엔드포인트에 적용됩니다. Admin Mode의 관리자나 감사자에게는 이 엔드포인트가 러너의 모든 job을 나열하므로 이 제한이 적용되지 않습니다.
GitLab은 다음 제한을 적용합니다.
- 사용자 단위: 구성할 수 있으며 기본값은 분당
330개 요청입니다.
제한을 사용하지 않으려면 0으로 설정합니다. 제한을 초과하면 REST API는 429 Too Many Requests를 반환합니다.
제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum runner job lists filtered to user projects per user의 값을 설정합니다.
- Save changes를 선택합니다.
러너 매니저 목록 속도 제한#
히스토리
- GitLab 19.6에서
ci_rate_limit_rest_runner_manager_list라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
이 기능의 제공 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
러너의 매니저를 나열하는 요청이 반복되면 인스턴스에 상당한 부하가 걸릴 수 있습니다. 이를 방지하기 위해 각 사용자가 나열할 수 있는 러너 매니저 수를 제한할 수 있습니다.
이 속도 제한은 러너의 모든 매니저 나열 REST API 엔드포인트에 적용됩니다. 각 요청은 러너의 매니저 수만큼 제한에 포함됩니다. 러너의 매니저 수가 남은 제한보다 많은 요청은 거부되며, 거부된 요청도 제한에 포함됩니다.
GitLab은 다음 제한을 적용합니다.
- 사용자 단위: 구성할 수 있으며 기본값은 분당 러너 매니저
300000개입니다.
제한을 사용하지 않으려면 0으로 설정합니다.
제한을 초과하면 REST API는 429 Too Many Requests를 반환합니다.
제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum runner managers listed per user의 값을 설정합니다.
- Save changes를 선택합니다.
최대 아티팩트 크기#
스토리지 사용량을 제어하기 위해 job 아티팩트의 크기 제한을 설정합니다. job의 각 아티팩트 파일은 기본 최대 크기가 100 MB입니다.
artifacts:reports로 정의한 job 아티팩트에는 다른 제한이 적용될 수 있습니다.
서로 다른 제한이 적용되는 경우에는 더 작은 값이 사용됩니다.
이 설정은 job의 개별 파일이 아니라 최종 아카이브 파일의 크기에 적용됩니다.
아티팩트 크기 제한은 다음 수준에서 구성할 수 있습니다:
- 인스턴스: 모든 프로젝트와 그룹에 적용되는 기본 설정입니다.
- 그룹: 그룹 내 모든 프로젝트에 대해 인스턴스 설정을 재정의합니다.
- 프로젝트: 특정 프로젝트에 대해 인스턴스 설정과 그룹 설정을 모두 재정의합니다.
GitLab.com의 제한은 아티팩트 최대 크기를 참고합니다.
인스턴스의 최대 아티팩트 크기를 변경하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum artifacts size (MB) 텍스트 박스에 값을 입력합니다.
- Save changes를 선택합니다.
최대 include 수#
파이프라인이 include 키워드로 포함할 수 있는 외부 YAML 파일 개수를 제한합니다.
이 제한은 파이프라인이 너무 많은 파일을 포함할 때 발생하는 성능 문제를 방지합니다.
기본적으로 파이프라인은 최대 150개 파일을 포함할 수 있습니다. 파이프라인이 이 제한을 초과하면 오류와 함께 실패합니다.
파이프라인당 포함할 수 있는 최대 파일 수를 설정하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum includes 텍스트 박스에 값을 입력합니다.
- Save changes를 선택합니다.
CI 아티팩트 아카이브의 최대 크기#
이 설정은 동적 하위 파이프라인의 YAML 크기를 제한합니다.
CI 아티팩트 아카이브의 기본 최대 크기는 5메가바이트입니다.
Admin 영역에서 이 제한을 변경하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum artifact size for dynamic child pipelines (bytes) 텍스트 박스에 값을 입력합니다.
- Save changes를 선택합니다.
GitLab Rails 콘솔로 이 제한을 변경하려면
max_artifacts_content_include_size를 새 값으로 갱신합니다. 예를 들어 20 MB로 설정하려면 다음과 같이 실행합니다:
ApplicationSetting.update(max_artifacts_content_include_size: 20.megabytes)
job당 최대 캐시 수#
단일 CI/CD job이 정의할 수 있는 cache 항목 수를 제한합니다.
이 제한은 캐시가 cache:key:files를 사용할 때 파이프라인 생성 중 job이 트리거할 수 있는 Gitaly 호출 수의 상한을 정합니다.
기본적으로 job은 최대 4개의 캐시를 정의할 수 있습니다. job이 이 제한을 초과하면 구성 파싱이 오류와 함께 실패합니다.
값은 최소 1이어야 합니다. 제한을 기본값보다 높이면 파이프라인 생성 성능에 영향을 줄 수 있습니다.
job당 최대 캐시 수를 변경하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.
- Continuous Integration and Deployment를 확장합니다.
- Maximum caches per job 텍스트 박스에 값을 입력합니다.
- Save changes를 선택합니다.
CI/CD 제한 인스턴스 구성#
일부 CI/CD 제한은 인스턴스 구성을 편집해야만 변경할 수 있습니다.
사전 요구 사항:
- 해당 인스턴스의 GitLab Rails 콘솔에 접근할 수 있어야 합니다.
파이프라인의 최대 배포 job 수#
파이프라인의 최대 배포 job 수를 제한할 수 있습니다. 배포는
environment가 지정된 모든 job을 뜻합니다. 파이프라인의
배포 수는 파이프라인 생성 시점에 확인됩니다. 배포가 너무 많은
파이프라인은 deployments_limit_exceeded 오류와 함께 실패합니다.
제한을 변경하려면 다음 GitLab Rails 콘솔
명령으로 default 플랜의 제한을 변경합니다:
Plan.default.actual_limits.update!(ci_pipeline_deployments: 500)
기본 제한은 500입니다. 제한을 0으로 설정하면 비활성화됩니다.
파이프라인 트리거 수 제한#
프로젝트당 최대 파이프라인 트리거 수에 제한을 설정할 수 있습니다. 이 제한은 새 트리거가 생성될 때마다 확인됩니다.
새 트리거로 인해 총 파이프라인 트리거 수가 제한을 초과하게 되면 해당 트리거는 유효하지 않은 것으로 간주됩니다.
제한을 0으로 설정하면 비활성화됩니다. 기본값은 25000입니다.
이 제한을 100으로 설정하려면
GitLab Rails 콘솔에서 다음을 실행합니다:
Plan.default.actual_limits.update!(pipeline_triggers: 100)
파이프라인 스케줄이 하루에 생성하는 파이프라인 수 제한#
개별 파이프라인 스케줄이 하루에 트리거할 수 있는 파이프라인 수를 제한할 수 있습니다.
제한보다 잦게 파이프라인을 실행하려는 스케줄은 최대 빈도에 맞춰 느려집니다. 빈도는 1440(하루의 분 수)을 제한 값으로 나누어 계산합니다. 예를 들어 최대 빈도가 다음과 같은 경우입니다:
- 1분에 한 번이면 제한이
1440이어야 합니다. - 10분에 한 번이면 제한이
144여야 합니다. - 60분에 한 번이면 제한이
24여야 합니다
최솟값은 24이며, 60분당 파이프라인 한 개에 해당합니다.
최댓값은 없습니다.
GitLab Self-Managed 인스턴스에서 이 제한을 1440으로 설정하려면
GitLab Rails 콘솔에서 다음을 실행합니다:
Plan.default.actual_limits.update!(ci_daily_pipeline_schedule_triggers: 1440)
최대 파이프라인 스케줄 빈도#
예약 파이프라인은 어떤 cron 값으로든 구성할 수 있으나, 예약된 시각에 항상 정확히 실행되지는 않습니다. "pipeline schedule worker"라고 하는 내부 프로세스가 예약된 모든 파이프라인을 큐에 넣지만, 이 프로세스는 계속 실행되지는 않습니다. 워커는 자체 스케줄에 따라 실행되며, 시작할 준비가 된 예약 파이프라인은 워커가 다음번에 실행될 때에만 큐에 들어갑니다. 예약 파이프라인은 워커보다 잦게 실행될 수 없습니다.
pipeline schedule worker의 기본 빈도는 3-59/10 * * * *입니다(0:03, 0:13, 0:23처럼
10분마다 실행). GitLab.com의 기본 빈도는
GitLab.com 설정에 정리되어 있습니다.
pipeline schedule worker의 빈도를 변경하려면 다음을 수행합니다.
- 인스턴스의
gitlab.rb파일에서gitlab_rails['pipeline_schedule_worker_cron']값을 편집합니다. - 변경 사항을 적용하려면 GitLab을 재구성합니다.
예를 들어 파이프라인의 최대 빈도를 하루 두 번으로 설정하려면 pipeline_schedule_worker_cron을
cron 값 0 */12 * * *(매일 00:00과 12:00)로 설정합니다.
많은 파이프라인 스케줄이 동시에 실행되면 추가 지연이 발생할 수 있습니다. pipeline schedule worker는 시스템 부하를 분산하기 위해 배치 단위로 파이프라인을 처리하며 배치마다 짧은 지연을 둡니다. 이 때문에 시스템 부하에 따라 파이프라인 스케줄이 예약 시각보다 몇 분에서 한 시간 이상 늦게 시작될 수 있습니다.
보안 정책 프로젝트에 대한 스케줄 규칙 수 제한#
보안 정책 프로젝트당 총 스케줄 규칙 수를 제한할 수 있습니다. 이 제한은 스케줄 규칙이 있는 정책이 갱신될 때마다 확인됩니다. 새 스케줄 규칙으로 인해 총 스케줄 규칙 수가 제한을 초과하게 되면 새 스케줄 규칙은 처리되지 않습니다.
기본적으로 GitLab은 처리 가능한 스케줄 규칙 수를 제한하지 않습니다.
이 제한을 설정하려면 GitLab Rails 콘솔에서 다음을 실행합니다:
Plan.default.actual_limits.update!(security_policy_scan_execution_schedules: 100)
그룹 및 프로젝트 CI/CD 변수 제한#
그룹과 프로젝트에서 정의할 수 있는 CI/CD 변수의 개수는 인스턴스 전체에 대해 제한됩니다. 이 제한은 새 변수를 만들 때마다 확인됩니다. 새 변수로 인해 변수 총개수가 각각의 제한을 초과하게 되면 새 변수는 생성되지 않습니다.
이 제한 중 하나의 default 플랜을 갱신하려면
GitLab Rails 콘솔에서 다음 명령을 실행합니다:
-
그룹당 그룹 수준 CI/CD 변수 제한(기본값:
30000):Plan.default.actual_limits.update!(group_ci_variables: 40000) -
프로젝트당 프로젝트 수준 CI/CD 변수 제한(기본값:
8000):Plan.default.actual_limits.update!(project_ci_variables: 10000)
아티팩트 유형별 최대 파일 크기#
히스토리
러너가 업로드하는 artifacts:reports로 정의된
job 아티팩트는 파일 크기가 최대 파일 크기 제한을
초과하면 거부됩니다. 이 제한은 프로젝트의
최대 아티팩트 크기 설정과
해당 아티팩트 유형의 인스턴스 제한을 비교해 더 작은 값으로 결정됩니다.
제한은 메가바이트 단위로 설정하므로, 정의할 수 있는 가장 작은 값은 1 MB입니다.
아티팩트 유형마다 설정할 수 있는 크기 제한이 있습니다. 기본값 0은 해당 아티팩트
유형에 제한이 없다는 뜻이며, 이때는 프로젝트의 최대 아티팩트 크기
설정이 사용됩니다:
| 아티팩트 제한 이름 | 기본값 |
|---|---|
ci_max_artifact_size_accessibility |
0 |
ci_max_artifact_size_annotations |
0 |
ci_max_artifact_size_api_fuzzing |
0 |
ci_max_artifact_size_archive |
0 |
ci_max_artifact_size_browser_performance |
0 |
ci_max_artifact_size_cluster_applications |
0 |
ci_max_artifact_size_cobertura |
0 |
ci_max_artifact_size_codequality |
0 |
ci_max_artifact_size_container_scanning |
0 |
ci_max_artifact_size_coverage_fuzzing |
0 |
ci_max_artifact_size_dast |
0 |
ci_max_artifact_size_dependency_scanning |
0 |
ci_max_artifact_size_dotenv |
0 |
ci_max_artifact_size_jacoco |
0 |
ci_max_artifact_size_junit |
0 |
ci_max_artifact_size_license_management |
0 |
ci_max_artifact_size_license_scanning |
0 |
ci_max_artifact_size_load_performance |
0 |
ci_max_artifact_size_lsif |
200 MB |
ci_max_artifact_size_metadata |
0 |
ci_max_artifact_size_metrics_referee |
0 |
ci_max_artifact_size_metrics |
0 |
ci_max_artifact_size_network_referee |
0 |
ci_max_artifact_size_performance |
0 |
ci_max_artifact_size_requirements |
0 |
ci_max_artifact_size_requirements_v2 |
0 |
ci_max_artifact_size_sarif |
10 MB |
ci_max_artifact_size_sast |
0 |
ci_max_artifact_size_secret_detection |
0 |
ci_max_artifact_size_terraform |
5 MB |
ci_max_artifact_size_trace |
0 |
ci_max_artifact_size_cyclonedx |
1 MB |
예를 들어 GitLab Self-Managed에서 ci_max_artifact_size_junit 제한을 10 MB로
설정하려면 GitLab Rails 콘솔에서 다음을 실행합니다:
Plan.default.actual_limits.update!(ci_max_artifact_size_junit: 10)
ci_max_artifact_size_cyclonedx는 Admin 영역에서도 설정할 수 있습니다. 자세한 내용은
CycloneDX 아티팩트 크기 제한을 참고합니다.
job 로그의 최대 파일 크기#
GitLab의 job 로그 파일 크기 제한은 기본적으로 100메가바이트입니다. 이 제한을 초과하는 job은 실패로 표시되고 러너에서 중단됩니다.
GitLab Rails 콘솔에서 이 제한을 변경할 수 있습니다.
ci_jobs_trace_size_limit을 새 값(메가바이트 단위)으로 갱신합니다:
Plan.default.actual_limits.update!(ci_jobs_trace_size_limit: 125)
GitLab Runner에도 러너의 최대 로그 크기를 구성하는 output_limit 설정이
있습니다. 러너 제한을 초과하는 job은
계속 실행되지만, 제한에 도달한 시점부터 로그가 잘립니다.
프로젝트당 최대 활성 DAST 프로파일 스케줄 수#
프로젝트당 활성 DAST 프로파일 스케줄 수를 제한합니다. DAST 프로파일 스케줄은 활성 또는 비활성 상태일 수 있습니다.
GitLab Rails 콘솔에서 이 제한을 변경할 수 있습니다.
dast_profile_schedules를 새 값으로 갱신합니다:
Plan.default.actual_limits.update!(dast_profile_schedules: 50)
CI/CD 구성 YAML 파일의 최대 크기 및 깊이#
히스토리
- GitLab 17.3에서
max_yaml_size_bytes의 기본값이 변경되었습니다.
단일 CI/CD 구성 YAML 파일의 기본 최대 크기는 2메가바이트이고 기본 깊이는 100입니다.
GitLab Rails 콘솔에서 이 제한을 변경할 수 있습니다:
-
최대 YAML 크기를 갱신하려면
max_yaml_size_bytes를 새 값(메가바이트 단위)으로 갱신합니다:ApplicationSetting.update(max_yaml_size_bytes: 4.megabytes)max_yaml_size_bytes값은 YAML 파일의 크기와 직접 연결되는 것이 아니라, 관련 객체에 할당되는 메모리와 연결됩니다. -
최대 YAML 깊이를 갱신하려면
max_yaml_depth를 새 값(줄 수 단위)으로 갱신합니다:ApplicationSetting.update(max_yaml_depth: 125)
전체 CI/CD 구성의 최대 크기#
히스토리
포함된 모든 YAML 구성 파일을 합한 전체 파이프라인 구성에 할당할 수 있는 최대 메모리 양(바이트)입니다.
기본값은 max_yaml_size_bytes(기본값 2 MB)와 ci_max_includes(기본값 150)를 곱해 계산합니다:
- GitLab 17.2 이하: 1 MB × 150 =
157286400바이트(150 MB). - GitLab 17.3 이상: 2 MB × 150 =
314572800바이트(314.6 MB).
GitLab Rails 콘솔로 이 제한을 변경할 수 있습니다.
CI/CD 구성에 할당할 수 있는 최대 메모리를 갱신하려면
ci_max_total_yaml_size_bytes를 새 값으로 갱신합니다. 예를 들어 20 MB로 설정하려면 다음과 같이 실행합니다:
ApplicationSetting.update(ci_max_total_yaml_size_bytes: 20.megabytes)
이 제한은 파이프라인이 생성될 때 단일 CI/CD job에 대해 저장되는 컴파일된 구성에도 적용됩니다. 단일 job의 구성은 항상 전체 파이프라인 구성의 부분집합이므로 이 제한을 초과할 수 없습니다.
CI/CD job 어노테이션 제한#
CI/CD job당 어노테이션의 최대 개수에 제한을 설정할 수 있습니다.
제한을 0으로 설정하면 비활성화됩니다. 기본값은 20입니다.
인스턴스에서 이 제한을 100으로 설정하려면
GitLab Rails 콘솔에서 다음 명령을 실행합니다:
Plan.default.actual_limits.update!(ci_job_annotations_num: 100)
CI/CD job 어노테이션 파일 크기 제한#
CI/CD job 어노테이션의 최대 크기에 제한을 설정할 수 있습니다.
제한을 0으로 설정하면 비활성화됩니다. 기본값은 80 KB입니다.
이 제한을 100 KB로 설정하려면 GitLab Rails 콘솔에서 다음을 실행합니다:
Plan.default.actual_limits.update!(ci_job_annotations_size: 100.kilobytes)
CI/CD 테이블의 최대 데이터베이스 파티션 크기#
새 파티션이 자동으로 생성되기 전까지 파티션된 테이블의 한 파티션이 사용할 수 있는 최대 디스크 공간(바이트)입니다. 기본값은 100 GB입니다.
GitLab Rails 콘솔로 이 제한을 변경할 수 있습니다.
제한을 변경하려면 ci_partitions_size_limit을 새 값으로 갱신합니다. 예를 들어 20 GB로 설정하려면 다음과 같이 실행합니다:
ApplicationSetting.update(ci_partitions_size_limit: 20.gigabytes)
CI/CD 파티션의 최대 시간 범위#
히스토리
- GitLab 18.10에서 도입되었습니다.
새 CI 파티션이 생성되고 시스템이 다음 파티션 세트로 전환되기까지의 시간 범위(초)입니다. 1개월에서 6개월 사이여야 합니다. 기본값은 1개월(2592000초)입니다.
GitLab Rails 콘솔로 이 제한을 변경할 수 있습니다.
제한을 변경하려면 ci_partitions_in_seconds_limit을 새 값으로 갱신합니다. 예를 들어 3개월로 설정하려면 다음과 같이 실행합니다:
ApplicationSetting.update(ci_partitions_in_seconds_limit: ChronicDuration.parse('3 months'))
자동 파이프라인 정리의 최대 보존 기간#
히스토리
- GitLab 18.0에서 도입되었습니다.
자동 파이프라인 정리의 상한을 구성합니다. 기본값은 1년입니다.
GitLab Rails 콘솔로 이 제한을 변경할 수 있습니다.
제한을 변경하려면 ci_delete_pipelines_in_seconds_limit_human_readable을 새 값으로 갱신합니다.
예를 들어 3년으로 설정하려면 다음과 같이 실행합니다:
ApplicationSetting.update(ci_delete_pipelines_in_seconds_limit_human_readable: '3 years')