Linux 패키지로 GitLab 설치
GitLab v19.5Offering: GitLab Self-Managed
요약
Linux 패키지는 안정적이고 확장 가능하며 GitLab.com에서도 사용됩니다. Linux 패키지는 설치가 더 빠르고 업그레이드가 더 쉬우며, 다른 설치 방법에서는 찾을 수 없는 안정성 강화 기능을 포함합니다. Linux 패키지는 다음에 대해 패키지 리포지터리에서 제공됩니다:
Linux 패키지는 안정적이고 확장 가능하며 GitLab.com에서도 사용됩니다. 추가적인 유연성과 복원력이 필요하다면 참조 아키텍처 문서에서 설명하는 방식으로 GitLab을 배포하는 것을 권장합니다.
Linux 패키지는 설치가 더 빠르고 업그레이드가 더 쉬우며, 다른 설치 방법에서는 찾을 수 없는 안정성 강화 기능을 포함합니다. GitLab 실행에 필요한 다양한 서비스와 도구를 모두 묶은 단일 패키지(Omnibus GitLab이라고도 함)를 통해 설치합니다. 최소 하드웨어 요구 사항은 설치 요구 사항을 참고합니다.
Linux 패키지는 다음에 대해 패키지 리포지터리에서 제공됩니다:
호스트 운영체제에 필요한 GitLab 버전이 제공되는지 확인합니다.
지원되는 플랫폼#
GitLab은 아래 나열된 운영체제에 대해 Linux 패키지를 제공합니다. 이러한 플랫폼용 패키지를 빌드하고 배포합니다. 표에는 각 운영체제에서 사용 가능한 GitLab 버전이 나와 있습니다.
Linux 패키지는 벤더의 지원 수명 주기를 기준으로 제공합니다. 장기 지원(LTS) 버전이 있는 경우 이를 대상으로 하지만, 모든 운영체제가 LTS 모델을 따르는 것은 아닙니다.
패키지 빌드는 일반적으로 운영체제가 벤더의 지원 종료(EOL) 시점에 도달할 때까지 계속됩니다. 확장 지원이나 프리미엄 지원 기간이 아닌 표준 또는 유지 관리 지원 일정을 따릅니다.
다음과 같은 이유로 벤더 EOL 이전에 패키지 빌드를 중단할 수 있습니다:
- 비즈니스 고려 사항: 낮은 고객 채택률, 과도한 유지 관리 비용, 전략적 제품 방향 변경 등을 포함하되 이에 국한되지 않습니다.
- 기술적 제약: 타사 의존성, 보안 요구 사항, 또는 기반 기술 변경으로 인해 패키지 빌드를 지속하는 것이 비현실적이거나 불가능해지는 경우입니다.
- 벤더의 조치: 운영체제 벤더가 자사 소프트웨어 기능에 근본적인 영향을 미치는 변경을 하거나 필요한 구성 요소를 더 이상 사용할 수 없게 되는 경우입니다.
모든 운영체제 버전에 대한 지원을 중단하기 전에 최소 6개월 전에 공지하는 것을 목표로 합니다. 기술적 제약이나 벤더 제약으로 인해 더 짧은 공지가 필요한 경우 가능한 한 빨리 변경 사항을 전달합니다.
amd64와 x86_64는 동일한 64비트 아키텍처를 가리킵니다. arm64와 aarch64라는 이름도 상호 교환 가능하며
동일한 아키텍처를 가리킵니다.
| 운영체제 | 최초 지원 GitLab 버전 | 아키텍처 | 운영체제 EOL | 예상 마지막 지원 GitLab 버전 | 업스트림 릴리스 노트 |
|---|---|---|---|---|---|
| AlmaLinux 8 | GitLab CE / GitLab EE 14.5.0 | x86_64, aarch641 |
Mar 2029 | GitLab CE / GitLab EE 21.10.0 | AlmaLinux details |
| AlmaLinux 9 | GitLab CE / GitLab EE 16.0.0 | x86_64, aarch641 |
May 2032 | GitLab CE / GitLab EE 25.0.0 | AlmaLinux details |
| AlmaLinux 10 | GitLab CE / GitLab EE 18.6.0 | x86_64, aarch641 |
May 2035 | GitLab CE / GitLab EE 28.0.0 | AlmaLinux details |
| Amazon Linux 2 | GitLab CE / GitLab EE 14.9.0 | amd64, arm641 |
June 2026 | GitLab CE / GitLab EE 19.1.0 | Amazon Linux details |
| Amazon Linux 2023 | GitLab CE / GitLab EE 16.3.0 | amd64, arm641 |
June 2029 | GitLab CE / GitLab EE 22.1.0 | Amazon Linux details |
| Debian 11 | GitLab CE / GitLab EE 14.6.0 | amd64, arm641 |
Aug 2026 | GitLab CE / GitLab EE 19.3.0 | Debian Linux details |
| Debian 12 | GitLab CE / GitLab EE 16.1.0 | amd64, arm641 |
June 2028 | GitLab CE / GitLab EE 19.3.0 | Debian Linux details |
| Debian 13 | GitLab CE / GitLab EE 18.5.0 | amd64, arm641 |
June 2030 | GitLab CE / GitLab EE 23.1.0 | Debian Linux details |
| openSUSE Leap 15.6 | GitLab CE / GitLab EE 17.6.0 | x86_64, aarch641 |
Dec 2025 | TBD | openSUSE details |
| SUSE Linux Enterprise Server 12 | GitLab EE 9.0.0 | x86_64 |
Oct 2027 | TBD | SUSE Linux Enterprise Server details |
| SUSE Linux Enterprise Server 15 | GitLab EE 14.8.0 | x86_64 |
Dec 2024 | TBD | SUSE Linux Enterprise Server details |
| Oracle Linux 8 | GitLab CE / GitLab EE 12.8.1 | x86_64 |
July 2029 | GitLab CE / GitLab EE 22.2.0 | Oracle Linux details |
| Oracle Linux 9 | GitLab CE / GitLab EE 16.2.0 | x86_64 |
June 2032 | GitLab CE / GitLab EE 25.1.0 | Oracle Linux details |
| Oracle Linux 10 | GitLab CE / GitLab EE 18.6.0 | x86_64 |
June 2035 | GitLab CE / GitLab EE 28.1.0 | Oracle Linux details |
| Red Hat Enterprise Linux 8 | GitLab CE / GitLab EE 12.8.1 | x86_64, arm641 |
May 2029 | GitLab CE / GitLab EE 22.0.0 | Red Hat Enterprise Linux details |
| Red Hat Enterprise Linux 9 | GitLab CE / GitLab EE 16.0.0 | x86_64, arm641 |
May 2032 | GitLab CE / GitLab EE 25.0.0 | Red Hat Enterprise Linux details |
| Red Hat Enterprise Linux 10 | GitLab CE / GitLab EE 18.6.0 | x86_64, arm641 |
May 2035 | GitLab CE / GitLab EE 28.0.0 | Red Hat Enterprise Linux details |
| Ubuntu 22.04 | GitLab CE / GitLab EE 15.5.0 | amd64, arm641 |
April 2027 | GitLab CE / GitLab EE 19.11.0 | Ubuntu details. FIPS 패키지는 GitLab 18.4에서 추가되었습니다. Ubuntu 20.04에서 업그레이드하기 전에 업그레이드 참고 사항을 확인합니다. |
| Ubuntu 24.04 | GitLab CE / GitLab EE 17.1.0 | amd64, arm641 |
April 2029 | GitLab CE / GitLab EE 21.11.0 | Ubuntu details |
| Ubuntu 26.04 | GitLab CE / GitLab EE 19.3.0 | amd64, arm641 |
April 2031 | GitLab CE / GitLab EE 23.11.0 | Ubuntu details |
비공식적인, 지원되지 않는 설치 방법#
다음 설치 방법은 GitLab 커뮤니티에서 있는 그대로 제공하는 것이며 GitLab에서 지원하지 않습니다:
- Debian native package (제작: Pirate Praveen)
- FreeBSD package (제작: Torsten Zühlsdorff)
- Arch Linux package (제작: Arch Linux 커뮤니티)
- Puppet module (제작: Vox Pupuli)
- Ansible playbook (제작: Jeff Geerling)
- GitLab virtual appliance (KVM) (제작: OpenNebula)
- GitLab on Cloudron (Cloudron App Library를 통해 제공)
지원 종료(EOL) 버전#
지원이 중단된 운영체제 목록과 해당 운영체제에서 사용 가능한 마지막 GitLab 릴리스는 아래 표에서 확인할 수 있습니다:
| OS 버전 | 지원 종료 | 마지막 지원 GitLab 버전 |
|---|---|---|
| CentOS 6 and RHEL 6 | November 2020 | GitLab CE / GitLab EE 13.6 |
| CentOS 7 and RHEL 7 | June 2024 | GitLab CE / GitLab EE 17.7 |
| CentOS 8 | December 2021 | GitLab CE / GitLab EE 14.6 |
| Oracle Linux 7 | December 2024 | GitLab CE / GitLab EE 17.7 |
| Scientific Linux 7 | June 2024 | GitLab CE / GitLab EE 17.7 |
| Debian 7 Wheezy | May 2018 | GitLab CE / GitLab EE 11.6 |
| Debian 8 Jessie | June 2020 | GitLab CE / GitLab EE 13.3 |
| Debian 9 Stretch | June 2022 | GitLab CE / GitLab EE 15.2 |
| Debian 10 Buster | June 2024 | GitLab CE / GitLab EE 17.5 |
| OpenSUSE 42.1 | May 2017 | GitLab CE / GitLab EE 9.3 |
| OpenSUSE 42.2 | January 2018 | GitLab CE / GitLab EE 10.4 |
| OpenSUSE 42.3 | July 2019 | GitLab CE / GitLab EE 12.1 |
| OpenSUSE 13.2 | January 2017 | GitLab CE / GitLab EE 9.1 |
| OpenSUSE 15.0 | December 2019 | GitLab CE / GitLab EE 12.5 |
| OpenSUSE 15.1 | November 2020 | GitLab CE / GitLab EE 13.12 |
| OpenSUSE 15.2 | December 2021 | GitLab CE / GitLab EE 14.7 |
| OpenSUSE 15.3 | December 2022 | GitLab CE / GitLab EE 15.10 |
| OpenSUSE 15.4 | December 2023 | GitLab CE / GitLab EE 16.7 |
| OpenSUSE 15.5 | December 2024 | GitLab CE / GitLab EE 17.8 |
| SLES 15 SP2 | December 2024 | GitLab EE 18.1 |
| Raspbian Wheezy | May 2015 | GitLab CE 8.17 |
| Raspbian Jessie | May 2017 | GitLab CE 11.7 |
| Raspbian Stretch | June 2020 | GitLab CE 13.3 |
| Raspberry Pi OS Buster | June 2024 | GitLab CE 17.7 |
| Ubuntu 12.04 | April 2017 | GitLab CE / GitLab EE 9.1 |
| Ubuntu 14.04 | April 2019 | GitLab CE / GitLab EE 11.10 |
| Ubuntu 16.04 | April 2021 | GitLab CE / GitLab EE 13.12 |
| Ubuntu 18.04 | June 2023 | GitLab CE / GitLab EE 16.11 |
| Ubuntu 20.04 | May 2025 | GitLab CE / GitLab EE 18.11 |
Raspberry Pi OS(32비트 - Raspbian)#
GitLab은 Raspberry Pi OS(32비트 - Raspbian)에 대한 지원을 중단했으며, GitLab 17.11이 32비트 플랫폼에서 사용 가능한 마지막 버전입니다. GitLab 18.0부터는 Raspberry Pi OS(64비트)로 이전하여 Debian arm64 패키지를 사용해야 합니다.
32비트 OS에서 데이터를 백업하고 64비트 OS로 복원하는 방법은 PostgreSQL용 운영체제 업그레이드를 참고합니다.
Linux 패키지 제거#
Linux 패키지를 제거할 때는 데이터(리포지터리, 데이터베이스, 설정)를 유지하거나 모두 삭제하는 방법 중 하나를 선택할 수 있습니다:
-
선택 사항입니다. 패키지를 제거하기 전에 Linux 패키지가 생성한 모든 사용자 및 그룹을 제거하려면 다음을 실행합니다:
sudo gitlab-ctl stop && sudo gitlab-ctl remove-accounts[!note] 계정이나 그룹을 제거하는 데 문제가 있다면
userdel또는groupdel을 수동으로 실행하여 삭제합니다./home/에 남아 있는 사용자 홈 디렉터리도 수동으로 제거해야 할 수 있습니다. -
데이터를 유지할지 모두 삭제할지 선택합니다:
-
데이터(리포지터리, 데이터베이스, 설정)를 보존하려면 GitLab을 중지하고 감독 프로세스를 제거합니다:
sudo systemctl stop gitlab-runsvdir sudo systemctl disable gitlab-runsvdir sudo rm /usr/lib/systemd/system/gitlab-runsvdir.service sudo systemctl daemon-reload sudo systemctl reset-failed sudo gitlab-ctl uninstall -
모든 데이터를 삭제하려면:
sudo gitlab-ctl cleanse && sudo rm -r /opt/gitlab
-
-
패키지를 제거합니다(GitLab FOSS를 설치한 경우
gitlab-ce로 대체합니다):# Debian/Ubuntu sudo apt remove gitlab-ee# AlmaLinux/RHEL/Oracle Linux/Amazon Linux 2023 sudo dnf remove gitlab-ee# OpenSUSE Leap/SLES sudo zypper remove gitlab-ee# Amazon Linux 2 sudo yum remove gitlab-eeUbuntu 22.04 FIPS#
GitLab 18.4 이상에서는 Ubuntu 22.04용 FIPS 빌드를 사용할 수 있습니다.
업그레이드하기 전에:
-
모든 활성 사용자의 비밀번호 해시 마이그레이션을 확인합니다: GitLab 17.11 이상에서는 사용자가 로그인할 때 향상된 솔트로 비밀번호가 자동으로 재해시됩니다.
이 해시 마이그레이션을 완료하지 않은 사용자는 Ubuntu 22 FIPS 설치본에 로그인할 수 없으며 비밀번호를 재설정해야 합니다.
마이그레이션되지 않은 사용자를 찾으려면 Ubuntu 22.04로 업그레이드하기 전에 이 Rake 작업을 사용합니다.
-
GitLab secrets JSON을 확인합니다: 이제 Rails는 쿠키를 발급하기 위해 더 강력한 active dispatch 솔트를 요구합니다. Linux 패키지는 Ubuntu 22.04에서 기본적으로 충분한 길이의 정적 값을 사용합니다. 다만 Linux 패키지 설정에서 다음 키를 설정하여 이 솔트를 커스터마이즈할 수 있습니다:
gitlab_rails['signed_cookie_salt'] = 'custom value' gitlab_rails['authenticated_encrypted_cookie_salt'] = 'another custom value'이 값은
gitlab-secrets.json에 기록되며 모든 Rails 노드에서 동기화되어야 합니다. -
FIPS 140-3으로 업그레이드할 때 OAuth 토큰 마이그레이션을 준비합니다: GitLab 18.6.0, 18.5.2, 18.4.4에서는 FIPS 140-3 요구 사항을 준수하기 위해 OAuth 토큰에 SHA512 해싱을 도입했습니다. 이전에는 GitLab이 솔트 없는 PBKDF2를 사용했으며, 이는 Ubuntu 22.04와 같은 FIPS 140-3 준수 시스템과 호환되지 않습니다.
[!note] 이 마이그레이션은 Ubuntu 22.04와 같은 FIPS 140-3 준수 운영체제로 이전할 때만 필요합니다. 이미 이전 FIPS 버전(Ubuntu 20.04 등)에서 실행 중이거나 비FIPS 시스템을 유지하는 경우에는 변경할 필요가 없습니다.
비FIPS 인스턴스 또는 이전 FIPS 버전에서 FIPS 140-3 인스턴스로 마이그레이션하는 경우:
- GitLab 18.4 이상으로 업그레이드합니다.
- 활성 OAuth 액세스 토큰이 정상적인 사용 중에 자동으로 재해시될 수 있도록 충분한 시간을 둡니다.
- 새로 발급되는 모든 토큰이 FIPS 준수 해싱 알고리즘을 사용하도록 OAuth 애플리케이션 시크릿을 교체합니다.
- 토큰을 최근에 사용하지 않은 경우 OAuth 연동 애플리케이션에서 재인증이 필요할 수 있음을 사용자에게 안내합니다.
Footnotes
-