GitLab Self-Managed에는 배포 규모와 워크로드에 따라 달라지는 특정 하드웨어, 구성 요소 및 인프라 요구사항이 있습니다. 더 크거나 분산된 배포의 경우 사이징 가이드를 사용하여 환경에 적합한 사양을 결정하세요.

하드웨어#

GitLab은 단일 노드에 배포하거나 여러 노드에 분산하여 배포할 수 있습니다. 단일 노드 설치에 대한 최소 하드웨어 요구사항은 아래에 나열되어 있습니다. 분산 배포의 경우 요구사항은 구성 요소 유형별로 할당되며 부하에 따라 확장됩니다. 사이징 가이드를 사용하여 예상 부하와 워크로드 구성에 따라 적합한 사양을 결정하세요.

CPU#

단일 노드 설치의 경우 8 vCPU가 기준입니다. ARM 기반 프로세서가 지원됩니다. 분산 배포의 경우 CPU는 구성 요소 유형별로 할당되며 부하에 따라 확장됩니다.

버스터블 인스턴스 유형은 일관되지 않은 성능으로 인해 권장되지 않습니다.

메모리#

단일 노드 설치의 경우 16 GB가 기준입니다. 분산 배포의 경우 메모리는 구성 요소 유형별로 할당되며 부하에 따라 확장됩니다.

메모리 제한 환경의 단일 노드 설치의 경우 GitLab은 최소 8 GB의 메모리로 실행될 수 있습니다. 자세한 내용은 메모리 제한 환경에서 GitLab 실행을 참조하세요.

가능한 경우 스왑을 비활성화하세요. 스왑은 부하가 높을 때 상당한 성능 저하를 유발할 수 있습니다.

스왑을 비활성화할 수 없는 경우 GitLab이 스왑을 사용하지 않도록 충분한 메모리를 프로비저닝하세요.

스토리지#

스토리지 요구사항은 구성 요소별로 다릅니다. 단일 노드 설치의 경우 모든 요구사항을 한 대의 머신에 합산합니다. 분산 배포의 경우 각각을 관련 노드 유형에 적용합니다:

NFS, Amazon EFS, Azure Files와 같은 네트워크 파일 시스템은 성능에 상당한 영향을 미칠 수 있으므로 피하세요. 자세한 내용은 클라우드 기반 파일 시스템 피하기를 참조하세요.

최상의 성능을 위해 SSD 기반 스토리지를 사용하세요. 이는 I/O 집약적인 Gitaly에 특히 중요합니다.

버스터블 디스크 유형은 일관되지 않은 성능으로 인해 권장되지 않습니다.

인프라#

GitLab은 다양한 인프라 유형에서 실행됩니다. 다음 섹션에서는 지원되는 플랫폼과 고가용성 요구사항을 다룹니다.

지원되는 인프라#

기본 환경이 이 가이드에 설명된 하드웨어 및 구성 요소 요구사항을 충족하는 한, GitLab은 클라우드 제공업체와 자체 관리 인프라에서 실행됩니다. 일반적으로 사용되는 클라우드 제공업체에는 AWS, GCP, Azure가 있습니다. GitLab 지원은 GitLab 자체를 다루며, 기본 인프라 또는 플랫폼과 관련된 문제는 지원 범위를 벗어납니다.

Cloud Native 배포의 경우 GitLab은 GitLab Helm 차트 사전 요구사항을 충족하는 모든 Kubernetes 배포판에서 실행됩니다. 네트워킹, 스토리지 클래스, 인증과 같은 Kubernetes 플랫폼별 동작은 GitLab 지원 범위를 벗어납니다.

고가용성#

HA 배포에는 특정 네트워크 요구사항이 있습니다:

• 동기 복제를 지원하려면 노드 간 지연 시간이 5 ms 미만이어야 합니다.

• 복원력을 위해 여러 가용 영역에 걸쳐 배포하는 것이 권장됩니다. 쿼럼 요구사항을 충족하려면 홀수 개의 영역을 사용하세요.

• 여러 자체 관리 데이터 센터에 걸쳐 배포하려면 동기 지원 지연 시간, 중복 네트워크 링크, 동일한 지리적 리전 내 홀수 개의 센터가 필요합니다.

  단일 GitLab 인스턴스는 여러 지리적 리전에 걸쳐서는 안 됩니다. 다중 리전 배포의 경우 지리적으로 분산된 설치를 위해 설계된 GitLab Geo를 사용하세요. 다중 데이터 센터 배포의 인프라 관련 문제는 GitLab 지원 범위를 벗어날 수 있습니다.

구성 요소 요구사항#

PostgreSQL#

PostgreSQL은 유일하게 지원되는 데이터베이스이며 다음과 같이 제공됩니다:

• Linux 패키지와 함께 번들 인스턴스로.

• 외부 서비스로.

외부 인스턴스의 경우 다음을 참조하세요:

• 외부에서 관리되는 인스턴스에 대한 필수 설정.

• 스키마 지침에 대한 데이터베이스 스키마.

• 로케일 고려사항에 대한 로케일 호환성 확인 시기.

지원 버전#

다음 GitLab 버전에 대해 다음 PostgreSQL 버전을 사용합니다:

마이너 PostgreSQL 릴리스는 버그 및 보안 수정만 포함합니다. PostgreSQL에서 알려진 문제를 방지하려면 항상 최신 마이너 버전을 사용하세요. 자세한 내용은 이슈 364763을 참조하세요.

지정된 것보다 이후 주요 버전의 PostgreSQL을 사용하려면 이후 버전이 Linux 패키지와 함께 번들로 제공되는지 확인하세요.

스토리지 요구사항#

사용자 수에 따라 PostgreSQL 서버에는 다음이 있어야 합니다:

• 대부분의 GitLab 인스턴스의 경우 최소 5~10 GB의 스토리지.

• GitLab Ultimate의 경우 최소 12 GB의 스토리지 (1 GB의 취약점 데이터를 가져와야 함).

확장#

확장을 설치하려면 PostgreSQL에 슈퍼유저 권한이 필요합니다. 지침은 PostgreSQL 확장 관리를 참조하세요.

Gitaly Cluster (Praefect)#

Gitaly Cluster에는 메인 GitLab 데이터베이스와 별도의 전용 PostgreSQL 인스턴스가 필요합니다. 완전한 HA를 위해서는 타사 PostgreSQL 솔루션을 사용하세요. Gitaly에 대한 데이터베이스 수준의 중복이 필요하지 않은 환경에서는 Linux 패키지를 사용하는 비HA PostgreSQL 인스턴스로 충분합니다.

Redis 또는 Valkey#

Redis 또는 Valkey는 모든 사용자 세션과 백그라운드 작업을 저장합니다.

지원되는 Redis 또는 Valkey 버전은 다음과 같습니다:

1 Redis 7.0은 업스트림에서 수명 종료(EOL)에 도달했지만, 일부 경우에는 공급업체에서 적극적으로 유지 관리합니다. 예를 들어 Amazon ElastiCache for Redis 7.1은 자체 버전 번호를 사용하지만 Redis 7.0을 기반으로 구축되었습니다.

Redis의 수명 종료 날짜에 대한 자세한 내용은 Redis 문서를 참조하세요.

• 독립형 인스턴스(고가용성 포함 또는 미포함)를 사용합니다. Redis Cluster는 지원되지 않습니다.

• 서버리스 Redis 및 Valkey 변형은 지원되지 않습니다.

• 적절하게 제거 정책을 설정합니다.

Puma#

권장 Puma 설정은 설치에 따라 다릅니다. 기본적으로 Linux 패키지는 권장 설정을 사용합니다.

Puma 설정을 조정하려면:

• Linux 패키지의 경우 Puma 설정을 참조하세요.

• GitLab Helm 차트의 경우 webservice 차트를 참조하세요.

워커 및 스레드 사이징 지침은 Puma 워커 및 스레드 사이징을 참조하세요.

Sidekiq#

Sidekiq은 여러 스레드를 사용하여 백그라운드 작업을 처리합니다. 각 프로세스는 최소 200 MB의 메모리가 필요하며 부하가 높을 때 크게 증가할 수 있습니다. 사용자가 10,000명 이상인 환경의 경우 Sidekiq 프로세스당 최소 1 GB를 할당하세요.

오브젝트 스토리지#

오브젝트 스토리지는 분산 배포에 필요하며 모든 설치에 권장됩니다. LFS 오브젝트, CI/CD 아티팩트, 업로드, 컨테이너 레지스트리 데이터, 백업을 포함한 바이너리 데이터를 저장합니다.

S3 호환 오브젝트 스토리지 서비스를 사용하세요. 구성 및 테스트된 제공업체 목록은 오브젝트 스토리지를 참조하세요.

선택적 구성 요소#

이러한 구성 요소는 핵심 GitLab 설치에 필요하지 않지만 사용 시 별도의 인프라 또는 리소스 요구사항이 있습니다.

컨테이너 레지스트리#

GitLab 컨테이너 레지스트리는 GitLab 프로젝트의 Docker 및 OCI 이미지를 저장하며 다음이 필요합니다:

• 도메인.

• TLS 인증서.

• 파일 시스템 또는 S3 호환 오브젝트 스토리지.

트래픽이 많은 환경의 경우 레지스트리는 메인 GitLab 인스턴스와 별도의 전용 인프라에서 실행될 수 있습니다.

GitLab Pages#

GitLab Pages는 프로젝트 및 그룹의 정적 웹사이트를 호스팅합니다. 별도의 데몬으로 실행되며 와일드카드 DNS 레코드가 필요합니다. 사용자 지정 도메인 지원에는 보조 IP 주소와 TLS 인증서가 필요합니다.

Elasticsearch 및 OpenSearch#

고급 검색은 GitLab 콘텐츠 전반에서 더 빠르고 강력한 검색을 지원합니다. 별도의 Elasticsearch 또는 OpenSearch 클러스터가 필요합니다. 클러스터 크기는 인덱싱된 데이터의 양에 따라 달라집니다.

Prometheus#

Prometheus 모니터링은 Linux 패키지와 함께 번들로 제공되며 기본적으로 활성화되어 있습니다. 구성 또는 비활성화에 대한 자세한 내용은 Prometheus로 GitLab 모니터링을 참조하세요.

Zoekt#

Zoekt는 리포지터리 전반에서 정확한 코드 검색을 제공하며 별도의 서비스로 실행됩니다. 리소스 요구사항은 Zoekt 관리를 참조하세요.

ClickHouse#

ClickHouse는 제품 분석 기능에 사용되는 오픈 소스 열 지향 데이터베이스입니다. 별도의 데이터베이스 서비스로 실행됩니다. 리소스 요구사항은 ClickHouse 구성을 참조하세요.

AI Gateway#

AI Gateway는 GitLab Duo AI 기능을 위한 백엔드 서비스를 제공합니다. Docker 또는 Kubernetes에 배포할 수 있는 독립형 서비스로 실행됩니다. 리소스 요구사항은 설치 가이드를 참조하세요.

Secrets Manager#

GitLab Secrets Manager는 OpenBao로 구동되는 네이티브 시크릿 관리를 제공합니다. 별도의 Kubernetes 서비스로 실행되며 전용 PostgreSQL 데이터베이스와 로드 밸런서가 필요합니다.

지원되는 웹 브라우저#

GitLab은 다음 웹 브라우저를 지원합니다:

• Mozilla Firefox

• Google Chrome

• Chromium

• Apple Safari

• Microsoft Edge

GitLab은 Baseline Widely available 브라우저 세트를 대상으로 합니다. 이는 모든 핵심 브라우저에서 안정적인 웹 플랫폼 기능을 지원하는 브라우저 버전입니다. 기능은 최소 30개월 후에 Widely available 상태에 도달합니다. Widely available 브라우저 세트에는 이러한 브라우저의 데스크톱 및 모바일 버전이 모두 포함됩니다.

이러한 브라우저에서 JavaScript를 비활성화하고 GitLab을 실행하는 것은 지원되지 않습니다.

관련 항목#

• GitLab Runner 설치

• 설치 보안 강화

• Geo 실행 요구사항