Git 작업 속도 제한
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed
요약
클론, 페치, 푸시 같은 일반적인 Git 작업은 짧은 시간에 많은 요청을 생성할 수 있습니다. 리포지터리에서 Git HTTP를 사용하면 일반적인 Git 작업이 많은 Git HTTP 요청을 생성할 수 있습니다. 일반 사용자 및 IP 속도 제한은 Git HTTP 요청에 적용되지 않습니다.
클론, 페치, 푸시 같은 일반적인 Git 작업은 짧은 시간에 많은 요청을 생성할 수 있습니다. Git HTTP, Git LFS, Git SSH, Git 푸시 작업의 속도 제한은 GitLab 인스턴스의 보안과 내구성을 보호합니다. 이러한 각 제한은 일반 사용자 및 IP 속도 제한과 다르게 동작합니다. 각 섹션에서 그 방식을 설명합니다.
Git HTTP#
히스토리
- GitLab 17.0에서 도입되었습니다.
리포지터리에서 Git HTTP를 사용하면 일반적인 Git 작업이 많은 Git HTTP 요청을 생성할 수 있습니다. GitLab은 웹 애플리케이션의 보안과 내구성을 높이기 위해 인증된 Git HTTP 요청과 인증되지 않은 Git HTTP 요청 모두에 속도 제한을 적용할 수 있습니다.
일반 사용자 및 IP 속도 제한은 Git HTTP 요청에 적용되지 않습니다.
GitLab.com의 Git HTTP#
GitLab.com에서 Git HTTP 요청에는 Git HTTPS 요청 속도 제한이 적용됩니다.
인증되지 않은 Git HTTP 속도 제한 구성#
히스토리
- GitLab 19.6에서 CI/CD job 토큰으로 인증된 요청을 제외하도록 변경되었습니다.
GitLab은 기본적으로 인증되지 않은 Git HTTP 요청의 속도 제한을 비활성화합니다.
CI/CD job 토큰으로 인증된 Git HTTP 요청은 Git LFS 오브젝트 업로드 및 다운로드를 제외하고 이 제한에 포함되지 않습니다. 그 밖의 job 토큰 요청을 제한하려면 인증된 Git HTTP 속도 제한을 활성화합니다.
사전 요구 사항:
- 관리자 액세스 권한이 있어야 합니다.
인증 매개변수가 없는 Git HTTP 요청에 속도 제한을 적용하려면 다음 제한을 활성화하고 구성합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Network를 선택합니다.
- Git HTTP rate limits를 확장합니다.
- Enable unauthenticated Git HTTP request rate limit를 선택합니다.
- Max unauthenticated Git HTTP requests per period per user에 값을 입력합니다.
- Unauthenticated Git HTTP rate limit period in seconds에 값을 입력합니다.
- Save changes를 선택합니다.
인증된 Git HTTP 속도 제한 구성#
히스토리
- 인증된 Git HTTP 속도 제한이 GitLab 18.1에서
git_authenticated_http_limit이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 18.3에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에서 활성화되었습니다.
- GitLab 18.4에서 일반 공급되었습니다. 기능 플래그
git_authenticated_http_limit이 제거되었습니다. - GitLab 19.6에서 CI/CD job 토큰으로 인증된 요청을 포함하도록 변경되었습니다.
GitLab은 기본적으로 인증된 Git HTTP 요청의 속도 제한을 비활성화합니다.
CI/CD job 토큰으로 인증된 요청은 job을 실행하는 사용자의 제한에 포함됩니다.
사전 요구 사항:
- 관리자 액세스 권한이 있어야 합니다.
인증 매개변수가 포함된 Git HTTP 요청에 속도 제한을 적용하려면 다음 제한을 활성화하고 구성합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Network를 선택합니다.
- Git HTTP rate limits를 확장합니다.
- Enable authenticated Git HTTP request rate limit를 선택합니다.
- Max authenticated Git HTTP requests per period per user에 값을 입력합니다.
- Authenticated Git HTTP rate limit period in seconds에 값을 입력합니다.
- Save changes를 선택합니다.
필요한 경우 특정 사용자가 인증된 요청 속도 제한을 우회하도록 허용할 수 있습니다.
프로젝트별 속도 제한 재정의#
히스토리
- GitLab 19.6에서
project_git_throttle_overrides라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다. 이 기능은 테스트용으로 사용할 수 있으며 프로덕션 환경에서 사용하기에는 준비되지 않았습니다.
일부 프로젝트는 위키와 디자인 리포지터리 트래픽을 포함해 리포지터리 트래픽을 과도하게 생성할 수 있습니다. 이 경우 인스턴스 전체 속도 제한 설정을 사용하는 대신 다음 항목에 프로젝트별 제한을 설정합니다.
- 인증되지 않은 Git HTTP 요청
- 인증된 Git HTTP 요청
- 인증된 Git LFS 요청
프로젝트별 제한은 재정의하려는 인스턴스 제한보다 엄격해야 합니다. 그렇지 않으면 인스턴스 전체 제한이 계속 적용됩니다. 따라서 이 설정으로 개별 프로젝트의 속도 제한을 완화할 수 없습니다. 속도 제한 기간은 항상 인스턴스 전체 설정을 따릅니다. 프로젝트별 제한은 해당하는 인스턴스 전체 제한이 활성화된 경우에만 적용됩니다.
사전 요구 사항:
- 프로젝트의 Owner 권한이 있어야 합니다.
프로젝트별 제한을 설정하려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- Settings > Repository를 선택합니다.
- Git request rate limits를 확장합니다.
- 다음 중 하나 이상에 값을 입력합니다.
- Unauthenticated Git HTTP requests
- Authenticated Git HTTP requests
- Authenticated Git LFS requests
- Save changes를 선택합니다.
이 값은 캐시되므로 변경 사항이 적용되기까지 최대 1분이 걸릴 수 있습니다. 프로젝트별 재정의 대신 인스턴스 전체 제한을 사용하려면 해당 필드를 비워 둡니다. GitLab은 이름이 변경된 뒤에도 프로젝트의 이전 경로로 보낸 Git 요청을 계속 처리하므로, 프로젝트별 제한은 이전 경로에도 적용됩니다.
Git LFS#
Git Large File Storage(LFS)는 대용량 파일을 처리하기 위한 Git 확장입니다. Git LFS를 사용하는 리포지터리는 많은 수의 LFS 요청을 생성할 수 있습니다. 일반 사용자 및 IP 속도 제한을 적용할 수 있으며, 일반 설정을 재정의해 Git LFS 요청에 추가 제한을 적용할 수도 있습니다. 이 재정의는 웹 애플리케이션의 보안과 내구성을 높일 수 있습니다.
GitLab.com의 Git LFS#
GitLab.com에서 Git LFS 요청에는 인증된 웹 요청 속도 제한이 적용됩니다. 이 제한은 사용자당 분당 1000개 요청으로 설정되어 있습니다.
업로드하거나 다운로드하는 Git LFS 오브젝트마다 HTTP 요청이 생성되며, 이 요청은 제한에 포함됩니다.
대용량 파일이 여러 개인 프로젝트에서는 HTTP 속도 제한 오류가 발생할 수 있습니다. 이 오류는 CI/CD 파이프라인 같은 자동화된 환경에서 단일 IP 주소로 클론이나 풀을 수행할 때 발생합니다.
Git LFS 속도 제한 구성#
히스토리
- GitLab 19.6에서 CI/CD job 토큰으로 인증된 LFS 배치 및 잠금 요청을 포함하도록 변경되었습니다.
GitLab Self-Managed 인스턴스에서는 Git LFS 속도 제한이 기본적으로 비활성화되어 있습니다. 관리자는 Git LFS 트래픽 전용 속도 제한을 구성할 수 있습니다. 활성화하면 이 전용 LFS 속도 제한이 기본 사용자 및 IP 속도 제한을 재정의합니다.
CI/CD job 토큰으로 인증된 LFS 배치 및 잠금 요청은 job을 실행하는 사용자의 제한에 포함됩니다. CI/CD job 토큰으로 인증된 LFS 오브젝트 업로드 및 다운로드는 이 제한에 포함되지 않습니다. 대신 인증되지 않은 Git HTTP 속도 제한에 포함됩니다.
사전 요구 사항:
- 인스턴스의 관리자여야 합니다.
Git LFS 속도 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Network를 선택합니다.
- Git LFS Rate Limits를 확장합니다.
- Enable authenticated Git LFS request rate limit를 선택합니다.
- Max authenticated Git LFS requests per period per user에 값을 입력합니다.
- Authenticated Git LFS rate limit period in seconds에 값을 입력합니다.
- Save changes를 선택합니다.
Git SSH 작업#
GitLab은 SSH를 사용하는 Git 작업에 사용자 계정과 프로젝트별로 속도 제한을 적용합니다. 사용자가 속도 제한을 초과하면 GitLab은 해당 프로젝트에 대한 그 사용자의 추가 연결 요청을 거부합니다.
속도 제한은 Git 명령(플러밍) 수준에서 적용됩니다. 기본적으로 각 명령의 속도 제한은 분당 600회입니다. 예를 들면 다음과 같습니다.
git push의 속도 제한은 분당 600회입니다.git pull에는 별도의 분당 600회 속도 제한이 있습니다.
git-upload-pack, git pull, git clone 명령은 명령을 공유하므로 속도 제한도 공유합니다.
일반 사용자 및 IP 속도 제한은 Git SSH 작업에 적용되지 않습니다. SSH 트래픽은 내부 API를 통해 GitLab에 도달하므로 Git SSH 작업 제한에만 포함됩니다.
모든 리포지터리에 걸친 사용자별 제한#
히스토리
- GitLab 19.6에서
rate_limit_gitlab_shell_operation_per_actor라는 기능 플래그와 함께 베타로 도입되었습니다. 기본적으로 비활성화되어 있습니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
GitLab은 한 사용자가 모든 리포지터리와 Git 명령에 걸쳐 수행할 수 있는 Git 작업 수도 제한합니다. 이 제한에는 Git SSH 작업, HTTP를 통한 푸시, UI 또는 API를 통한 리포지터리 변경이 포함됩니다. 기본적으로 각 사용자는 분당 6,000회 작업을 수행할 수 있습니다. 이 제한은 프로젝트별 및 Git 명령별 제한에 더해 적용됩니다.
GitLab은 배포 키를 그것을 만든 사용자와 별도로 계산합니다.
GitLab은 SSH를 통한 푸시를 두 번 확인합니다. 연결이 수락될 때 한 번, 변경 사항이 기록되기 전에 한 번입니다. SSH를 통한 푸시는 한 번에 두 번의 작업으로 계산됩니다. GitLab은 HTTP를 통한 푸시와 UI 또는 API를 통한 변경은 변경 사항이 기록되기 전에 한 번 확인합니다. 사용자가 이 확인 시점에 제한을 초과하면 GitLab은 데이터가 업로드된 후 변경을 거부합니다.
GitLab.com의 Git SSH 작업#
GitLab.com에서 Git SSH 작업은 분당 600회 작업이라는 기본 속도 제한을 사용합니다. 이 제한은 변경할 수 없습니다.
GitLab Shell 작업 제한 구성#
기본적으로 사용자, 프로젝트, Git 명령별 제한은 분당 600회 작업입니다. 모든 리포지터리에 걸친 제한은 분당 6,000회 작업입니다.
사전 요구 사항:
- 관리자 액세스 권한이 있어야 합니다.
-
오른쪽 상단에서 Admin을 선택합니다.
-
왼쪽 사이드바에서 Settings > Network를 선택합니다.
-
Git SSH operations rate limits를 확장합니다.
-
다음 필드에 값을 입력합니다.
- Maximum number of Git operations per minute: 사용자, 프로젝트, Git 명령별 제한입니다.
- Maximum number of Git operations each user can perform every minute: 모든 리포지터리에 걸친 사용자별 제한입니다.
제한을 비활성화하려면
0으로 설정합니다. -
Save changes를 선택합니다.
Git 푸시 작업#
히스토리
- GitLab 19.6에서
rate_limit_git_push_per_project라는 기능 플래그와 함께 베타로 도입되었습니다. 기본적으로 비활성화되어 있습니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
GitLab은 프로젝트당 분당 Git 푸시 횟수를 제한합니다. 이 제한은 HTTPS와 SSH를 통한 모든 사용자의 푸시를 계산합니다. GitLab은 클라이언트가 푸시할 데이터를 업로드하기 전에 제한을 확인합니다. 기본적으로 각 프로젝트는 분당 600회 푸시를 허용합니다. 이 제한은 Git HTTP 및 Git SSH 속도 제한에 더해 적용됩니다.
프로젝트가 제한을 초과하면 GitLab은 Retry-After 헤더와 함께
429 Too Many Requests 응답을 반환합니다.
- HTTPS에서는 푸시가 실패하고 Git 클라이언트에
The requested URL returned error: 429가 표시됩니다. - SSH에서는 GitLab Shell이 60초 동안 기다린 뒤 최대 두 번까지 재시도합니다.
모든 시도에서 제한을 초과하면 푸시가
Internal API unreachable로 실패합니다.
이 제한은 프로젝트 리포지터리로의 Git 팩 업로드를 계산합니다. 다음은 계산하지 않습니다.
- 위키 또는 스니펫으로의 푸시
- UI 또는 API에서 만든 커밋
- 풀 미러링
- Git LFS 오브젝트 업로드
HTTPS에서 http.postBuffer(기본값 1 MiB)보다 큰 푸시는 Git이 데이터를 보내기 전에 프로브 요청을 보내므로
두 번의 푸시로 계산됩니다.
SSH에서 Git LFS 오브젝트를 업로드하는 푸시는 GitLab이 Git LFS 인증 요청도 계산하므로
두 번의 푸시로 계산됩니다.
GitLab은 Geo 보조 사이트로의 푸시를 데이터를 받는 기본 사이트에서 계산합니다.
Git 푸시 속도 제한 구성#
사전 요구 사항:
- 관리자 액세스 권한이 있어야 합니다.
Git 푸시 속도 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 상단에서 을 선택합니다.
- 왼쪽 사이드바에서 > 를 선택합니다.
- 를 확장합니다.
- 에 값을 입력합니다.
제한을 비활성화하려면
0으로 설정합니다. - 를 선택합니다.