Linux 패키지를 사용하여 GitLab 설치
Offering: 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, aarch64 1 |
Mar 2029 | GitLab CE / GitLab EE 21.10.0 | AlmaLinux 세부 정보 |
| AlmaLinux 9 | GitLab CE / GitLab EE 16.0.0 | x86_64, aarch64 1 |
May 2032 | GitLab CE / GitLab EE 25.0.0 | AlmaLinux 세부 정보 |
| AlmaLinux 10 | GitLab CE / GitLab EE 18.6.0 | x86_64, aarch64 1 |
May 2035 | GitLab CE / GitLab EE 28.0.0 | AlmaLinux 세부 정보 |
| Amazon Linux 2 | GitLab CE / GitLab EE 14.9.0 | amd64, arm64 1 |
June 2026 | GitLab CE / GitLab EE 19.1.0 | Amazon Linux 세부 정보 |
| Amazon Linux 2023 | GitLab CE / GitLab EE 16.3.0 | amd64, arm64 1 |
June 2029 | GitLab CE / GitLab EE 22.1.0 | Amazon Linux 세부 정보 |
| Debian 11 | GitLab CE / GitLab EE 14.6.0 | amd64, arm64 1 |
Aug 2026 | GitLab CE / GitLab EE 19.3.0 | Debian Linux 세부 정보 |
| Debian 12 | GitLab CE / GitLab EE 16.1.0 | amd64, arm64 1 |
June 2028 | GitLab CE / GitLab EE 19.3.0 | Debian Linux 세부 정보 |
| Debian 13 | GitLab CE / GitLab EE 18.5.0 | amd64, arm64 1 |
June 2030 | GitLab CE / GitLab EE 23.1.0 | Debian Linux 세부 정보 |
| openSUSE Leap 15.6 | GitLab CE / GitLab EE 17.6.0 | x86_64, aarch64 1 |
Dec 2025 | TBD | openSUSE 세부 정보 |
| SUSE Linux Enterprise Server 12 | GitLab EE 9.0.0 | x86_64 |
Oct 2027 | TBD | SUSE Linux Enterprise Server 세부 정보 |
| SUSE Linux Enterprise Server 15 | GitLab EE 14.8.0 | x86_64 |
Dec 2024 | TBD | SUSE Linux Enterprise Server 세부 정보 |
| Oracle Linux 8 | GitLab CE / GitLab EE 12.8.1 | x86_64 |
July 2029 | GitLab CE / GitLab EE 22.2.0 | Oracle Linux 세부 정보 |
| Oracle Linux 9 | GitLab CE / GitLab EE 16.2.0 | x86_64 |
June 2032 | GitLab CE / GitLab EE 25.1.0 | Oracle Linux 세부 정보 |
| Oracle Linux 10 | GitLab CE / GitLab EE 18.6.0 | x86_64 |
June 2035 | GitLab CE / GitLab EE 28.1.0 | Oracle Linux 세부 정보 |
| Red Hat Enterprise Linux 8 | GitLab CE / GitLab EE 12.8.1 | x86_64, arm64 1 |
May 2029 | GitLab CE / GitLab EE 22.0.0 | Red Hat Enterprise Linux 세부 정보 |
| Red Hat Enterprise Linux 9 | GitLab CE / GitLab EE 16.0.0 | x86_64, arm64 1 |
May 2032 | GitLab CE / GitLab EE 25.0.0 | Red Hat Enterprise Linux 세부 정보 |
| Red Hat Enterprise Linux 10 | GitLab CE / GitLab EE 18.6.0 | x86_64, arm64 1 |
May 2035 | GitLab CE / GitLab EE 28.0.0 | Red Hat Enterprise Linux 세부 정보 |
| Ubuntu 22.04 | GitLab CE / GitLab EE 15.5.0 | amd64, arm64 1 |
April 2027 | GitLab CE / GitLab EE 19.11.0 | Ubuntu 세부 정보. FIPS 패키지는 GitLab 18.4에 추가되었습니다. Ubuntu 20.04에서 업그레이드하기 전에 업그레이드 노트를 확인하십시오. |
| Ubuntu 24.04 | GitLab CE / GitLab EE 17.1.0 | amd64, arm64 1 |
April 2029 | GitLab CE / GitLab EE 21.11.0 | Ubuntu 세부 정보 |
각주:
- ARM에서 GitLab 실행 시 알려진 이슈가 있습니다.
비공식, 지원되지 않는 설치 방법#
다음 설치 방법은 GitLab 커뮤니티에서 있는 그대로 제공되며 GitLab에서는 지원하지 않습니다:
- Debian 네이티브 패키지 (by Pirate Praveen)
- FreeBSD 패키지 (by Torsten Zühlsdorff)
- Arch Linux 패키지 (by the Arch Linux community)
- Puppet 모듈 (by Vox Pupuli)
- Ansible 플레이북 (by Jeff Geerling)
- GitLab 가상 어플라이언스(KVM) (by OpenNebula)
- Cloudron의 GitLab (via Cloudron App Library)
지원 종료 버전#
아래 표에서 사용 중단된 운영 체제 목록과 각 운영 체제에 대한 마지막 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은 GitLab 17.11이 32비트 플랫폼에서 사용 가능한 마지막 버전으로 Raspberry Pi OS(32비트 - Raspbian) 지원을 중단했습니다. 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는 이제 쿠키를 발급하기 위해 더 강력한 활성 디스패치 솔트가 필요합니다. 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 호환 시스템과 호환되지 않습니다.
이 마이그레이션은 FIPS 140-3 호환 운영 체제(예: Ubuntu 22.04)로 이전할 때만 필요합니다. 이미 이전 FIPS 버전(예: Ubuntu 20.04)에서 실행 중이거나 비FIPS 시스템을 유지하는 경우 변경이 필요하지 않습니다.
비FIPS 인스턴스 또는 이전 FIPS 버전에서 FIPS 140-3 인스턴스로 마이그레이션할 때:
- GitLab 18.4 이상으로 업그레이드합니다.
- 정상 사용 중에 활성 OAuth 액세스 토큰이 자동으로 재해시될 수 있도록 충분한 시간을 허용합니다.
- OAuth 애플리케이션 시크릿을 교체하여 새로 발행된 모든 토큰이 FIPS 호환 해싱 알고리즘을 사용하도록 합니다.
- 최근에 토큰이 사용되지 않은 경우 OAuth 통합 애플리케이션으로 재인증이 필요할 수 있음을 사용자에게 알립니다.
-