InfoGrab DocsInfoGrab Docs

소스 코드 직접 컴파일 설치

Debian/Ubuntu에서 소스 코드로 GitLab을 직접 컴파일하여 설치하는 방법을 단계별로 설명합니다. Ruby, Go, Node, PostgreSQL, Redis, NGINX 등 의존성 설치부터 서비스 설정까지 전 과정을 안내합니다.

이 문서는 소스 파일을 사용해 프로덕션 GitLab 서버를 구축하는 공식 설치 가이드입니다. Debian/Ubuntu 운영 체제를 대상으로 작성했고 해당 환경에서 검증했습니다. 하드웨어 및 운영 체제 요구 사항은 requirements.md 를 참고합니다. RHEL/CentOS에 설치하려면 Linux 패키지 를 사용합니다. 그 밖의 여러 설치 방식은 기본 설치 페이지 를 참고합니다. 이 가이드는 다양한 경우를 다루고 필요한 명령을 모두 담고 있어 분량이 깁니다. 아래 단계는 동작이 확인된 절차입니다. 이 가이드에서 벗어날 때는 주의합니다. GitLab 이 자신의 환경에 대해 전제하는 사항을 위반하지 않도록 합니다. 예를 들어 디렉터리 위치를 바꾸거나 서비스를 잘못된 사용자로 실행해 권한 문제를 겪는 경우가 많습니다. 이 가이드에서 버그나 오류를 발견하면 머지 리퀘스트를 제출합니다. 제출 방법은 다음 문서를 따릅니다. 기여 가이드 . Linux 패키지 설치 검토 # 자체 컴파일 설치는 작업량이 많고 오류가 발생하기 쉬우므로, 빠르고 안정적인 Linux 패키지 설치 (deb/rpm)를 권장합니다. Linux 패키지가 더 안정적인 이유 중 하나는 GitLab 프로세스 중 하나가 중단되면 runit으로 다시 시작한다는 점입니다. 사용량이 많은 GitLab 인스턴스에서는 Sidekiq 백그라운드 워커의 메모리 사용량이 시간이 지나면서 늘어납니다. Linux 패키지는 메모리를 과도하게 사용하는 경우 Sidekiq를 정상적으로 종료 하여 이 문제를 해결합니다. 종료 후에는 runit 이 Sidekiq가 실행 중이 아님을 감지하고 다시 시작합니다. 자체 컴파일 설치는 프로세스 감시에 runit을 사용하지 않으므로 Sidekiq를 종료할 수 없고 메모리 사용량이 시간이 지나면서 늘어납니다. 설치할 버전 선택 # 설치하려는 GitLab 버전의 브랜치(예: 16-0-stable )에서 이 설치 가이드 를 확인합니다. 브랜치는 GitLab 왼쪽 위(메뉴 바 아래)의 버전 드롭다운 목록에서 선택할 수 있습니다. 가장 높은 번호의 stable 브랜치가 무엇인지 분명하지 않으면 GitLab 블로그 에서 버전별 설치 가이드 링크를 확인합니다. 소프트웨어 요구 사항 # 소프트웨어 최소 버전 참고 Ruby 3.3.13 GitLab 16.7부터 17.4까지는 Ruby 3.1이 필요합니다. GitLab 17.5부터는 Ruby 3.2가 필요합니다. GitLab 19.0 이상에서는 이전 릴리스가 CVE-2026-97229 의 영향을 받으므로 Ruby 3.3.13, 3.4.12, 4.0.9 또는 같은 시리즈의 이후 릴리스가 필요합니다. Ruby 3.4.10과 3.4.11은 3.3.13보다 이후 버전이지만 패치되지 않았습니다. Ruby는 표준 MRI 구현을 사용해야 합니다. JRuby 와 Rubinius 도 좋은 선택이지만, GitLab은 네이티브 확장을 사용하는 Gem을 여럿 필요로 합니다. RubyGems 3.6.x 특정 RubyGems 버전이 반드시 필요하지는 않지만, 알려