GitLab 패키지를 사용하여 GitLab 업그레이드
GitLab 패키지를 사용하여 GitLab을 새 버전으로 업그레이드할 수 있습니다.
사전 조건
- 업그레이드 계획을 만드세요. 먼저 테스트 환경에서 업그레이드를 수행하고, 예기치 않은 중단 및 긴 다운타임의 위험을 줄이기 위해 롤백 계획을 갖는 것이 좋습니다.
- 지원되는 업그레이드 경로를 조회하여 업그레이드할 시기를 결정하세요. 주요 버전을 직접 건너뛸 수 없습니다(예: 10.3에서 12.7로 한 단계에서 이동할 수 없음).
- GitLab 패키지 설치로 업그레이드하는 비패키지 설치에서 업그레이드하는 경우, 비패키지 설치에서 GitLab 패키지 설치로 업그레이드를 참조하세요.
- 모든 백그라운드 마이그레이션이 완료되었는지 확인하세요.
백그라운드 마이그레이션이 완료되기 전에 업그레이드를 수행하면 데이터 손상으로 이어질 수 있습니다.
주요 및 보조 릴리스 간에 업그레이드를 수행하는 것은 주 1회 이상 하지 않는 것이 좋습니다. 이는 백그라운드 마이그레이션이 완료될 시간을 허용합니다. - Gitaly 서버는 애플리케이션 서버를 업그레이드하기 전에 새 버전으로 업그레이드되어야 합니다. 이는 애플리케이션 서버에서 gRPC 클라이언트가 이전 Gitaly 버전이 지원하지 않는 RPC를 전송하는 것을 방지합니다.
다운타임
- 단일 노드 설치의 경우, GitLab은 업그레이드 진행 중 사용자에게 제공되지 않습니다.
사용자의 웹 브라우저에는
배포 진행 중메시지 또는502오류가 표시됩니다. - 다중 노드 설치의 경우, 제로 다운타임 업그레이드를 수행하는 방법을 참조하세요.
- 다중 노드 설치로의 업그레이드는 다운타임과 함께 수행할 수도 있습니다.
버전별 변경 사항
버전 업그레이드에는 일부 수동 개입이 필요할 수 있습니다. 더 많은 정보를 보려면, 업그레이드할 버전을 확인하세요:
이전 GitLab 버전
이전 GitLab 버전에 대한 버전별 정보는 문서 아카이브를 참조하세요. 아카이브의 문서 버전은 GitLab의 더욱 이전 버전의 버전별 정보를 포함하고 있습니다.
예를 들어, GitLab 15.11 문서는 GitLab 11까지의 버전 정보를 포함하고 있습니다.
업그레이드 전에 백업
새로운 GitLab 버전을 설치하기 전에 GitLab 데이터베이스가 백업됩니다.
자동 데이터베이스 백업을 건너뛰려면 /etc/gitlab/skip-auto-backup에 빈 파일을 생성하세요:
sudo touch /etc/gitlab/skip-auto-backup
그럼에도 불구하고, 항상 최신의 백업을 유지하는 것이 강력하게 권장됩니다.
공식 리포지토리를 사용하여 업그레이드
모든 GitLab 패키지는 GitLab 패키지 서버에 게시됩니다.
여섯 개의 리포지토리가 유지 관리됩니다:
-
gitlab/gitlab-ee: 모든 커뮤니티 에디션 기능과 엔터프라이즈 에디션 기능이 포함된 전체 GitLab 패키지입니다. -
gitlab/gitlab-ce: 커뮤니티 에디션 기능만 포함된 축소된 패키지입니다. -
gitlab/gitlab-fips: FIPS 준수 빌드입니다. -
gitlab/unstable: 릴리스 후보 및 기타 불안정 버전입니다. -
gitlab/nightly-builds: 야간 빌드입니다. -
gitlab/raspberry-pi2: Raspberry Pi용으로 빌드된 공식 커뮤니티 에디션 릴리스입니다.
GitLab 커뮤니티 에디션 또는 엔터프라이즈 에디션을 설치한 경우, 공식 GitLab 리포지토리는 이미 설정되어 있어야 합니다.
최신 버전을 공식 리포지토리를 사용하여 업그레이드
GitLab을 정기적으로, 예를 들어 월 1회 업그레이드하는 경우 패키지 관리자를 사용하여 최신 버전으로 업그레이드할 수 있습니다.
최신 GitLab 버전으로 업그레이드하려면:
# Ubuntu/Debian
sudo apt update && sudo apt install gitlab-ee
# RHEL/CentOS 7 및 Amazon Linux 2
sudo yum install gitlab-ee
# RHEL/Almalinux 8/9 및 Amazon Linux 2023
sudo dnf install gitlab-ee
# SUSE
sudo zypper install gitlab-ee
gitlab-ee를 gitlab-ce로 바꾸십시오.공식 리포지토리를 사용하여 특정 버전으로 업그레이드
Linux 패키지 관리자는 기본적으로 설치 및 업그레이드를 위해 사용할 수 있는 최신 버전의 패키지를 설치합니다. 최신 주요 버전으로 직접 업그레이드하는 것은 여러 단계의
업그레이드 경로가 필요한 이전 GitLab 버전에서 문제가 발생할 수 있습니다. 업그레이드 경로는 여러 버전에 걸쳐 있을 수 있으므로 각 업그레이드마다 특정 GitLab 패키지를 지정해야 합니다.
패키지 관리자의 설치 또는 업그레이드 명령어에서 의도한 GitLab 버전 번호를 지정하려면:
-
설치된 패키지의 버전 번호를 확인합니다:
# Ubuntu/Debian sudo apt-cache madison gitlab-ee # RHEL/CentOS 7 및 Amazon Linux 2 yum --showduplicates list gitlab-ee # RHEL/Almalinux 8/9 및 Amazon Linux 2023 dnf --showduplicates list gitlab-ee # SUSE zypper search -s gitlab-ee -
다음 명령 중 하나를 사용하여 특정
gitlab-ee패키지를 설치하고<version>을 설치하려는 다음 지원 버전으로 바꿉니다
(설치 중인 버전이 지원되는 경로의 일부인지 확인하려면 업그레이드 경로를 검토하십시오):# Ubuntu/Debian sudo apt install gitlab-ee=<version>-ee.0 # RHEL/CentOS 7 및 Amazon Linux 2 sudo yum install gitlab-ee-<version>-ee.0.el7 # RHEL/Almalinux 8/9 sudo dnf install gitlab-ee-<version>-ee.0.el8 # Amazon Linux 2023 sudo dnf install gitlab-ee-<version>-ee.0.amazon2023 # OpenSUSE Leap 15.5 sudo zypper install gitlab-ee=<version>-ee.sles15 # SUSE Enterprise Server 12.2/12.5 sudo zypper install gitlab-ee=<version>-ee.0.sles12
ee를 ce로 바꾸십시오.패키지를 수동으로 다운로드
어떤 이유로 공식 리포지토리를 사용하지 않는 경우, 패키지를 다운로드하고 수동으로 설치할 수 있습니다. 이 방법은 GitLab을 처음 설치하거나 업그레이드하는 데 사용할 수 있습니다.
GitLab을 다운로드하고 설치 또는 업그레이드하려면:
-
패키지의 공식 리포지토리에 방문합니다.
-
설치하려는 버전을 검색하여 목록을 필터링합니다(예: 14.1.8).
단일 버전에 대해 여러 패키지가 있을 수 있으며, 각 지원되는 배포판 및 아키텍처에 대해 하나씩 있습니다. 파일 이름 옆에는 배포판을 나타내는 레이블이 있으며 파일 이름은 동일할 수 있습니다. -
설치하려는 패키지 버전을 찾고 목록에서 파일 이름을 선택합니다.
-
오른쪽 상단 모서리에서 다운로드를 선택합니다.
-
패키지가 다운로드된 후, 다음 명령 중 하나를 사용하여 설치합니다.
<package_name>을 다운로드한 패키지 이름으로 바꾸십시오:# Debian/Ubuntu dpkg -i <package_name> # RHEL/CentOS 7 및 Amazon Linux 2 rpm -Uvh <package_name> # RHEL/Almalinux 8/9 및 Amazon Linux 2023 dnf install <package_name> # SUSE zypper install <package_name>
gitlab-ee를 gitlab-ce로 바꾸십시오.제품 문서 업그레이드
이것은 선택 사항입니다. 제품 문서를 설치한 경우, 더 최신 버전으로 업그레이드하는 방법을 참조하세요.
문제 해결
자세한 내용은 문제 해결를 참조하세요.
도움말