- 사전 요구 사항
- 다운타임
- 버전별 변경 사항
- 업그레이드 전에 백업
- 공식 리포지터리를 사용한 업그레이드
- 매뉴얼으로 다운로드한 패키지를 사용하여 업그레이드
- 제품 설명서 업그레이드
- 문제 해결
GitLab 패키지를 사용하여 GitLab 업그레이드
GitLab 패키지를 사용하여 GitLab를 새 버전으로 업그레이드할 수 있습니다.
사전 요구 사항
- 지원되는 업그레이드 경로를 확인하여 업그레이드할 시기를 결정합니다. 직접적으로 메이저 버전을 건너뛸 수 없습니다(예: 10.3에서 12.7로 한 번에 이동할 수 없음).
- 패키지 없는 설치에서 GitLab 패키지 설치로 업그레이드하는 경우, 패키지 없는 설치에서 GitLab 패키지 설치로의 업그레이드를 참조하세요.
- 모든 백그라운드 마이그레이션이 완전히 완료되었는지 확인하세요. 백그라운드 마이그레이션 완료 전에 업그레이드하면 데이터 손상이 발생할 수 있습니다. 메이저 및 마이너 릴리스 사이의 업그레이드는 백그라운드 마이그레이션이 완료되기 위해 최대 일주일 사이에 수행하는 것이 좋습니다.
- Gitaly 서버가 응용 프로그램 서버를 업그레이드하기 전에 더 최신 버전으로 업그레이드되어야 합니다. 이렇게 하면 응용 프로그램 서버의 gRPC 클라이언트가 이전 Gitaly 버전에서 지원하지 않는 RPC를 보내는 것을 방지합니다.
다운타임
- 단일 노드 설치의 경우, 업그레이드 진행 중에는 사용자가 GitLab에 접속할 수 없습니다. 사용자의 웹 브라우저에는 ‘배포 진행 중’ 메시지 또는 ‘502’ 오류가 표시됩니다.
- 멀티 노드 설치의 경우, 제로 다운타임 업그레이드를 수행하는 방법을 참조하세요.
- 멀티 노드 설치로의 업그레이드는 다운타임을 사용하여 수행할 수도 있습니다.
버전별 변경 사항
버전을 업그레이드하는 경우 일부 매뉴얼 개입이 필요할 수 있습니다. 자세한 내용은 업그레이드할 버전을 확인하세요:
이전 버전의 GitLab
이전 GitLab 버전에 대한 버전별 정보는 문서 리포지터리를 참조하세요. 리포지터리 문서에는 GitLab의 이전 버전에 대한 버전별 정보가 포함되어 있습니다.
예를 들어, GitLab 15.11의 문서에는 GitLab 11 이전 버전에 대한 정보가 포함되어 있습니다.
업그레이드 전에 백업
새로운 GitLab 버전을 설치하기 전에 GitLab 데이터베이스가 백업됩니다.
/etc/gitlab/skip-auto-backup에 빈 파일을 생성하여 자동 데이터베이스 백업을 건너뛸 수 있습니다(하지만, 새로운 백업을 유지하는 것이 매우 권장됩니다).
공식 리포지터리를 사용한 업그레이드
모든 GitLab 패키지는 GitLab 패키지 서버에 업로드됩니다. 5개의 리포지터리가 유지됩니다:
-
gitlab/gitlab-ee: 모든 커뮤니티 에디션 기능과 엔터프라이즈 에디션 기능을 모두 포함하는 전체 GitLab 패키지입니다. -
gitlab/gitlab-ce: 커뮤니티 에디션 기능만을 포함하는 가벼운 패키지입니다. -
gitlab/unstable: 릴리스 후보 및 기타 불안정한 버전이 포함됩니다. -
gitlab/nightly-builds: 매일 빌드 파일이 포함됩니다. -
gitlab/raspberry-pi2: Raspberry Pi 패키지용으로 빌드된 공식 커뮤니티 에디션 릴리스가 포함됩니다.
만약 GitLab 커뮤니티 에디션이나 엔터프라이즈 에디션을 설치했다면, 공식 GitLab 리포지터리가 이미 설정되어 있어야 합니다.
공식 리포지터리를 사용하여 최신 버전으로 업그레이드
정기적으로 GitLab을 업그레이드하는 경우, 예를 들어 매월 한 번, 패키지 매니저를 사용하여 최신 버전으로 업그레이드할 수 있습니다.
최신 GitLab 버전으로 업그레이드하려면:
# Ubuntu/데비안
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로 대체하세요.공식 리포지터리를 사용하여 특정 버전으로 업그레이드
리눅스 패키지 매니저는 기본적으로 설치 및 업그레이드를 위해 사용 가능한 패키지의 최신 버전을 설치합니다. 최신 주요 버전으로 직접 업그레이드하는 것은 다단계 업그레이드 경로를 요구하는 이전 GitLab 버전에서 문제가 발생할 수 있습니다. 업그레이드 경로는 여러 버전에 걸쳐 있을 수 있으므로 각 업그레이드에 특정 GitLab 패키지를 지정해야 합니다.
패키지 관리자의 설치 또는 업그레이드 명령에서 의도한 GitLab 버전 번호를 지정하려면:
-
설치된 패키지의 버전 번호를 식별합니다:
# Ubuntu/데비안 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/데비안 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로 대체하세요.제품 설명서 업그레이드
이 단계는 선택 사항입니다. 제품 설명서를 설치한 경우, 나중 버전으로 업그레이드하는 방법을 확인하세요.
문제 해결
자세한 정보는 문제 해결을 참조하세요.
도움말