GitLab 18 업그레이드 참고 사항

GitLab 18의 마이너 및 패치 버전 업그레이드 시 주의사항과 알려진 문제에 대해 설명합니다.

이 페이지에는 GitLab 18의 마이너 및 패치 버전에 대한 업그레이드 정보가 포함되어 있습니다. 다음에 대한 지침을 검토하세요: 설치 유형. 현재 버전과 대상 버전 사이의 모든 버전. Helm 차트 설치에 대한 추가 정보는 Helm 차트 9.0 업그레이드 참고 사항 을 참조하세요. 필수 업그레이드 중지점 # 인스턴스 관리자에게 예측 가능한 업그레이드 일정을 제공하기 위해, 다음 버전에서 필수 업그레이드 중지점이 발생합니다: 18.2 18.5 18.8 18.11 17.11에서 업그레이드 시 주의 사항 # GitLab 18부터 PostgreSQL 14는 지원되지 않습니다 . GitLab 18.0 이상으로 업그레이드하기 전에 PostgreSQL을 버전 16.5 이상으로 업그레이드하세요. 자세한 내용은 설치 요구 사항 을 참조하세요. [!warning] 자동 데이터베이스 버전 업그레이드는 Linux 패키지를 사용하는 단일 노드 인스턴스에만 적용됩니다. Geo 인스턴스, Linux 패키지를 사용하는 고가용성 PostgreSQL, 또는 외부 PostgreSQL 데이터베이스(Amazon RDS 등)를 사용하는 경우와 같이 다른 모든 경우에는 PostgreSQL을 수동으로 업그레이드해야 합니다. 자세한 단계는 Geo 인스턴스 업그레이드 를 참조하세요. GitLab은 pg_dump 바이너리를 번들로 제공합니다. 외부 PostgreSQL 서버를 사용하는 경우, GitLab 데이터베이스 백업 생성 및 복원 모두에서 pg_dump 클라이언트 버전이 PostgreSQL 서버와 호환되는지 확인하세요. 2025년 9월 29일부터 Bitnami는 태그된 PostgreSQL 및 Redis 이미지 제공을 중단합니다. 번들 Redis 또는 Postgres와 함께 GitLab 차트를 사용하여 GitLab 17.11 이하를 배포하는 경우, 예상치 못한 다운타임을 방지하기 위해 레거시 저장소를 사용하도록 수동으로 값을 업데이트해야 합니다. 자세한 내용은 이슈 6089 를 참조하세요. 알려진 문제: 기능 플래그 ci_only_one_persistent_ref_creation 은 Rails가 업그레이드되었지만 Sidekiq가 버전 17.11에 남아 있는 경우 무중단 업그레이드 중에 파이프라인 실패를 유발합니다( 이슈 558808 의 세부 정보 참조). 예방 조치: Rails 콘솔을 열고 업그레이드하기 전에 기능 플래그를 활성화합니다: $ sudo gitlab-rails console Feature.enable(:ci_only_one_persistent_ref_creation) 이미 영향을 받은 경우: 다음 명령을 실행하고 실패한 파이프라인을 재시도합니다: $ sudo gitlab-rails console Rails.cache.delete_matched("pipeline:*:create_persistent_ref_service") 18.10.0 # Geo 설치 18.10.0 # 현재 8시간(28,800초) 하드코딩된 Geo blob 다운로드 타임아웃은 더 긴 전송 시간이 필요한