업그레이드 경로 계획
Offering: GitLab Self-Managed
업그레이드 경로는 현재 GitLab 버전에서 업그레이드하려는 GitLab 버전으로 이동하는 단계를 포함합니다. 명시적으로 지정되지 않은 경우에도 첫 번째 패치 릴리스가 아닌 major.minor 릴리스의 최신 패치 릴리스로 GitLab을 업그레이드합니다.
업그레이드 경로는 현재 GitLab 버전에서 업그레이드하려는 GitLab 버전으로 이동하는 단계를 포함합니다. 업그레이드 경로를 결정하려면:
- 현재 버전이 업그레이드 경로에서 어디에 위치하는지 확인하며 필수 업그레이드 중간 단계를 포함합니다.
- GitLab 업그레이드 노트를 참조합니다.
명시적으로 지정되지 않은 경우에도 첫 번째 패치 릴리스가 아닌 major.minor 릴리스의 최신 패치 릴리스로 GitLab을 업그레이드합니다. 예를 들어 16.8.0 대신 16.8.7.
일부 major.minor 버전은 업그레이드 프로세스와 관련된 문제에 대한 수정이 있기 때문에 일부 또는 모든 환경에서 필수 중간 단계입니다.
필수 업그레이드 중간 단계#
업그레이드 경로에는 이후 버전으로 업그레이드하기 전에 반드시 업그레이드해야 하는 GitLab 버전인 필수 업그레이드 중간 단계가 포함됩니다. 업그레이드 경로를 따라 이동할 때:
- 현재 버전 이후의 필수 업그레이드 중간 단계로 업그레이드합니다.
- 업그레이드에 대한 백그라운드 마이그레이션이 완료될 때까지 기다립니다.
- 다음 필수 업그레이드 중간 단계로 업그레이드합니다.
GitLab 17.5 이상에서 인스턴스 관리자에게 예측 가능한 업그레이드 일정을 제공하기 위해 필수 업그레이드 중간 단계는 x.2.z, x.5.z, x.8.z, x.11.z 버전에서 발생합니다.
특정 마이너 버전의 사용 가능한 패치 릴리스를 확인하려면 GitLab 패키지 저장소에서 마이너 버전을 검색할 수 있습니다.
GitLab Helm 차트 인스턴스를 업그레이드하는 경우 GitLab Helm 차트 매핑 목록을 참조하세요.
필수 GitLab 19 업그레이드 중간 단계#
필수 업그레이드 중간 단계는 19.2, 19.5, 19.8, 19.11 버전에서 발생합니다.
이후 버전으로 업그레이드하기 전에 해당 GitLab 19 버전으로 업그레이드해야 합니다. 업그레이드하는 각 버전에 대해 GitLab 19의 업그레이드 노트를 참조하세요. 버전이 업그레이드 노트에 없으면 해당 버전에 대해 알아야 할 특별한 사항이 없습니다.
GitLab 패키지 저장소에서 패치 릴리스를 찾을 수 있습니다. 예를 들어 Ubuntu 24.04에서 최신 GitLab 19.2 Enterprise Edition 버전을 검색하려면:
-
https://packages.gitlab.com/ui/browse/gitlab/gitlab-ee/ubuntu/noble/pool/main/g/gitlab-ee로 이동합니다.
-
19.2를 검색어로 입력합니다.
필수 GitLab 18 업그레이드 중간 단계#
필수 업그레이드 중간 단계는 18.2, 18.5, 18.8, 18.11 버전에서 발생합니다.
이후 버전으로 업그레이드하기 전에 해당 GitLab 18 버전으로 업그레이드해야 합니다. 업그레이드하는 각 버전에 대해 GitLab 18의 업그레이드 노트를 참조하세요. 버전이 업그레이드 노트에 없으면 해당 버전에 대해 알아야 할 특별한 사항이 없습니다.
GitLab 패키지 저장소에서 패치 릴리스를 찾을 수 있습니다. 예를 들어 Ubuntu 24.04에서 최신 GitLab 18.2 Enterprise Edition 버전을 검색하려면:
-
https://packages.gitlab.com/ui/browse/gitlab/gitlab-ee/ubuntu/noble/pool/main/g/gitlab-ee로 이동합니다.
-
18.2를 검색어로 입력합니다.
필수 GitLab 17 업그레이드 중간 단계#
이후 버전으로 업그레이드하기 전에 이 GitLab 17 버전으로 업그레이드해야 합니다.
| 필수 버전 | 노트 |
|---|---|
| 17.11.7 | 최신 GitLab 17.11 패치 릴리스로 업그레이드합니다. GitLab 17.11.0 업그레이드 노트를 참조하세요. |
| 17.8.7 | 최신 GitLab 17.8 패치 릴리스로 업그레이드합니다. GitLab 17.8.0 업그레이드 노트를 참조하세요. |
| 17.5.5 | 최신 GitLab 17.5 패치 릴리스로 업그레이드합니다. GitLab 17.5.0 업그레이드 노트를 참조하세요. |
| 17.3.7 | 최신 GitLab 17.3 릴리스로 업그레이드합니다. GitLab 17.3.0 업그레이드 노트를 참조하세요. |
| 17.1.8 | ci_pipeline_messages 테이블이 큰 인스턴스에만 필요합니다. GitLab 17.1.0 업그레이드 노트를 참조하세요. |
필수 GitLab 16 업그레이드 중간 단계#
이후 버전으로 업그레이드하기 전에 이 GitLab 16 버전으로 업그레이드해야 합니다.
| 필수 버전 | 노트 |
|---|---|
| 16.11.10 | GitLab 16.11.0 업그레이드 노트를 참조하세요. |
| 16.7.10 | GitLab 16.8.0 업그레이드 노트 및 이후 GitLab 16.7 버전을 참조하세요. |
| 16.3.9 | GitLab 16.3.0 업그레이드 노트 및 이후 GitLab 16.3 버전을 참조하세요. |
| 16.2.11 | 대규모 파이프라인 변수 히스토리가 있는 GitLab 인스턴스에만 필요합니다. GitLab 16.2.0 업그레이드 노트를 참조하세요. |
| 16.1.8 | 패키지 레지스트리에 NPM 패키지가 있는 GitLab 인스턴스에만 필요합니다. GitLab 16.1.0 업그레이드 노트를 참조하세요. |
| 16.0.10 | 많은 사용자가 있거나 대규모 파이프라인 변수 히스토리가 있는 GitLab 인스턴스에만 필요합니다. GitLab 16.0.0 업그레이드 노트 및 이후 GitLab 16.0 버전을 참조하세요. |
필수 GitLab 15 업그레이드 중간 단계#
이후 버전으로 업그레이드하기 전에 이 GitLab 15 버전으로 업그레이드해야 합니다.
| 필수 버전 | 노트 |
|---|---|
| 15.11.13 | GitLab 15.11.0 업그레이드 노트 및 이후 GitLab 15.11 버전을 참조하세요. |
| 15.4.6 | GitLab 15.4.0 업그레이드 노트 및 이후 GitLab 15.4 버전을 참조하세요. |
| 15.1.6 | 여러 웹 노드가 있는 GitLab 인스턴스에만 필요합니다. GitLab 15.1.0 업그레이드 노트를 참조하세요. |
| 15.0.5 | GitLab 15.0 업그레이드 노트를 참조하세요. |
업그레이드 경로 도구#
현재 및 원하는 대상 GitLab 버전을 기반으로 필요한 업그레이드 중간 단계를 빠르게 계산하려면 업그레이드 경로 도구를 참조하세요. 이 도구는 GitLab 지원팀에서 유지 관리합니다.
피드백을 공유하고 도구를 개선하는 데 도움을 주려면 upgrade-path 프로젝트에서 이슈 또는 머지 리퀘스트를 만드세요.
이전 GitLab 버전#
이전 GitLab 버전으로 업그레이드하는 방법에 대한 정보는 문서 아카이브를 참조하세요. 아카이브의 문서 버전에는 이전 GitLab 버전에 대한 버전별 정보가 포함되어 있습니다.