Debian/Ubuntu에서 소스 코드로 GitLab을 직접 컴파일하여 설치하는 방법을 단계별로 설명합니다. Ruby, Go, Node, PostgreSQL, Redis, NGINX 등 의존성 설치부터 서비스 설정까지 전 과정을 안내합니다.
- Tier: Free, Premium, Ultimate - Offering: GitLab Self-Managed 이 문서는 소스 파일을 사용하여 프로덕션 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의 좌측 상단 모서리(메뉴 바 아래)에 있는 버전 드롭다운 목록에서 브랜치를 선택할 수 있습니다. 가장 높은 번호의 안정 브랜치가 불명확한 경우, GitLab 블로그 에서 버전별 설치 가이드 링크를 확인하세요. 소프트웨어 요구 사항 # 소프트웨어 최소 버전 비고 Ruby 3.2.x GitLab 16.7부터 17.4까지는 Ruby 3.1이 필요합니다. GitLab 17.5 이상에서는 Ruby 3.2가 필요합니다. 표준 MRI Ruby 구현을 사용해야 합니다. JRuby와 Rubinius도 좋지만, GitLab은 네이티브 확장이 있는 여러 Gem이 필요합니다. RubyGems 3.5.x 특정 RubyGems 버전이 필요한 것은 아니지만, 알려진 성능 향상 혜택을 받기 위해 업데이트하는 것이 좋습니다. Go 1.22.x GitLab 17.1 이상에서는 Go
