소스 코드 직접 컴파일 설치

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.2.x GitLab 16.7부터 17.4 까지는 Ruby 3.1 이 필요합니다. GitLab 17.5 이상에서는 Ruby 3.2가 필요합니다. Ruby는 표준 MRI 구현을 사용해야 합니다. JRuby 와 Rubinius 도 좋은 선택이지만, GitLab은 네이티브 확장을 사용하는 Gem을 여럿 필요로 합니다. RubyGems 3.5.x 특정 RubyGems 버전이 반드시 필요하지는 않지만, 알려진 성능 개선을 적용하려면 업데이트하는 것이 좋습니다. Go 1.22.x GitLab 17.1 이상에서는 Go 1.22 이상이 필요합니다. Git 2.47.x GitLab 17.7 이상에서는 Git 2.47.x 이상이 필요합니다. Gitaly가 제공하는 Git 버전 을 사