• 업그레이드 경로 도구
• 이전 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.7 대신 16.8.0으로 업그레이드 하지 않도록 합니다.

업그레이드 경로에서 멈춰야 하는 major.minor 버전에는 업그레이드 프로세스와 관련된 문제에 대한 수정 사항이 포함될 수 있습니다.

특히 주요 버전과 관련하여, 중요한 데이터베이스 스키마 및 마이그레이션 패치가 최신 패치 릴리즈에 포함될 수 있습니다.

업그레이드 경로 도구

현재 및 원하는 대상 GitLab 버전을 기준으로 필요한 업그레이드 정류장을 빠르게 계산하려면 업그레이드 경로 도구를 참조하세요. 이 도구는 GitLab 지원 팀에 의해 유지 관리됩니다.

피드백을 공유하고 도구 개선에 도움을 주려면 업그레이드 경로 프로젝트에서 이슈 또는 병합 요청을 작성하세요.

이전 GitLab 버전

이전 GitLab 버전으로 업그레이드하는 방법에 대한 정보는 문서 아카이브를 참조하세요. 아카이브의 문서 버전은 이전 GitLab 버전에 대한 버전별 정보를 포함하고 있습니다.

예를 들어, GitLab 15.11의 문서는 GitLab 12까지의 버전 정보를 포함하고 있습니다.