Gitaly 타임아웃
Tier: Free, Premium, Ultimate
Offering: Self-Managed
Offering: Self-Managed
Gitaly은 두 가지 유형의 구성 가능한 타임아웃을 제공합니다.
- GitLab UI를 사용하여 구성하는 콜 타임아웃.
- Gitaly 구성 파일을 사용하여 구성하는 협상 타임아웃.
콜 타임아웃 구성
다음 콜 타임아웃을 구성하여 장시간 실행되는 Gitaly 호출이 불필요하게 리소스를 차지하지 않도록 합니다. 콜 타임아웃을 구성하려면:
- 왼쪽 사이드바에서 맨 아래에서 관리 영역(Admin Area)을 선택합니다.
- 설정(Settings) > 기본 설정(Preferences)을 선택합니다.
- Gitaly timeouts 섹션을 확장합니다.
- 각 타임아웃을 필요에 따라 설정합니다.
사용 가능한 콜 타임아웃
다양한 Gitaly 작업에 대해 다양한 콜 타임아웃이 제공됩니다.
타임아웃 | 기본값 | 설명 |
---|---|---|
기본(Default) | 55초 | 대부분의 Gitaly 호출에 대한 타임아웃( git fetch 및 push 작업이나 Sidekiq 작업에는 적용되지 않음). 예를 들어, 디스크에 리포지토리가 있는지 확인하는 작업. 웹 요청에서 이루어지는 Gitaly 호출이 전체 요청 시간 제한을 초과하지 않도록 합니다. 웹 요청에서 이루어지는 Gitaly 호출이 전체 요청 시간 제한을 초과하지 않도록 합니다. Puma 설정 파일에서 구성할 수 있는 작업자(worker) 타임아웃보다 짧아야 합니다. Gitaly 호출 타임아웃이 작업자(worker) 타임아웃을 초과하면, 작업자(worker)를 종료하지 않고 남은 시간을 사용하여 작업을 마무리할 수 있습니다.
|
빠름(Fast) | 10초 | 요청에 사용되는 빠른 Gitaly 작업에 대한 타임아웃으로, 때로는 여러 번 발생합니다. 예를 들어, 디스크에 리포지토리가 있는지 확인하는 작업. 빠른 작업이 이 임계값을 초과하면, 저장소 샤드에 문제가 있을 수 있습니다. 빠른 실패는 GitLab 인스턴스의 안정성을 유지하는 데 도움이 될 수 있습니다. |
중간(Medium) | 30초 | 빠르지만(가능하면 요청에 포함될 수 있음) 한 번 이상 사용되기를 원치 않는 Gitaly 작업에 대한 타임아웃입니다. 예를 들어, blobs를 로드합니다. 기본(Default)과 빠름(Fast) 사이에 설정해야 하는 타임아웃입니다. |
협상 타임아웃 구성
- GitLab 16.5에서 도입.
특히 큰 리포지토리에 대해 협상 타임아웃을 늘려야 할 수 있습니다.
- 병렬로 이러한 명령을 수행할 때.
다음과 같은 작업에 대해 협상 타임아웃을 구성할 수 있습니다:
-
git fetch
를 실행할 때 Gitaly 노드에서 호출되는git-upload-pack(1)
. -
git archive --remote
를 실행할 때 Gitaly 노드에서 호출되는git-upload-archive(1)
.
이러한 타임아웃을 구성하려면:
/etc/gitlab/gitlab.rb
를 편집합니다:
gitaly['configuration'] = {
timeout: {
upload_pack_negotiation: '10m', # 10분
upload_archive_negotiation: '20m', # 20분
}
}
값에는 Go의 ParseDuration
형식을 사용합니다.
이러한 타임아웃은 원격 Git 작업의 협상 단계에만 영향을 미치며 전체 전송에는 영향을 주지 않습니다.