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 파이프라인 및 job 일시 중지.

• GitLab Runner를 업그레이드하여 타깃 GitLab 버전과 동일한 버전으로 맞추세요.

• Linux 패키지로 GitLab 업그레이드.

업그레이드 후:

• 실행 중인 CI/CD 파이프라인 및 job 일시 중지 해제.

• 활성화된 경우, 유지 관리 모드 비활성화.

• 업그레이드 상태 확인을 실행하세요.

Linux 패키지로 업그레이드#

단일 노드에서 실행 중인 GitLab을 업그레이드하거나, 다중 노드 GitLab 인스턴스의 일부인 노드를 업그레이드하려면 다음 중 하나를 사용하세요:

• 공식 리포지터리 사용.

• 다운로드한 패키지 사용.

공식 리포지터리로 업그레이드 (권장)#

모든 GitLab 패키지는 GitLab 패키지 서버에 게시됩니다.

기본적으로 Linux 배포판 패키지 관리자는 패키지의 최신 버전을 설치합니다. 업그레이드 경로에 여러 단계가 필요한 경우 최신 메이저 버전으로 직접 업그레이드할 수 없습니다. 업그레이드 경로에 여러 버전이 포함된 경우, 각 업그레이드 시 특정 GitLab 패키지 버전을 지정해야 합니다.

업그레이드 경로에 중간 단계가 없으면 최신 버전으로 직접 업그레이드할 수 있습니다.

Ubuntu/Debian

# 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

Amazon Linux 2

# 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

RHEL/Oracle Linux/AlmaLinux 8/9

# 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 upgrade gitlab-ee

# GitLab Community Edition (latest version)
sudo dnf upgrade gitlab-ce

Amazon Linux 2023

# 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 upgrade gitlab-ee

# GitLab Community Edition (latest version)
sudo dnf upgrade gitlab-ce

OpenSUSE Leap 15.5

# 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

SUSE Enterprise Server 12.2/12.5

# 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

공식 리포지터리에서 패키지 사전 다운로드#

업그레이드 시 설치 시간을 줄이거나 패키지 접근성을 테스트하기 위해, 공식 리포지터리에서 패키지를 다운로드한 후 나중에 설치할 수 있습니다:

Ubuntu/Debian

# GitLab Enterprise Edition
sudo apt-get install --download-only gitlab-ee=<version>-ee.0
sudo apt-get install /var/cache/apt/archives/gitlab-ee_<version>-ee.0_amd64.deb

# GitLab Community Edition
sudo apt-get install --download-only gitlab-ce=<version>-ce.0
sudo apt-get install /var/cache/apt/archives/gitlab-ce_<version>-ce.0_amd64.deb

Amazon Linux 2

# GitLab Enterprise Edition
sudo yumdownloader gitlab-ee-<version>-ee.0.amazon2
sudo yum install ./gitlab-ee-<version>-ee.0.amazon2.x86_64.rpm

# GitLab Community Edition
sudo yumdownloader gitlab-ce-<version>-ce.0.amazon2
sudo yum install ./gitlab-ce-<version>-ce.0.amazon2.x86_64.rpm

RHEL/Oracle Linux/AlmaLinux 8/9

# GitLab Enterprise Edition (el9)
sudo dnf download gitlab-ee-<version>-ee.0.el9
sudo dnf install ./gitlab-ee-<version>-ee.0.el9.x86_64.rpm

# GitLab Enterprise Edition (el8)
sudo dnf download gitlab-ee-<version>-ee.0.el8
sudo dnf install ./gitlab-ee-<version>-ee.0.el8.x86_64.rpm

# GitLab Community Edition (el9)
sudo dnf download gitlab-ce-<version>-ce.0.el9
sudo dnf install ./gitlab-ce-<version>-ce.0.el9.x86_64.rpm

# GitLab Community Edition (el8)
sudo dnf download gitlab-ce-<version>-ce.0.el8
sudo dnf install ./gitlab-ce-<version>-ce.0.el8.x86_64.rpm

Amazon Linux 2023

# GitLab Enterprise Edition
sudo dnf download gitlab-ee-<version>-ee.0.amazon2023
sudo dnf install ./gitlab-ee-<version>-ee.0.amazon2023.x86_64.rpm

# GitLab Community Edition
sudo dnf download gitlab-ce-<version>-ce.0.amazon2023
sudo dnf install ./gitlab-ce-<version>-ce.0.amazon2023.x86_64.rpm

OpenSUSE Leap 15.5

# GitLab Enterprise Edition
sudo zypper install --download-only gitlab-ee-<version>-ee.0.sles15.x86_64
sudo zypper install /var/cache/zypp/packages/gitlab_gitlab-ee/Packages/g/gitlab-ee-<version>-ee.sles15.x86_64.rpm

# GitLab Community Edition
sudo zypper install --download-only gitlab-ce-<version>-ce.0.sles15.x86_64
sudo zypper install /var/cache/zypp/packages/gitlab_gitlab-ce/Packages/g/gitlab-ce-<version>-ce.sles15.x86_64.rpm

SUSE Enterprise Server 12.2/12.5

# GitLab Enterprise Edition
sudo zypper install --download-only gitlab-ee-<version>-ee.0.sles12.x86_64
sudo zypper install /var/cache/zypp/packages/gitlab_gitlab-ee/Packages/g/gitlab-ee-<version>-ee.0.sles12.x86_64.rpm

# GitLab Community Edition
sudo zypper install --download-only gitlab-ce-<version>-ce.0.sles12.x86_64
sudo zypper install /var/cache/zypp/packages/gitlab_gitlab-ce/Packages/g/gitlab-ce-<version>-ce.0.sles12.x86_64.rpm

다운로드한 패키지로 업그레이드#

공식 리포지터리를 사용하지 않으려면 패키지를 다운로드하여 수동으로 설치할 수 있습니다. 이 방법은 GitLab을 처음 설치하거나 업그레이드하는 데 사용할 수 있습니다.

GitLab을 다운로드하여 설치하거나 업그레이드하려면:

• 패키지의 공식 리포지터리로 이동하세요.

• 설치할 버전을 검색하여 목록을 필터링하세요. 예: 18.4.1. 단일 버전에 대해 지원되는 배포판 및 아키텍처마다 여러 패키지가 존재할 수 있습니다. 일부 파일은 둘 이상의 배포판과 관련이 있기 때문에, 파일명 옆에 배포판을 나타내는 라벨이 있습니다.

• 설치하려는 패키지 버전을 찾아 목록에서 파일명을 선택하세요.

• 오른쪽 상단에서 다운로드를 선택하세요.

• 패키지가 다운로드되면, 다음 명령어 중 하나를 사용하고 <package_name>을 다운로드한 패키지 이름으로 바꿔서 설치하세요:

  Ubuntu/Debian

dpkg -i <package_name>

Amazon Linux 2

rpm -Uvh <package_name>

RHEL/Oracle Linux/AlmaLinux 8/9 and Amazon Linux 2023

dnf install <package_name>

SUSE and OpenSUSE

zypper install <package_name>