InfoGrab DocsInfoGrab Docs

GitLab 릴리스 및 유지 관리 정책

요약

Release and Deploy 팀이 유지 관리 정책의 소유자이며 요청된 모든 업데이트를 승인해야 합니다. GitLab은 메이저, 마이너, 패치 릴리스의 버전 명명과 릴리스 속도를 엄격한 정책으로 관리합니다. 드문 경우에 마지막 두 개의 월간 릴리스를 넘어 더 많은 릴리스로 백포팅하는 예외가 허용될 수 있습니다.

Release and Deploy 팀이 유지 관리 정책의 소유자이며 요청된 모든 업데이트를 승인해야 합니다. 이는 DRI 모델을 따르며 고객이 예측할 수 있도록 하기 위한 것입니다.

GitLab은 메이저, 마이너, 패치 릴리스의 버전 명명과 릴리스 속도를 엄격한 정책으로 관리합니다. 새 릴리스는 릴리스 노트에서 공지합니다.

현재 정책은 다음과 같습니다.

  • 언제든 현재 안정 릴리스에 대해서만 버그 수정을 백포팅합니다. 아래 패치 릴리스를 참고합니다.
  • 현재 안정 릴리스에 더해 이전 두 개의 월간 릴리스에도 보안 수정을 백포팅합니다. 일부 상황(아래 패치 릴리스에 설명)에서는 보안 취약점을 현재 안정 릴리스에만 처리하거나 백포팅 없이 정규 월간 릴리스 프로세스로 처리할 수 있습니다.

드문 경우에 마지막 두 개의 월간 릴리스를 넘어 더 많은 릴리스로 백포팅하는 예외가 허용될 수 있습니다. 필요한 절차는 정책 예외를 참고합니다.

버전 관리#

GitLab은 릴리스에 유의적 버전 관리(Semantic Versioning)를 사용합니다. (Major).(Minor).(Patch).

예를 들어 GitLab 버전 18.3.2의 경우 다음과 같습니다.

  • 18은 메이저 버전을 나타냅니다. 메이저 릴리스는 18.0.0이었으나 흔히 18.0으로 부릅니다.
  • 3은 마이너 버전을 나타냅니다. 마이너 릴리스는 18.3.0이었으나 흔히 18.3으로 부릅니다.
  • 2는 패치 번호를 나타냅니다.

버전 번호의 어느 부분이든 18.3.11처럼 여러 자릿수로 증가할 수 있습니다.

다음 표는 버전 유형과 릴리스 주기를 설명합니다.

버전 유형 설명 주기
메이저 중요한 변경이 있거나 공개 API에 하위 호환되지 않는 변경이 도입될 때입니다. 매년. 다음 메이저 릴리스는 2027년 5월 20일로 예정된 GitLab 20.0입니다. GitLab은 기본적으로 매년 5월에 메이저 릴리스를 예약합니다.
마이너 공개 API에 하위 호환되는 새 기능이 도입되거나, 소규모 기능이 도입되거나, 작은 기능 묶음이 배포될 때입니다. 매월, 매월 셋째 주 목요일로 예정됩니다.
패치 잘못된 동작을 고치는 하위 호환 버그 수정입니다. 패치 릴리스를 참고합니다. 월 2회, 월간 마이너 릴리스 전 주의 수요일과 후 주의 수요일로 예정됩니다.

유지 관리되는 버전#

다음 GitLab 릴리스 버전이 현재 유지 관리됩니다.

Note

GitLab 팀원이 다가오는 패치 릴리스에서 유지 관리되는 버전을 확인하려면, 내부 delivery: Release Information Grafana 대시보드의 Patch Release Information 섹션에 있는 Release Versions 패널을 참고합니다. 활성 월간 릴리스 날짜가 활성 패치 릴리스 날짜보다 앞서면 버전이 위의 유지 관리 버전 목록과 다릅니다.

버그 수정 백포트는 현재(첫 번째) 버전에 대해 유지 관리되며, 보안 수정 백포트는 모든 버전에 대해 유지 관리됩니다.

업그레이드 권장 사항#

가장 안전하고 기능이 풍부한 GitLab 환경으로 업그레이드할 수 있도록 최신 안정 릴리스를 실행하기를 권장합니다. 가장 최근의 안정 릴리스를 실행할 수 있도록 GitLab은 업데이트 프로세스를 안정적으로 유지하기 위해 노력하고 있습니다.

월간 릴리스 주기를 따를 수 없다면 고려해야 할 몇 가지 경우가 있습니다. 버전 간에 안전하게 업그레이드하려면 업그레이드 경로 가이드를 따릅니다.

Linux 패키지의 버전별 변경 문서는 다음에서 확인할 수 있습니다.

Linux 패키지를 로컬로 다운로드하여 수동으로 설치하는 방법에 대한 지침도 제공됩니다.

Linux 패키지에 포함된 PostgreSQL 업그레이드에 대한 단계별 가이드는 별도로 문서화되어 있습니다.

메이저 버전 업그레이드#

하위 호환되지 않는 변경과 마이그레이션은 메이저 버전에서만 이루어집니다. 자세한 내용은 GitLab 업그레이드 계획 만들기를 참고합니다.

패치 릴리스#

패치 릴리스에는 현재 안정 릴리스 GitLab 버전에 대한 버그 수정과, 현재 안정 릴리스에 더해 이전 두 개의 월간 릴리스에 대한 보안 수정이 포함됩니다.

이러한 정책이 있는 이유는 다음과 같습니다.

  1. GitLab에는 커뮤니티 배포판과 엔터프라이즈 배포판이 있어 소프트웨어를 테스트하고 릴리스하는 데 필요한 작업량이 두 배가 됩니다.
  2. 이전 릴리스로 백포팅하면 개발, 품질 보증, 지원 비용이 높아집니다.
  3. 병렬 버전을 지원하면 점진적 업그레이드가 어려워지는데, 점진적 업그레이드는 시간이 지나면서 복잡성이 누적되어 모든 사용자에게 업그레이드 문제를 일으킵니다. GitLab에는 점진적 업그레이드(및 설치)를 가능한 한 간단하게 만드는 전담 팀이 있습니다.
  4. GitLab 애플리케이션에서 생성되는 변경의 수가 많아 이전 릴리스로의 백포팅이 복잡해집니다. 여러 경우에 백포팅은 새 변경이 거치는 것과 같은 리뷰 프로세스를 거쳐야 합니다.
  5. 이전 릴리스에서 테스트가 통과하도록 하는 일은 경우에 따라 상당한 과제이며, 따라서 시간이 매우 많이 소요됩니다.

유의적 버전 관리를 깨뜨리게 되므로 패치 릴리스에 새 기능을 포함할 수 없습니다. 유의적 버전 관리를 깨뜨리면 다양한 내부 요구 사항(예: 조직 규정 준수, 새 기능 검증 등)을 따라야 하는 사용자에게 다음과 같은 결과가 생깁니다.

  1. 패치 버전에 포함된 버그 수정을 활용하기 위해 빠르게 업그레이드할 수 없습니다.
  2. 패치 버전에 포함된 보안 수정을 활용하기 위해 빠르게 업그레이드할 수 없습니다.
  3. 안정 GitLab 릴리스뿐 아니라 모든 패치 버전에 대한 광범위한 테스트로 구성된 요구 사항이 생깁니다.

심각도가 매우 높은 보안 문제에 대해서는 보안 수정을 훨씬 더 이전의 GitLab 릴리스 버전에도 백포팅한 선례가 있습니다. 필요한 절차는 정책 예외를 참고합니다.

일부 상황에서는 활성 릴리스와 현재 안정 릴리스만 업데이트하고 백포팅 없이 정규 월간 릴리스 프로세스로 취약점을 처리하기로 선택할 수 있습니다. 이 결정에 영향을 주는 요인에는 악용 가능성이 매우 낮은 경우, 취약점의 영향이 낮은 경우, 보안 수정의 복잡성, 그리고 최종적인 안정성 위험이 있습니다. 심각도가 높음(high) 및 치명적(critical)인 보안 문제는 항상 패치 릴리스로 처리합니다.

정책 예외#

예외적인 상황에서는 이 유지 관리 정책에서 벗어나야 할 수 있습니다. 여기에는 표준 정책이 다루는 범위보다 오래된 릴리스에 대한 수정 백포팅 요청과 릴리스 원칙에서 벗어나는 경우가 포함됩니다. 심각도 3 이하 요청은 자동으로 거절됩니다.

정책 예외를 요청하려면 예외 프로세스 지침을 따릅니다.

릴리스 예외 프로세스는 정책 예외를 요청하는 지침을 설명합니다. 예외는 정책 소유자인 릴리스 매니저의 재량으로 승인되며 SLO 약속에 따릅니다.

추가 정보#

다음 문서도 참고할 수 있습니다.

GitLab 릴리스 및 유지 관리 정책

GitLab v19.6
원문 보기

요약

Release and Deploy 팀이 유지 관리 정책의 소유자이며 요청된 모든 업데이트를 승인해야 합니다. GitLab은 메이저, 마이너, 패치 릴리스의 버전 명명과 릴리스 속도를 엄격한 정책으로 관리합니다. 드문 경우에 마지막 두 개의 월간 릴리스를 넘어 더 많은 릴리스로 백포팅하는 예외가 허용될 수 있습니다.

Release and Deploy 팀이 유지 관리 정책의 소유자이며 요청된 모든 업데이트를 승인해야 합니다. 이는 DRI 모델을 따르며 고객이 예측할 수 있도록 하기 위한 것입니다.

GitLab은 메이저, 마이너, 패치 릴리스의 버전 명명과 릴리스 속도를 엄격한 정책으로 관리합니다. 새 릴리스는 릴리스 노트에서 공지합니다.

현재 정책은 다음과 같습니다.

  • 언제든 현재 안정 릴리스에 대해서만 버그 수정을 백포팅합니다. 아래 패치 릴리스를 참고합니다.
  • 현재 안정 릴리스에 더해 이전 두 개의 월간 릴리스에도 보안 수정을 백포팅합니다. 일부 상황(아래 패치 릴리스에 설명)에서는 보안 취약점을 현재 안정 릴리스에만 처리하거나 백포팅 없이 정규 월간 릴리스 프로세스로 처리할 수 있습니다.

드문 경우에 마지막 두 개의 월간 릴리스를 넘어 더 많은 릴리스로 백포팅하는 예외가 허용될 수 있습니다. 필요한 절차는 정책 예외를 참고합니다.

버전 관리#

GitLab은 릴리스에 유의적 버전 관리(Semantic Versioning)를 사용합니다. (Major).(Minor).(Patch).

예를 들어 GitLab 버전 18.3.2의 경우 다음과 같습니다.

  • 18은 메이저 버전을 나타냅니다. 메이저 릴리스는 18.0.0이었으나 흔히 18.0으로 부릅니다.
  • 3은 마이너 버전을 나타냅니다. 마이너 릴리스는 18.3.0이었으나 흔히 18.3으로 부릅니다.
  • 2는 패치 번호를 나타냅니다.

버전 번호의 어느 부분이든 18.3.11처럼 여러 자릿수로 증가할 수 있습니다.

다음 표는 버전 유형과 릴리스 주기를 설명합니다.

버전 유형 설명 주기
메이저 중요한 변경이 있거나 공개 API에 하위 호환되지 않는 변경이 도입될 때입니다. 매년. 다음 메이저 릴리스는 2027년 5월 20일로 예정된 GitLab 20.0입니다. GitLab은 기본적으로 매년 5월에 메이저 릴리스를 예약합니다.
마이너 공개 API에 하위 호환되는 새 기능이 도입되거나, 소규모 기능이 도입되거나, 작은 기능 묶음이 배포될 때입니다. 매월, 매월 셋째 주 목요일로 예정됩니다.
패치 잘못된 동작을 고치는 하위 호환 버그 수정입니다. 패치 릴리스를 참고합니다. 월 2회, 월간 마이너 릴리스 전 주의 수요일과 후 주의 수요일로 예정됩니다.

유지 관리되는 버전#

다음 GitLab 릴리스 버전이 현재 유지 관리됩니다.

Note

GitLab 팀원이 다가오는 패치 릴리스에서 유지 관리되는 버전을 확인하려면, 내부 delivery: Release Information Grafana 대시보드의 Patch Release Information 섹션에 있는 Release Versions 패널을 참고합니다. 활성 월간 릴리스 날짜가 활성 패치 릴리스 날짜보다 앞서면 버전이 위의 유지 관리 버전 목록과 다릅니다.

버그 수정 백포트는 현재(첫 번째) 버전에 대해 유지 관리되며, 보안 수정 백포트는 모든 버전에 대해 유지 관리됩니다.

업그레이드 권장 사항#

가장 안전하고 기능이 풍부한 GitLab 환경으로 업그레이드할 수 있도록 최신 안정 릴리스를 실행하기를 권장합니다. 가장 최근의 안정 릴리스를 실행할 수 있도록 GitLab은 업데이트 프로세스를 안정적으로 유지하기 위해 노력하고 있습니다.

월간 릴리스 주기를 따를 수 없다면 고려해야 할 몇 가지 경우가 있습니다. 버전 간에 안전하게 업그레이드하려면 업그레이드 경로 가이드를 따릅니다.

Linux 패키지의 버전별 변경 문서는 다음에서 확인할 수 있습니다.

Linux 패키지를 로컬로 다운로드하여 수동으로 설치하는 방법에 대한 지침도 제공됩니다.

Linux 패키지에 포함된 PostgreSQL 업그레이드에 대한 단계별 가이드는 별도로 문서화되어 있습니다.

메이저 버전 업그레이드#

하위 호환되지 않는 변경과 마이그레이션은 메이저 버전에서만 이루어집니다. 자세한 내용은 GitLab 업그레이드 계획 만들기를 참고합니다.

패치 릴리스#

패치 릴리스에는 현재 안정 릴리스 GitLab 버전에 대한 버그 수정과, 현재 안정 릴리스에 더해 이전 두 개의 월간 릴리스에 대한 보안 수정이 포함됩니다.

이러한 정책이 있는 이유는 다음과 같습니다.

  1. GitLab에는 커뮤니티 배포판과 엔터프라이즈 배포판이 있어 소프트웨어를 테스트하고 릴리스하는 데 필요한 작업량이 두 배가 됩니다.
  2. 이전 릴리스로 백포팅하면 개발, 품질 보증, 지원 비용이 높아집니다.
  3. 병렬 버전을 지원하면 점진적 업그레이드가 어려워지는데, 점진적 업그레이드는 시간이 지나면서 복잡성이 누적되어 모든 사용자에게 업그레이드 문제를 일으킵니다. GitLab에는 점진적 업그레이드(및 설치)를 가능한 한 간단하게 만드는 전담 팀이 있습니다.
  4. GitLab 애플리케이션에서 생성되는 변경의 수가 많아 이전 릴리스로의 백포팅이 복잡해집니다. 여러 경우에 백포팅은 새 변경이 거치는 것과 같은 리뷰 프로세스를 거쳐야 합니다.
  5. 이전 릴리스에서 테스트가 통과하도록 하는 일은 경우에 따라 상당한 과제이며, 따라서 시간이 매우 많이 소요됩니다.

유의적 버전 관리를 깨뜨리게 되므로 패치 릴리스에 새 기능을 포함할 수 없습니다. 유의적 버전 관리를 깨뜨리면 다양한 내부 요구 사항(예: 조직 규정 준수, 새 기능 검증 등)을 따라야 하는 사용자에게 다음과 같은 결과가 생깁니다.

  1. 패치 버전에 포함된 버그 수정을 활용하기 위해 빠르게 업그레이드할 수 없습니다.
  2. 패치 버전에 포함된 보안 수정을 활용하기 위해 빠르게 업그레이드할 수 없습니다.
  3. 안정 GitLab 릴리스뿐 아니라 모든 패치 버전에 대한 광범위한 테스트로 구성된 요구 사항이 생깁니다.

심각도가 매우 높은 보안 문제에 대해서는 보안 수정을 훨씬 더 이전의 GitLab 릴리스 버전에도 백포팅한 선례가 있습니다. 필요한 절차는 정책 예외를 참고합니다.

일부 상황에서는 활성 릴리스와 현재 안정 릴리스만 업데이트하고 백포팅 없이 정규 월간 릴리스 프로세스로 취약점을 처리하기로 선택할 수 있습니다. 이 결정에 영향을 주는 요인에는 악용 가능성이 매우 낮은 경우, 취약점의 영향이 낮은 경우, 보안 수정의 복잡성, 그리고 최종적인 안정성 위험이 있습니다. 심각도가 높음(high) 및 치명적(critical)인 보안 문제는 항상 패치 릴리스로 처리합니다.

정책 예외#

예외적인 상황에서는 이 유지 관리 정책에서 벗어나야 할 수 있습니다. 여기에는 표준 정책이 다루는 범위보다 오래된 릴리스에 대한 수정 백포팅 요청과 릴리스 원칙에서 벗어나는 경우가 포함됩니다. 심각도 3 이하 요청은 자동으로 거절됩니다.

정책 예외를 요청하려면 예외 프로세스 지침을 따릅니다.

릴리스 예외 프로세스는 정책 예외를 요청하는 지침을 설명합니다. 예외는 정책 소유자인 릴리스 매니저의 재량으로 승인되며 SLO 약속에 따릅니다.

추가 정보#

다음 문서도 참고할 수 있습니다.