다음과 같은 경우 PostgreSQL을 튜닝해야 합니다:

• 다른 GitLab 구성요소가 데이터베이스에 영향을 미치는 방식으로 재구성되거나 확장된 경우.
• GitLab 환경의 성능이 저하된 경우.
• GitLab이 외부 PostgreSQL 서비스를 사용하는 경우.

이 정보를 GitLab의 필수 PostgreSQL 설정과 함께 사용하십시오.

데이터베이스 연결 계획#

GitLab은 여러 구성요소에서 데이터베이스 연결을 사용합니다. 적절한 연결 계획은 데이터베이스 연결 고갈 및 성능 문제를 방지합니다.

각 GitLab 구성요소는 구성에 따라 데이터베이스 연결을 사용합니다. Sidekiq 및 Puma는 초기화 시 PostgreSQL에 대한 연결 풀을 설정합니다. 연결 스파이크나 수요의 일시적 증가가 있는 경우 풀의 연결 수가 나중에 증가할 수 있습니다:

• 환경 변수 DB_POOL_HEADROOM으로 데이터베이스 풀 여유분을 구성합니다.
• PostgreSQL을 튜닝할 때 풀 여유분을 계획하되 변경하지 마십시오. GitLab 배포는 더 많은 용량이 사용 가능한 경우 더 높은 수요에 더 잘 대응합니다: 더 많은 Sidekiq 또는 Puma 워커를 배포하십시오.

Puma#

Puma connections = puma['worker_processes'] × (puma['max_threads'] + DB_POOL_HEADROOM)

기본값:

• puma['worker_processes']는 CPU 코어 수를 기반으로 합니다.
• puma['max_threads']는 4입니다.
• DB_POOL_HEADROOM은 10입니다.

워커당 계산: 각 Puma 워커는 4개의 스레드 + 10개의 여유분을 사용하여 총 14개의 연결을 사용합니다.

8 vCPU를 가정한 기본 계산: 8개 워커 × 워커당 14개 연결, 총 112개의 Puma 연결.

Sidekiq#

Sidekiq connections = Number of Sidekiq processes × (sidekiq['concurrency'] + 1 + DB_POOL_HEADROOM)

기본값:

• Sidekiq 프로세스 수는 1입니다.
• sidekiq['concurrency']는 20입니다.
• DB_POOL_HEADROOM은 10입니다.

기본 계산: 1개 Sidekiq 프로세스 × (20 동시성 + 1 + 10 여유분), 총 31개의 Sidekiq 연결.

Geo 로그 커서 (Geo 설치 전용)#

Geo 로그 커서 데몬은 보조 사이트의 모든 GitLab Rails 노드에서 실행됩니다.

Geo log cursor connections = 1 + DB_POOL_HEADROOM

기본 계산: 1 + 10 여유분, 총 11개의 Geo 연결.

총 연결 요구 사항#

단일 노드 설치의 경우:

Total connections = 2 × (Puma + Sidekiq + Geo)

다중 노드 설치의 경우 각 구성요소를 실행하는 노드 수를 곱합니다:

Total connections = 2 × ((Puma × Rails nodes) + (Sidekiq × Sidekiq nodes) + (Geo × secondary Rails nodes))

2를 곱하는 것은 GitLab 16.0 이상의 이중 데이터베이스 연결을 고려한 것입니다.

Geo 설치의 경우:

• 기본 사이트: Geo = 0을 사용합니다. Geo 로그 커서는 기본 사이트에서 실행되지 않습니다.
• 보조 사이트: 하나의 보조 사이트에 대한 Geo 로그 커서 데이터베이스 연결을 계산하고 동일한 계산을 모든 보조 사이트에 적용합니다.
• 각 Geo 사이트는 자체 데이터베이스에 연결하므로 여러 Geo 사이트 간에 연결을 합산할 필요가 없습니다.
• 기본 PostgreSQL 데이터베이스와 모든 복제본 데이터베이스에 max_connections를 동일한 값으로 설정하되, 모든 Geo 사이트 중 가장 높은 연결 요구 사항을 사용합니다.

예시#

단일 노드 설치#

이 예시는 초당 20 RPS(요청) 또는 1000명 사용자에 대한 GitLab 참조 아키텍처를 기반으로 합니다:

다중 노드 설치#

이 예시는 초당 40 RPS(요청) 또는 2000명 사용자에 대한 GitLab 참조 아키텍처를 기반으로 합니다:

Geo를 사용하는 단일 노드 설치#

이 예시는 초당 20 RPS(요청) 또는 1000명 사용자에 대한 GitLab 참조 아키텍처를 기반으로 합니다.

Geo를 사용하는 다중 노드 설치#

이 예시는 초당 40 RPS(요청) 또는 2000명 사용자에 대한 GitLab 참조 아키텍처를 기반으로 합니다: