GitLab 패키지를 사용하여 GitLab 업그레이드
GitLab을 새 버전으로 업그레이드하려면 GitLab 패키지를 사용하면 됩니다.
전제 조건
- 지원되는 업그레이드 경로를 확인하여 업그레이드 시기를 결정합니다. 직접적으로 주요 버전을 건너뛸 수는 없습니다(예: 10.3에서 12.7로 한 번에 이동할 수 없음).
- Non-package 설치에서 GitLab 패키지 설치로 업그레이드하는 경우 Non-package 설치에서 GitLab 패키지 설치로 업그레이드를 참조하세요.
- 백그라운드 마이그레이션이 완전히 완료되었는지 확인합니다. 백그라운드 마이그레이션이 완료되기 전에 업그레이드하는 것은 데이터 손상을 일으킬 수 있습니다. 마이그레이션을 마치기 전에 주요 및 마이너 릴리스 간에 업그레이드를 주간당 한 번 이상 하는 것을 권장합니다.
- 업그레이드하기 전에 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/unstable: 릴리스 후보 및 기타 불안정한 버전. -
gitlab/nightly-builds: 매일 밤 빌드. -
gitlab/raspberry-pi2: Raspberry Pi 패키지를 위해 구축된 공식 커뮤니티 에디션 릴리스.
GitLab 커뮤니티 에디션 또는 엔터프라이즈 에디션을 설치한 경우, 공식 GitLab 저장소가 이미 설정되어 있어야 합니다.
공식 저장소를 사용하여 최신 버전으로 업그레이드
정기적으로 GitLab을 업그레이드하는 경우, 한 달에 한 번씩 정도 업그레이드하려면 패키지 매니저를 사용하여 최신 버전으로 업그레이드할 수 있습니다.
최신 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 커뮤니티 에디션의 경우 gitlab-ee를 gitlab-ce로 바꿔주세요.
특정 버전으로 공식 저장소를 사용하여 업그레이드
리눅스 패키지 관리자는 일반적으로 설치 및 업그레이드를 위해 사용 가능한 최신 버전의 패키지를 설치합니다. 최신 주요 버전으로 직접 업그레이드하는 것은 다단계 업그레이드 경로가 필요한 이전 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패키지를 설치합니다.을(를) 다음 지원되는 버전으로 바꿔서 설치하고자 하는 버전을 확인합니다(설치하는 버전이 지원되는 경로에 포함되어 있는지 확인하세요([upgrade path](../index.md#upgrade-paths)를 확인하세요)): # 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
참고:
GitLab Community Edition의 경우 ee를 ce로 바꿉니다.
수동으로 다운로드한 패키지를 사용하여 업그레이드
참고: 패키지 저장소가 수동 설치보다 권장됩니다.
공식 저장소를 사용하지 않는 경우, 패키지를 다운로드하고 수동으로 설치할 수 있습니다. 이 방법은 GitLab을 처음 설치하거나 업그레이드하는 데 사용할 수 있습니다.
GitLab을 다운로드하고 설치하려면:
- 패키지의 공식 저장소에 방문합니다.
- 설치하려는 버전(예: 14.1.8)을 검색하여 목록을 필터링합니다. 한 버전에 대해 여러 패키지가 존재할 수 있으며, 각 지원되는 배포 및 아키텍처에 대해 하나씩 있습니다. 파일 이름 옆에 해당 배포를 나타내는 레이블이 있으며 파일 이름이 같을 수 있습니다.
- 설치하려는 패키지 버전을 찾고 목록에서 파일 이름을 선택합니다.
- 오른쪽 상단에서 다운로드를 선택합니다.
-
패키지를 다운로드한 후에 다음 명령 중 하나를 사용하여 설치하고,
을(를) 다운로드한 패키지 이름으로 바꿉니다: # 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 Community Edition의 경우 gitlab-ee를 gitlab-ce로 바꿉니다.
제품 설명서 업그레이드
이 단계는 선택 사항입니다. 제품 설명서를 설치한 경우, 더 높은 버전으로 업그레이드하는 방법을 확인하세요.
문제 해결
자세한 내용은 문제 해결을 참조하세요.
도움말