Linux 패키지 인스턴스 업그레이드
Offering: GitLab Self-Managed
Linux 패키지 인스턴스 업그레이드 지침은 단일 노드 또는 다중 노드 GitLab 인스턴스 여부에 따라 다릅니다. 단일 노드 Linux 패키지 GitLab 인스턴스를 업그레이드하려면 이 페이지의 정보를 따르세요. 제품 문서를 호스팅하는 경우 나중 버전으로 업그레이드할 수도 있습니다.
Linux 패키지 인스턴스 업그레이드 지침은 단일 노드 또는 다중 노드 GitLab 인스턴스 여부에 따라 다릅니다. 다중 노드 Linux 패키지 GitLab 인스턴스를 업그레이드하려면 다음을 참조하세요:
단일 노드 Linux 패키지 GitLab 인스턴스를 업그레이드하려면 이 페이지의 정보를 따르세요.
제품 문서를 호스팅하는 경우 나중 버전으로 업그레이드할 수도 있습니다.
사전 요건#
단일 노드 Linux 패키지 GitLab 인스턴스를 업그레이드하기 전에:
- 필수 정보를 읽고 필수 단계를 수행해야 합니다.
- 필요한 경우 지원되는 운영 체제로 업그레이드합니다.
- 운영 체제를 업그레이드할 때
glibc버전이 변경되면 인덱스 손상을 방지하기 위해 PostgreSQL용 운영 체제 업그레이드를 따라야 합니다. - PostgreSQL, Redis, Gitaly가 실행 중인지 확인합니다.
GitLab 데이터베이스는 최신 GitLab 버전을 설치하기 전에 백업됩니다. /etc/gitlab/skip-auto-backup에 빈 파일을 만들어 이 자동 데이터베이스 백업을 건너뛸 수 있습니다:
sudo touch /etc/gitlab/skip-auto-backup
그럼에도 불구하고 직접 최신 상태의 백업을 유지해야 합니다.
단일 노드 Linux 패키지 인스턴스 업그레이드#
단일 노드 Linux 패키지 인스턴스를 업그레이드하려면:
- 업그레이드 중에 유지 관리 모드 활성화를 고려합니다.
- 실행 중인 CI/CD 파이프라인 및 잡을 일시 중지합니다.
- GitLab Runner를 업그레이드하여 대상 GitLab 버전과 동일한 버전으로 맞춥니다.
- Linux 패키지로 GitLab 업그레이드.
업그레이드 후:
- 실행 중인 CI/CD 파이프라인 및 잡의 일시 중지를 해제합니다.
- 활성화된 경우 유지 관리 모드를 비활성화합니다.
- 업그레이드 상태 점검을 실행합니다.
Linux 패키지로 업그레이드#
단일 노드에서 실행 중인 GitLab을 업그레이드하거나 다중 노드 GitLab 인스턴스의 일부인 노드를 업그레이드하려면 다음 중 하나로 업그레이드합니다:
공식 리포지터리로 업그레이드 (권장)#
모든 GitLab 패키지는 GitLab 패키지 서버에 게시됩니다.
| 리포지터리 | 설명 |
|---|---|
gitlab/gitlab-ce |
커뮤니티 에디션 기능만 포함하는 최소 패키지. |
gitlab/gitlab-ee |
모든 커뮤니티 에디션 및 엔터프라이즈 에디션 기능이 포함된 전체 GitLab 패키지. |
gitlab/nightly-builds |
야간 빌드. |
gitlab/nightly-fips-builds |
야간 FIPS 호환 빌드. |
gitlab/gitlab-fips |
FIPS 호환 빌드. |
기본적으로 Linux 배포판 패키지 관리자는 사용 가능한 최신 버전의 패키지를 설치합니다. 업그레이드 경로에 여러 단계가 필요한 경우 최신 메이저 버전의 GitLab으로 직접 업그레이드할 수 없습니다. 업그레이드 경로에 여러 버전이 포함된 경우 각 업그레이드 시 특정 GitLab 패키지 버전을 지정해야 합니다.
업그레이드 경로에 중간 단계가 없는 경우 최신 버전으로 직접 업그레이드할 수 있습니다.
# GitLab Enterprise Edition (specific version)
sudo apt update && sudo apt install gitlab-ee=<version>-ee.0
# GitLab Community Edition (specific version)
sudo apt update && sudo apt install gitlab-ce=<version>-ce.0
# GitLab Enterprise Edition (latest version)
sudo apt update && sudo apt install gitlab-ee
# GitLab Community Edition (latest version)
sudo apt update && sudo apt install gitlab-ce
# GitLab Enterprise Edition (specific version)
sudo yum install gitlab-ee-<version>-ee.0.amazon2
# GitLab Community Edition (specific version)
sudo yum install gitlab-ce-<version>-ce.0.amazon2
# GitLab Enterprise Edition (latest version)
sudo yum install gitlab-ee
# GitLab Community Edition (latest version)
sudo yum install gitlab-ce
# GitLab Enterprise Edition (specific version)
sudo dnf install gitlab-ee-<version>-ee.0.el9
# GitLab Enterprise Edition (specific version)
sudo dnf install gitlab-ee-<version>-ee.0.el8
# GitLab Community Edition (specific version)
sudo dnf install gitlab-ce-<version>-ce.0.el9
# GitLab Community Edition (specific version)
sudo dnf install gitlab-ce-<version>-ce.0.el8
# GitLab Enterprise Edition (latest version)
sudo dnf install gitlab-ee
# GitLab Community Edition (latest version)
sudo dnf install gitlab-ce
# GitLab Enterprise Edition (specific version)
sudo dnf install gitlab-ee-<version>-ee.0.amazon2023
# GitLab Community Edition (specific version)
sudo dnf install gitlab-ce-<version>-ce.0.amazon2023
# GitLab Enterprise Edition (latest version)
sudo dnf install gitlab-ee
# GitLab Community Edition (latest version)
sudo dnf install gitlab-ce
# GitLab Enterprise Edition (specific version)
sudo zypper install gitlab-ee=<version>-ee.sles15
# GitLab Community Edition (specific version)
sudo zypper install gitlab-ce=<version>-ce.sles15
# GitLab Enterprise Edition (latest version)
sudo zypper install gitlab-ee
# GitLab Community Edition (latest version)
sudo zypper install gitlab-ce
# GitLab Enterprise Edition (specific version)
sudo zypper install gitlab-ee=<version>-ee.0.sles12
# GitLab Community Edition (specific version)
sudo zypper install gitlab-ce=<version>-ce.0.sles12
# GitLab Enterprise Edition (latest version)
sudo zypper install gitlab-ee
# GitLab Community Edition (latest version)
sudo zypper install gitlab-ce
다운로드한 패키지로 업그레이드#
공식 리포지터리를 사용하지 않으려면 패키지를 다운로드하여 수동으로 설치할 수 있습니다. 이 방법을 사용하면 처음 GitLab을 설치하거나 업그레이드할 수 있습니다.
GitLab을 다운로드하고 설치 또는 업그레이드하려면:
-
패키지의 공식 리포지터리로 이동합니다.
-
설치하려는 버전을 검색하여 목록을 필터링합니다. 예:
18.4.1. 단일 버전에 대해 여러 패키지가 존재할 수 있으며, 지원되는 각 배포판과 아키텍처에 대해 하나씩 있습니다. 일부 파일은 둘 이상의 배포판과 관련이 있으므로 파일 이름 옆에 배포판을 나타내는 레이블이 있습니다. -
설치하려는 패키지 버전을 찾아 목록에서 파일 이름을 선택합니다.
-
오른쪽 상단에서 Download를 선택합니다.
-
패키지가 다운로드되면 다음 명령 중 하나를 사용하여 설치하고
<package_name>을 다운로드한 패키지 이름으로 교체합니다:dpkg -i <package_name>rpm -Uvh <package_name>dnf install <package_name>zypper install <package_name>