• 업그레이드 경로 도구
• 이전 GitLab 버전

업그레이드 경로

여러 개의 GitLab 버전 간의 업그레이드는 다운타임을 수락하는 방법만 가능합니다. 다운타임을 피하려면 다운타임 없이 업그레이드하는 방법을 참조하십시오.

업그레이드 경로에는 필수 업그레이드 중지점이 포함되어 있습니다. 이는 나중의 버전으로 업그레이드하기 전에 반드시 업그레이드해야 하는 GitLab 버전입니다. 업그레이드 경로를 따를 때:

1. 현재 버전 이후의 필수 업그레이드 중지점으로 업그레이드합니다.
2. 업그레이드의 백그라운드 마이그레이션을 완료하도록 합니다.
3. 다음 필수 업그레이드 중지점으로 업그레이드합니다.

GitLab 17.5부터 필수 업그레이드 중지점은 일관되게 X.2, X.5, X.8 및 X.11과 같은 마이너 버전에 해당합니다. 이 스케줄은 인스턴스 관리자들에게 예측 가능한 업그레이드 일정을 제공합니다.

업그레이드 경로를 결정하려면:

1. 현재 버전이 있는 업그레이드 경로와 필수 업그레이드 중지점을 확인합니다:

   • GitLab 15에는 다음과 같은 필수 업그레이드 중지점이 포함됩니다:
     • 15.0.5.
     • 15.1.6. 여러 개의 웹 노드를 가진 GitLab 인스턴스.
     • 15.4.6.
     • 15.11.13. 최신 GitLab 15.11 릴리스.
   • GitLab 16에는 다음과 같은 필수 업그레이드 중지점이 포함됩니다:
     • 16.0.9. 사용자가 많은 경우 또는 대규모 파이프라인 변수 이력을 가진 인스턴스.
     • 16.1.7. 패키지 레지스트리에 NPM 패키지가 포함된 인스턴스.
     • 16.2.10. 대규모 파이프라인 변수 이력을 가진 인스턴스.
     • 16.3.8.
     • 16.7.z. 최신 GitLab 16.7 릴리스.
     • 16.11.z. 최신 GitLab 16.11 릴리스.
   • GitLab 17에는 다음과 같은 필수 업그레이드 중지점이 포함됩니다:
     • 17.3.z. 최신 GitLab 17.3 릴리스.
     • 17.y.z. 최신 GitLab 17 릴리스.

2. 버전별 업그레이드 지침을 참조하세요:

   • GitLab 17 변경 사항
   • GitLab 16 변경 사항
   • GitLab 15 변경 사항

명시적으로 지정되지 않은 경우에도 첫 번째 패치 릴리스가 아닌 major.minor 릴리스의 최신 패치 릴리스로 GitLab을 업그레이드합니다. 예를 들어, 16.8.0 대신 16.8.7을 사용합니다.

업그레이드 경로에서 중지해야 하는 major.minor 버전은 업그레이드 프로세스와 관련된 문제에 대한 수정 사항이 있을 수 있기 때문입니다.

특히 메이저 버전 주변에서는 중요한 데이터베이스 스키마 및 마이그레이션 패치가 최신 패치 릴리스에 포함될 수 있습니다.

업그레이드 경로 도구

현재 버전과 원하는 대상 GitLab 버전을 기반으로 필수 업그레이드 중지점을 빠르게 계산하려면 업그레이드 경로 도구를 참조하세요. 이 도구는 GitLab 지원 팀에 의해 유지됩니다.

피드백을 공유하고 도구를 개선하려면 upgrade-path 프로젝트에서 이슈를 작성하거나 머지 리퀘스트를 만드세요.

이전 GitLab 버전

이전 GitLab 버전으로 업그레이드하는 정보는 문서 아카이브를 참조하십시오. 아카이브 문서에는 GitLab의 이전 버전에 대한 버전별 정보가 포함되어 있습니다.

예를 들어, GitLab 15.11 문서에는 GitLab 12로 거슬러 올라가는 버전에 대한 정보가 포함되어 있습니다.