GitLab 19 업그레이드 노트
GitLab v19.6Offering: GitLab Self-Managed
요약
이 페이지에는 GitLab 19의 마이너 버전과 패치 버전에 대한 업그레이드 정보가 있습니다. GitLab Runner를 GitLab과 함께 업그레이드할 계획이라면, 사용 환경에 영향을 줄 수 있는 변경 사항이 있는지 GitLab Runner CHANGELOG를 검토합니다.
이 페이지에는 GitLab 19의 마이너 버전과 패치 버전에 대한 업그레이드 정보가 있습니다. 다음 항목에 해당하는 지침을 반드시 검토합니다.
- 사용 중인 설치 유형
- 현재 버전과 대상 버전 사이의 모든 버전
GitLab Runner를 GitLab과 함께 업그레이드할 계획이라면, 사용 환경에 영향을 줄 수 있는 변경 사항이 있는지 GitLab Runner CHANGELOG를 검토합니다.
Helm 차트 설치에 대한 추가 정보는 Helm 차트 10.0 업그레이드 노트를 참고합니다.
필수 업그레이드 중단점#
인스턴스 관리자가 예측 가능한 업그레이드 일정을 세울 수 있도록, 다음 버전에 필수 업그레이드 중단점이 있습니다.
19.219.519.819.11
업그레이드 노트 참조#
다음은 GitLab 마이너 버전별 업그레이드 노트의 참조 목록입니다. 각 목록 항목은 더 많은 정보가 있는 해당 섹션을 가리킵니다.
(Geo), (Linux package)처럼 설치 방법이 표시된 항목은
해당 방법에만 적용됩니다. 나머지 항목은 모든 설치 방법에 적용됩니다.
19.6으로 업그레이드#
GitLab 19.6으로 업그레이드하기 전에 다음을 검토합니다.
- [19.6.0] - 업로드 유형별 Geo 업로드 복제가 기본적으로 활성화됨 (Geo)
- [19.6.0] - GitLab Secrets Manager용 OpenBao 정책 (Linux package, Helm chart)
- [19.6.0] - NGINX 업데이트로 사용자 지정 NGINX 구성이 깨질 수 있음 (Linux package, Docker)
- [19.6.0] - Geo 보조 사이트가 동기화된 파일의 위치를 저장함 (Geo)
- [19.6.0] - 다중 노드 설치의 Service Ping 내부 API 시크릿 (Linux package)
GitLab 19.6 릴리스 노트와 GitLab 19.6의 지원 중단 및 제거도 함께 검토합니다.
19.5로 업그레이드#
필수 업그레이드 중단점입니다. 이후 버전으로 업그레이드하기 전에 이 버전으로 업그레이드해야 합니다. 필수 업그레이드 중단점을 참고합니다.
GitLab 19.5로 업그레이드하기 전에 다음을 검토합니다.
- [19.5.0] - Agent for Kubernetes 주소 기본값이 네이티브 gRPC로 변경됨 (Linux package, Helm chart)
- [19.5.0] - Duo Agent Platform 체크포인트 마이그레이션
- [19.5.0] - 업로드 유형별 Geo 업로드 체크섬 계산이 기본적으로 활성화됨 (Geo)
GitLab 19.5 릴리스 노트와 GitLab 19.5의 지원 중단 및 제거도 함께 검토합니다.
19.4로 업그레이드#
GitLab 19.4로 업그레이드하기 전에 다음을 검토합니다.
- [19.4.0] - Geo SSH 프록시가 기본적으로 활성화됨
- [19.4.0] -
SKIP_REPOSITORIES_PATHS를 사용한 복원은 기존 리포지터리를 유지함 - [19.4.0] - 신뢰할 수 없는 그룹 SAML ID가 신뢰 상태로 복원됨
- [19.4.0 - 19.4.3] - 감사 이벤트 스트리밍 job이 CI/CD job 토큰 요청으로 Redis를 가득 채움
GitLab 19.4 릴리스 노트도 함께 검토합니다.
19.3으로 업그레이드#
GitLab 19.3으로 업그레이드하기 전에 다음을 검토합니다.
- [19.3.0 - 19.3.1] - 새 그룹은 머지 리퀘스트 API 호출에 SHA 매개변수가 필요함
- [19.3.0] - Geo 검증 동시성 제한이 전역 총합으로 적용됨
- [19.3.0] - 시험 실행 모드가 더 이상
auth.log에 기록하지 않음 - [19.3.0] - 허용 목록 사용자의 요청에
throttle_user_allowlist가 표시되지 않음 - [19.3.0 - 19.3.7] - 감사 이벤트 스트리밍 job이 CI/CD job 토큰 요청으로 Redis를 가득 채움
GitLab 19.3 릴리스 노트와 GitLab 19.3의 지원 중단 및 제거도 함께 검토합니다.
19.2로 업그레이드#
필수 업그레이드 중단점입니다. 이후 버전으로 업그레이드하기 전에 이 버전으로 업그레이드해야 합니다. 필수 업그레이드 중단점을 참고합니다.
GitLab 19.2로 업그레이드하기 전에 다음을 검토합니다.
- [19.2.0] - 업그레이드 후 GitLab Duo Self-Hosted AI Gateway URL이 지워짐 (Linux package)
- [19.2.0 - 19.2.5] - 새 그룹은 머지 리퀘스트 API 호출에 SHA 매개변수가 필요함
GitLab 19.2 릴리스 노트와 GitLab 19.2의 지원 중단 및 제거도 함께 검토합니다.
19.0으로 업그레이드#
GitLab 19.0으로 업그레이드하기 전에 다음을 검토합니다.
- [19.0.0 - 19.0.1] - 컨테이너 레지스트리 메타데이터 데이터베이스가 prefer 모드로 기본 활성화됨 (Linux package, self-compiled)
- [19.0.0] - 컨테이너 레지스트리 S3 스토리지 드라이버가 s3_v2로 대체됨 (Linux package, self-compiled)
- [19.0.0 - 19.1.0] - Linux package RPM 설치의 고아
.agents및.claude디렉터리 (Linux package) - [19.0.0] - PostgreSQL 17 최소 요구 사항
- [19.0.0] - 웹훅 페이로드 타임스탬프가 ISO 8601 형식으로 변경됨
- [19.0.0] - Ubuntu 20.04에 대한 Linux package 지원이 중단됨 (Linux package)
- [19.0.0] - Redis 6 지원이 제거됨 (Linux package)
- [19.0.0] - Linux package에서 Mattermost가 제거됨 (Linux package)
- [19.0.0] - SUSE 배포판에 대한 Linux package 지원이 중단됨 (Linux package)
- [19.0.0] - Linux package와 GitLab Helm 차트에서 Spamcheck가 제거됨 (Linux package, Helm chart)
- [19.0.0] - NGINX Ingress가 Envoy Gateway 기반 Gateway API로 대체됨 (Helm chart)
- [19.0.0] - GitLab Helm 차트에서 번들 PostgreSQL, Redis, MinIO가 제거됨 (Helm chart)
- [19.0.0 - 19.0.1] - Geo 컨테이너 리포지터리 동기화가 OCI 이미지 인덱스 태그를 알림 없이 건너뜀 (Geo)
- [16.0.0 - 19.0.1] - 프로젝트가
nil일 때 Geo 디자인 관리 복제에서NoMethodError발생 (Geo)
GitLab 19.0 릴리스 노트와 GitLab 19.0의 지원 중단 및 제거도 함께 검토합니다.
업그레이드 노트#
GitLab 19의 구체적인 업그레이드 노트입니다.
업로드 유형별 Geo 업로드 복제가 기본적으로 활성화됨#
- 영향 대상: Geo
- 영향받는 버전: 19.6.0
GitLab 19.6에서 Geo는 GitLab 19.5에서 추가된 업로드 데이터 유형(예: 프로젝트 업로드, 그룹 업로드)을 통해 업로드를 복제하고 검증합니다.
레거시 업로드 데이터 유형의 geo_upload_replication 및 geo_upload_force_primary_checksumming 기능 플래그는
기본적으로 비활성화됩니다.
두 플래그 중 하나라도 명시적으로 설정했다면 새 기본값이 적용되지 않습니다.
기본값을 사용하려면 기본 사이트의 Rails 콘솔에서 저장된 값을 제거합니다.
Feature.remove(:geo_upload_replication)
Feature.remove(:geo_upload_force_primary_checksumming)
업그레이드하기 전에#
기본 사이트가 GitLab 19.5에서 시작된 체크섬 계산을 마칠 때까지 기다립니다. 진행 상황을 확인하려면 기본 사이트의 Rails 콘솔에서 다음 명령을 실행합니다.
lines = Gitlab::Geo::REPLICATOR_CLASSES.select { |r| r.model < ::Upload }.map do |r|
name = r.replicable_name.delete_suffix('_upload')
next format('%-45s disabled', name) unless r.replication_enabled?
done = r.checksummed_count + r.checksum_failed_count
total = r.primary_total_count
format('%-45s %10d / %-10d %s', name, done, total, done == total ? 'done' : 'pending')
end
puts lines
모든 업로드 데이터 유형이 done으로 표시되면 체크섬 계산이 끝난 것입니다.
업로드 데이터 유형이 disabled로 표시되면 해당 geo_<name>_upload_replication 기능 플래그가 꺼져 있는 것이며,
<name>은 출력에 나온 이름입니다.
업그레이드 후 Geo는 해당 데이터 유형을 복제하지 않습니다.
복제하려면 업그레이드 전에 기능 플래그를 켠 다음 명령을 다시 실행합니다.
체크섬 계산이 끝나기 전에 업그레이드해도 데이터는 손실되지 않습니다. 보조 사이트는 기본 사이트가 나머지 업로드의 체크섬을 계산하는 대로 해당 업로드를 검증합니다. 그때까지 검증 알림이 발생할 수 있습니다. 계획된 장애 조치 전에는 업로드가 검증될 때까지 기다립니다.
업그레이드한 후에#
각 보조 사이트에서 Geo는 새 데이터 유형의 모든 업로드를 추적하기 시작합니다.
- Sidekiq이 업로드마다 동기화 job을 하나씩 실행하므로, 업로드 수에 비례해 Sidekiq job이 일시적으로 늘어납니다.
- 보조 사이트에서 레거시 데이터 유형이 이미 검증한 업로드는 다시 다운로드하지 않습니다. Geo는 그 밖의 모든 업로드를 다운로드하고 체크섬을 계산합니다.
- 각 업로드의 첫 번째 검증은 기본 사이트의 체크섬을 재사용합니다. 그 이후 재검증은 기본 사이트의 재검증 간격에 따라 두 사이트에서 파일을 읽습니다.
그 밖의 변경 사항은 다음과 같습니다.
- Geo Sites 페이지에는 사이트마다 Uploads 행이 하나 표시되며, 이 행을 확장하면 각 업로드 데이터 유형을 볼 수 있습니다. 보조 사이트에서는 진행률이 0%에서 시작해 업로드가 동기화될수록 증가합니다.
- Geo 사이트 상태,
gitlab:geo:statusRake 태스크, Prometheus에서uploads_*필드와geo_uploads_*메트릭은 모든 업로드 데이터 유형의 합계를 보고하므로 기존 대시보드와 알림은 계속 동작합니다.<name>_uploads_*필드와geo_<name>_uploads_*메트릭은 업로드 데이터 유형별로 보고합니다. - 각 사이트의 Uploads 복제 세부 정보 페이지와 Data management의 Uploads 페이지에는 업로드 데이터 유형이 나열되며, 각 유형으로 연결되는 링크가 있습니다.
- GraphQL API에서
uploadRegistries필드는 모든 업로드 데이터 유형의 레지스트리를 반환합니다.- 각 레지스트리의
id가 업로드 ID로 변경되며, 이는fileId와 같은 값입니다. 업그레이드 전에 저장한 레지스트리 ID는 더 이상 같은 업로드와 일치하지 않습니다. - 실험적
geoRegistriesUpdate및geoRegistriesBulkUpdate뮤테이션은UPLOAD_REGISTRY에 대해 오류를 반환합니다. 대신PROJECT_UPLOAD_REGISTRY처럼 각 업로드 데이터 유형의 레지스트리 클래스를 사용합니다.
- 각 레지스트리의
레거시 업로드 데이터 유형으로 되돌리려면 두 기능 플래그를 모두 활성화합니다.
Feature.enable(:geo_upload_replication)
Feature.enable(:geo_upload_force_primary_checksumming)
그러면 보조 사이트는 레거시 데이터 유형을 다시 사용하고 플래그가 비활성화된 동안 생성된 업로드를 따라잡습니다.
GitLab Secrets Manager용 OpenBao 정책#
- 영향 대상: Linux package, Helm chart
- 영향받는 버전: 19.6.0 이상
GitLab 19.6에는 제한된 secrets_manager OpenBao 정책이 포함되어 있습니다.
이 정책은 GitLab이 시크릿 매니저를 프로비저닝할 때 OpenBao에서 수행할 수 있는 작업을 제어합니다.
제한된 정책은 GitLab이 사용하는 경로에 대해서만 액세스를 부여합니다.
OpenBao는 처음 초기화될 때만 정책을 생성하므로, GitLab을 업그레이드해도 기존 OpenBao 설치의 정책은 변경되지 않습니다.
업그레이드 후 gitlab:secrets_management:openbao:secrets_manager_policy:update Rake 태스크로
제한된 정책을 적용합니다.
자세한 내용은
GitLab용 OpenBao 정책 업데이트를 참고합니다.
NGINX 업데이트로 사용자 지정 NGINX 구성이 깨질 수 있음#
- 영향 대상: Linux package, Docker
- 영향받는 버전: 19.6.0 이상
GitLab 19.6은 Linux package에 번들된 NGINX 버전을 1.31.4에서 1.31.7로 업데이트합니다. 이 업데이트는 CVE-2026-15176, CVE-2026-93479, CVE-2026-95101, CVE-2026-97629, CVE-2026-97205의 다섯 가지 보안 문제를 수정합니다.
Linux package가 생성하는 NGINX 구성은 이러한 변경의 영향을 받지 않습니다. 다음 경우에만 영향을 받습니다.
- 예를 들어
nginx['custom_gitlab_server_config']또는nginx['custom_nginx_config']로 직접 NGINX 구성을 추가한 경우 - 직접 작성한 NGINX 구성 파일을 사용하는 경우
사용자 지정 구성을 깨뜨릴 수 있는 변경은 두 가지입니다.
- NGINX가 이제 크기가 0인 버퍼를 거부합니다.
proxy_buffer_size 0;처럼*_buffer_size지시문을0으로 설정하면 이제 구성 오류가 됩니다. NGINX 1.31.4는 이를 허용했지만 크기가 0인 버퍼는 한 번도 동작한 적이 없습니다. NGINX 1.31.7은 이 구성을 거부하고nginx -t가 오류를 보고합니다. 이 문제를 해결하려면 해당 지시문을 제거하거나 양수 크기로 설정해야 합니다. - NGINX가 이제 IP 주소 기준 인증서 검증을 더 엄격하게 수행합니다.
proxy_ssl_verify가on이고proxy_pass또는proxy_ssl_name이 IP 주소를 사용하면, NGINX는 이제 IP 주체 대체 이름(SAN) 항목에 대해서만 인증서를 대조합니다. IP 주소가 일반 이름(common name)이나 DNS SAN에만 있는 인증서는 이전에는 통과했지만 이제 검증에 실패합니다. NGINX는 이러한 인증서에502오류를 반환합니다. IP SAN이 있는 인증서는 이제 통과합니다. Linux package는proxy_ssl_verify를 켜지 않습니다. 이 문제를 해결하려면 백엔드 인증서에 IP 주소를 IP SAN으로 추가하거나, 인증서와 일치하는 호스트 이름을proxy_ssl_name에 사용해야 합니다.
업그레이드하기 전에 다음을 수행합니다.
-
인스턴스가 두 설정 중 하나를 사용하는지 확인합니다. 예를 들어 렌더링된 NGINX 구성을 검색합니다.
sudo grep -rnE '_buffer_size[[:space:]]+0[[:space:]]*;|proxy_ssl_verify[[:space:]]+on' /var/opt/gitlab/nginx/conf/ -
custom_nginx_config로 포함하는 추가 NGINX 구성 파일도 확인합니다. -
업그레이드의 영향을 받는 구성을 찾았다면 필요한 대로 구성을 변경합니다.
업그레이드한 후에 다음을 수행합니다.
sudo gitlab-ctl reconfigure를 실행합니다.sudo gitlab-ctl status nginx를 실행해 NGINX가 실행 중인지 확인합니다.
Helm 차트는 Linux package에 번들된 NGINX를 사용하지 않으므로 이 변경은 GitLab Helm 차트에 영향을 주지 않습니다.
Geo 보조 사이트가 동기화된 파일의 위치를 저장함#
- 영향 대상: Geo
- 영향받는 버전: 19.6.0
GitLab 19.6 이상에서 Geo 보조 사이트는 동기화하는 각 파일의 위치를 저장합니다. 업그레이드 후 각 보조 사이트의 백그라운드 job이 이전에 동기화된 파일의 위치를 저장합니다. 이 job은 데이터 유형마다 한 번 처리한 뒤 중지됩니다.
이 job은 GitLab 데이터베이스를 읽고 Geo 추적 데이터베이스에 쓰지만 파일을 읽거나 전송하지는 않습니다. 이 job은 파일 동기화 job과 별도로 실행되며, 한 번에 최대 의 절반까지 실행됩니다. job이 실행되는 동안 보조 사이트의 데이터베이스 부하가 너무 높다면 해당 제한을 낮출 수 있습니다. 자세한 내용은 Geo 튜닝을 참고합니다.
다중 노드 설치의 Service Ping 내부 API 시크릿#
- 영향 대상: Linux package
- 영향받는 버전: 19.6.0 이상
GitLab 19.6에서 /etc/gitlab/gitlab.rb에 gitlab_rails['service_ping_secret']이 설정되어 있지 않으면
gitlab-ctl reconfigure가 Service Ping 내부 API용 공유 시크릿을 생성합니다.
이 시크릿은 /etc/gitlab/gitlab-secrets.json에 저장되고
/var/opt/gitlab/gitlab-rails/etc/gitlab_service_ping_secret에 기록됩니다.
Service Ping 익스포터처럼 인스턴스를 대신해 Service Ping을 보고하는 서비스는
이 시크릿으로 인증합니다.
다중 노드 설치에서는 Puma 또는 Sidekiq을 실행하는 각 노드가 19.6에서 처음 reconfigure할 때
자체 시크릿을 생성합니다.
시크릿은 모든 노드에서 같아야 합니다. 그렇지 않으면 요청을 받은 노드의 시크릿이 다를 때
Service Ping 내부 API에 대한 요청이 401 Unauthorized로 실패합니다.
이 시크릿에 의존하는 저장된 데이터는 없으므로 시크릿이 일치하지 않아도 기존 데이터에는 영향이 없습니다.
차트가 모든 파드가 공유하는 Kubernetes Secret 하나를 생성하므로 Helm 차트 설치는 영향을 받지 않습니다.
모든 노드에 같은 시크릿을 지정하려면 업그레이드 전에 시크릿을 설정하거나 업그레이드 후에 시크릿을 복구합니다. 시크릿 파일이 변경되면 reconfigure가 Puma와 Sidekiq을 재시작하므로 별도로 재시작할 필요는 없습니다. 나중에 시크릿을 교체하려면 Service Ping 내부 API 시크릿 설정 또는 교체를 참고합니다.
업그레이드 전에 시크릿 설정#
업그레이드하기 전에 Puma 또는 Sidekiq을 실행하는 모든 노드에서 다음을 수행합니다.
-
/etc/gitlab/gitlab.rb를 편집해 모든 노드에 같은 값을 설정합니다. 값은 Base64로 인코딩된 32바이트 문자열이어야 합니다. 예를 들어openssl rand -base64 32의 출력을 사용합니다.gitlab_rails['service_ping_secret'] = '<base64-encoded 32-byte value>' -
평소처럼 노드를 업그레이드합니다.
업그레이드 후 시크릿 복구#
모든 노드를 이미 업그레이드했는데 시크릿이 서로 다른 경우 다음을 수행합니다.
-
Puma 또는 Sidekiq을 실행하는 노드 하나를 기준 노드로 선택합니다.
-
Puma 또는 Sidekiq을 실행하는 나머지 모든 노드에서 기존 구성을 백업합니다.
sudo gitlab-ctl backup-etc -
기준 노드의
/etc/gitlab/gitlab-secrets.json을 나머지 모든 노드로 복사해 같은 이름의 파일을 대체합니다. -
파일을 받은 모든 노드를 reconfigure합니다.
sudo gitlab-ctl reconfigure
Agent for Kubernetes 주소 기본값이 네이티브 gRPC로 변경됨#
- 영향 대상: Linux package, Helm chart
- 영향받는 버전: 19.5.0 이상
GitLab 19.5에서 Linux package와 GitLab Helm 차트는 기본적으로 WebSocket 주소 대신 네이티브 gRPC 주소를
Agent for Kubernetes에 알립니다. 이 주소는 에이전트 설치 지침에 표시되며
gitlab_kas.external_url에 저장됩니다.
- Linux package:
external_url이 상대 URL 루트 없이 HTTPS를 사용하고 번들 NGINX가 HTTP/2로 TLS를 종료하는 경우,wss://gitlab.example.com/-/kubernetes-agent/대신grpcs://gitlab.example.com을 사용합니다. - Helm 차트: Gateway API 또는 NGINX Ingress 공급자를 사용하는 경우,
wss://kas.example.com대신grpcs://kas.example.com을 사용합니다.
그 밖의 구성에서는 WebSocket 주소가 유지됩니다. GitLab Relay(KAS)가 같은 포트에서 두 프로토콜을 모두 제공하므로 WebSocket으로 이미 연결된 에이전트는 영향을 받지 않습니다. 업그레이드 후에 설치한 에이전트는 gRPC로 연결하며, 이 연결에는 종단 간 HTTP/2가 필요합니다. 클러스터와 GitLab 사이의 프록시가 HTTP/2를 전달하지 않으면 새 에이전트가 연결에 실패하며, 이 오류는 네트워크 문제처럼 보입니다. 예를 들어 WAF나 TLS 검사 프록시가 HTTP/1.1로 GitLab에 연결할 수 있습니다. 이 경우 주소를 명시적으로 설정해 계속 WebSocket을 알리도록 합니다.
- Linux package:
/etc/gitlab/gitlab.rb의gitlab_rails['gitlab_kas_external_url'] - Helm 차트:
global.appConfig.gitlab_kas.externalUrl
자세한 내용은 GitLab Relay(KAS)와 KAS 차트 문서를 참고합니다.
Duo Agent Platform 체크포인트 마이그레이션#
- 영향 대상: 모든 설치 방법
- 영향받는 버전: 19.5.0
GitLab 19.5는 BackfillDuoWorkflowsCheckpointHeadersAndBlobs라는 배치 백그라운드 마이그레이션을 큐에 추가합니다.
이 마이그레이션은 GitLab Duo Agent Platform 세션 체크포인트를 p_duo_workflows_checkpoints 테이블에서
p_duo_workflows_checkpoint_headers 및 p_duo_workflows_checkpoint_blobs 테이블로 복사합니다. 이 형식이 애플리케이션이 현재 기록하고 읽는 스토리지 형식입니다.
마이그레이션은 업그레이드 후 백그라운드에서 실행됩니다. 아직 새 형식으로 저장되지 않은 행만 처리하며, 데이터가 보존 기간을 지났으므로 30일보다 오래된 세션은 건너뜁니다.
업그레이드 전에 생성된 세션은 마이그레이션이 실행되는 동안에도 계속 읽을 수 있습니다. 이후 GitLab
버전에서 이전 테이블을 읽는 코드가 제거되므로 해당 업그레이드 전에 이 마이그레이션이 끝나야 합니다. 19.5를 넘어 업그레이드하기 전에
Admin area > Background migrations 페이지(/admin/background_migrations)에서 마이그레이션 상태를 확인합니다. 상태를 확인하는 방법과
마이그레이션을 수동으로 끝내는 방법은
백그라운드 마이그레이션을 참고합니다.
마이그레이션에 걸리는 시간은 인스턴스가 최근 30일 동안 저장한 세션 수에 따라 달라집니다. 처리되는 체크포인트 하나가 수 메가바이트일 수 있습니다.
이 마이그레이션은 데이터를 복사할 뿐 p_duo_workflows_checkpoints의 행을 삭제하지 않으므로
마이그레이션이 실행되는 동안 PostgreSQL 디스크 사용량이 증가합니다. 이전 테이블이 사용하는 공간은
일별 파티션이 30일 보존 기간을 지나 삭제될 때에야 확보됩니다.
세션이 많은 인스턴스에서는 디스크 사용량이 시간당 수 기가바이트씩 증가할 수 있습니다.
GitLab 19.5로 업그레이드하기 전에 다음을 수행합니다.
-
이전 테이블의 크기를 확인합니다. PostgreSQL 콘솔에서(예: Linux package 설치에서는
sudo gitlab-psql) 다음을 실행합니다.SELECT pg_size_pretty(sum(pg_total_relation_size(relid))) FROM pg_partition_tree('p_duo_workflows_checkpoints') WHERE isleaf; -
PostgreSQL 데이터 볼륨에 이 크기 이상의 여유 공간과 마이그레이션이 생성하는 선행 기록 로그(WAL)를 위한 공간이 있는지 확인합니다. 데이터베이스 복제본이나 WAL 아카이빙을 사용한다면 해당 볼륨의 여유 공간도 확인합니다.
마이그레이션이 실행되는 동안 디스크 공간이 부족해지면 마이그레이션을 일시 중지하고
디스크 공간을 추가한 다음 마이그레이션을 다시 시작합니다. 배치 백그라운드 마이그레이션 API로도
마이그레이션을 일시 중지하고 다시 시작할 수 있습니다.
active 상태의 마이그레이션만 일시 중지할 수 있습니다.
업로드 유형별 Geo 업로드 체크섬 계산이 기본적으로 활성화됨#
- 영향 대상: Geo
- 영향받는 버전: 19.5.0
GitLab 19.5에서 Geo는 프로젝트 업로드, 그룹 업로드처럼 업로드 종류마다 하나씩, 업로드용 데이터 유형 23개를 새로 추가합니다. 새 데이터 유형은 기본 사이트만 사용하며, 기본 사이트가 백그라운드에서 각 유형의 업로드 체크섬을 계산합니다. 보조 사이트는 기존 업로드 데이터 유형으로 계속 업로드를 복제하고 검증합니다.
기본 사이트에서 대부분의 업로드는 기존 업로드 데이터 유형의 체크섬을 재사용하므로, GitLab은
아직 체크섬 계산에 성공하지 않은 파일만 읽습니다.
체크섬 계산은 기본 사이트의 Verification concurrency limit를 다른 모든 데이터 유형과 공유합니다.
업로드가 수백만 개인 사이트에서는 이전 버전에서 업그레이드한 많은 사이트가 사용하는 제한값 1에서 체크섬 계산에 며칠이 걸릴 수 있습니다.
체크섬을 계산하는 동안 제한을 높이고, 데이터베이스 부하를 모니터링한 뒤, 이후에 이전 값으로 복원할 수 있습니다.
GitLab 테스트에서 제한을 1에서 10으로 높이자 추가 데이터베이스 부하는 적으면서 업로드 체크섬 계산이 약 8배 빨라졌습니다.
자세한 내용은 Geo 튜닝을 참고합니다.
데이터 유형 하나의 체크섬 계산을 중지하려면
두 기능 플래그를 모두 비활성화해야 합니다.
geo_<name>_upload_replication과 geo_<name>_upload_force_primary_checksumming이며, <name>은 예를 들어 project 또는 group입니다.
_replication 플래그만 비활성화해서는 체크섬 계산이 중지되지 않습니다.
Geo SSH 프록시가 기본적으로 활성화됨#
- 영향 대상: Helm 차트
- 영향받는 버전: 19.4.0
GitLab 19.4 이상에서는 다음 기능 플래그가 기본적으로 활성화됩니다.
geo_proxy_fetch_ssh_to_primarygeo_proxy_push_ssh_to_primary
이 변경 때문에 번들 NGINX Ingress를 사용하는 Cloud Native GitLab 배포는 다음 중 하나를 수행해야 합니다.
- 이 롤아웃 전에 Envoy Gateway 기반 Gateway API를 사용하도록 업그레이드합니다.
- 롤아웃 후에 두 기능 플래그를 모두 비활성화합니다.
그렇지 않으면 Geo 보조 사이트를 통한 SSH 페치와 푸시가 멈추거나 시간 초과될 수 있습니다.
자세한 내용은 SSH 프록시에 대한 Geo 문제 해결 문서를 참고합니다.
SKIP_REPOSITORIES_PATHS를 사용한 복원은 기존 리포지터리를 유지함#
- 영향 대상: 모든 설치 방법
- 영향받는 버전: 19.4.0
GitLab 19.4 이상에서는 SKIP_REPOSITORIES_PATHS가 복원에서 리포지터리를 제외하면,
복원 시 인스턴스에 이미 있는 해당 리포지터리가 유지됩니다. 이는 복원에 이 옵션을 지정한 경우와
백업을 만들 때 이 옵션을 사용한 경우(이전 버전에서 만든 백업 포함) 모두에 적용되며,
복원이 백업 매니페스트(backup_information.yml)에서도 제외된 경로를 읽기 때문입니다.
이전에는 두 경우 모두, 그리고 REPOSITORIES_PATHS도 함께 지정하지 않은 한, 복원이 먼저
복원 대상 스토리지의 모든 리포지터리를 제거했습니다. 제외된 리포지터리도 함께 제거되었고,
복원 자체에서도 제외되었으므로 해당 백업으로는 이를 되살릴 수 없었습니다.
REPOSITORIES_PATHS와 SKIP_REPOSITORIES_PATHS 어느 쪽도 적용되지 않는 전체 복원은 여전히
백업에 포함되지 않은 리포지터리를 제거합니다.
복원 절차가 리포지터리를 비우기 위해 이전 동작에 의존한다면, 대신 전체 복원을 실행하거나 복원 전에 해당 리포지터리를 제거합니다.
자세한 내용은 특정 리포지터리 복원과 이슈 610910을 참고합니다.
신뢰할 수 없는 그룹 SAML ID가 신뢰 상태로 복원됨#
- 영향 대상: 모든 설치 방법
- 영향받는 버전: 19.4.0
GitLab 18.10, 18.11, 19.0, 19.1, 19.2, 19.3에서는 SAML ID API로 그룹 SAML ID의 extern_uid를 업데이트하면 해당 ID가
신뢰할 수 없는 것으로 표시되었고, 영향받는 사용자는 ID를 다시 연결할 때까지
SAML 싱글 사인온으로 로그인할 수 없었습니다.
GitLab 19.4는 이 동작을 되돌립니다. 그룹 Owner가 그룹 ID 공급자를 제어하므로,
그룹 Owner는 이미 ID 공급자를 통해 어떤 NameID도 주장할 수 있습니다. 배포 후 마이그레이션이
모든 그룹 SAML ID의 trusted_extern_uid를 다시 true로 설정하므로, 영향받은 사용자는 다시
SAML 싱글 사인온으로 로그인할 수 있습니다.
자세한 내용은 이슈 608236을 참고합니다.
감사 이벤트 스트리밍 job이 CI/CD job 토큰 요청으로 Redis를 가득 채움#
-
영향 대상: 모든 설치 방법
-
영향받는 버전:
릴리스 영향받는 패치 릴리스 수정된 패치 수준 19.3 19.3.0 - 19.3.7 19.3.8 19.4 19.4.0 - 19.4.3 19.4.5
GitLab 19.3은 새 속도 제한기를 기본적으로 켭니다.
CI/CD job 토큰으로 인증하는 요청마다
속도 제한기가 엔드포인트보다 먼저 사용자를 식별합니다.
식별할 때마다 user_authenticated_using_job_token 감사 이벤트가 생성되므로,
GitLab은 요청 하나당 이 이벤트를 두 번 이상 스트리밍합니다.
관리자가 인증된 또는 인증되지 않은 API 속도 제한을 켰다면
19.3 이전 버전에서도 Rack::Attack 속도 제한기가 이러한 이벤트를 생성합니다.
인스턴스 또는 최상위 그룹의 활성 스트리밍 대상이
user_authenticated_using_job_token 이벤트 유형을 스트리밍하면 해당 인스턴스가 영향을 받습니다.
이벤트 유형 필터가 없는 대상은 모든 이벤트 유형을 스트리밍합니다.
영향을 받는 인스턴스에서는 러너가 job 토큰으로 job 로그를 전송하므로, 실행 중인 CI/CD job마다
AuditEvents::AuditEventStreamingWorker job이 Sidekiq에 많이 추가됩니다.
Sidekiq이 처리하는 속도보다 job이 큐에 쌓이는 속도가 빠르면 Redis 메모리가 가득 찰 때까지 증가하고,
GitLab이 동작을 멈춥니다.
이 문제를 해결하려면 GitLab 19.3.8 이상 또는 GitLab 19.4.5 이상으로 업그레이드합니다.
업그레이드할 수 없다면 활성 스트리밍 대상마다 다음 중 하나를 수행합니다.
user_authenticated_using_job_token없이 필요한 이벤트 유형을 나열하는 이벤트 유형 필터를 설정합니다. 자세한 내용은 인스턴스의 이벤트 필터 업데이트 또는 최상위 그룹의 이벤트 필터 업데이트를 참고합니다.- 인스턴스 또는 최상위 그룹의 스트리밍 대상을 비활성화합니다.
이벤트 유형 필터는 허용 목록입니다.
user_authenticated_using_job_token만 포함하는 필터는 해당 이벤트 유형만 스트리밍하므로
이 문제를 해결하지 못합니다.
그룹 대상의 거부 목록 항목도 이 문제를 해결하지 못합니다.
GitLab이 거부 목록을 확인하기 전에 스트리밍 job을 큐에 추가하기 때문입니다.
자세한 내용은 이슈 631338을 참고합니다.
업그레이드 후 GitLab Duo Self-Hosted AI Gateway URL이 지워짐#
- 영향 대상: Linux package
- 영향받는 버전: 19.2.0
- 수정된 버전: 19.2.1
인스턴스를 GitLab 19.2.0으로 직접 업그레이드하면 GitLab Duo Self-Hosted 서비스 엔드포인트 설정이 지워질 수 있습니다. 업그레이드 후 Admin area > GitLab Duo > Configuration > Service endpoints의 다음 필드가 비어 있을 수 있습니다.
- Local AI Gateway URL
- Local URL for the GitLab Duo Agent Platform service
다른 관련 설정도 기본값으로 되돌아갈 수 있습니다. URL을 수동으로 다시 입력할 때까지 GitLab Duo Self-Hosted 기능이 동작하지 않습니다.
GitLab 19.2.1 이상으로 업그레이드하면 이 문제가 발생하지 않습니다.
이미 19.2.0으로 업그레이드해 영향을 받았다면 Admin area > GitLab Duo > Configuration > Service endpoints에서 올바른 AI Gateway 엔드포인트 URL을 복원하고 변경 사항을 저장합니다. 자세한 내용은 이슈 606458을 참고합니다.
새 그룹은 머지 리퀘스트 API 호출에 SHA 매개변수가 필요함#
-
영향 대상: 모든 설치 방법
-
영향받는 버전:
릴리스 영향받는 패치 릴리스 수정된 패치 수준 19.2 19.2.0 - 19.2.5 19.2.6 19.3 19.3.0 - 19.3.1 19.3.2
GitLab 19.2는 그룹 및 인스턴스 수준에 require_sha_for_merge 설정을 도입합니다.
이 설정을 활성화하면 머지 리퀘스트 병합
API 엔드포인트는 유효한 커밋 sha 매개변수가 없는 호출을 거부합니다.
GitLab 19.2와 19.3으로 업그레이드한 후 생성된 그룹은 기본적으로 require_sha_for_merge가 활성화되어 있습니다.
단, 인스턴스나 상위 그룹이 lock_require_sha_for_merge로 이 설정을 잠근 경우에는 새 그룹이 잠긴 값을 대신 상속합니다.
기존 그룹은 영향을 받지 않습니다.
19.2 또는 19.3으로 업데이트한 후 자동화나 API 클라이언트가 sha 매개변수 없이 병합 엔드포인트를 호출하면,
요구 사항을 비활성화하고 설정을 잠그지 않는 한 모든 새 그룹에서 해당
클라이언트가 실패합니다.
모든 새 그룹에 대해 이 요구 사항을 비활성화하려면
애플리케이션 설정 API로 require_sha_for_merge를 false로 설정하고
lock_require_sha_for_merge를 활성화합니다.
이 설정은 GitLab 19.2.6과 GitLab 19.3.2에서 기본적으로 비활성화되도록 변경되었습니다.
컨테이너 레지스트리 메타데이터 데이터베이스가 prefer 모드로 기본 활성화됨#
- 영향 대상: Linux package, self-compiled
- 영향받는 버전: 19.0.0, 19.0.1
GitLab 19.0에서 컨테이너 레지스트리 메타데이터 데이터베이스는 /etc/gitlab/gitlab.rb에
registry['database']['enabled']가 명시적으로 설정되지 않은 기존 설치에서 기본적으로 prefer 모드가 됩니다.
prefer 모드에서 레지스트리는 메타데이터 데이터베이스 사용을 시도합니다.
기존 레지스트리 데이터를 데이터베이스로 가져오지 않았다면
레지스트리는 시작할 때 레거시 파일 시스템 메타데이터로 대체됩니다.
버그(이슈 600955) 때문에
prefer 대체 감지가 실행되기 전에 레지스트리 라우터가 초기화되었습니다. 이로 인해
모든 /gitlab/v1/ 라우트에서 nil 포인터 역참조 패닉이 발생했고,
레지스트리 UI가 그룹 수준 스토리지 크기를 폴링할 때 HTTP 500 오류가 발생했습니다. 실제 Docker 푸시와 풀
프로토콜(/v2/)은 이 버그의 영향을 받지 않습니다.
이 버그는 컨테이너 레지스트리 v4.40.1-gitlab이 포함된 GitLab 19.0.2에서 수정되었습니다.
19.0.0 또는 19.0.1을 실행 중이고 /var/log/gitlab/registry/current의
handlers.(*repositoryHandler).HandleGetRepository에서
runtime error: invalid memory address or nil pointer dereference 패닉이 반복해서 보이면
다음 해결 방법을 적용합니다.
-
/etc/gitlab/gitlab.rb에 다음을 추가합니다.registry['database'] = { 'enabled' => false } -
레지스트리를 reconfigure하고 재시작합니다.
sudo gitlab-ctl reconfigure sudo gitlab-ctl restart registry
19.0.2 이상으로 업그레이드한 후에는 재정의를 제거하고 다시 reconfigure해 기본 동작을 복원합니다.
자세한 내용은 컨테이너 레지스트리 메타데이터 데이터베이스 문서를 참고합니다.
컨테이너 레지스트리 S3 스토리지 드라이버가 s3_v2로 대체됨#
-
영향 대상: Linux package, self-compiled
-
영향받는 버전:
변경 사항 릴리스 영향받는 패치 릴리스 수정된 패치 수준 s3드라이버가s3_v2로 대체됨19.0 이상 모든 패치 릴리스 해당 없음(의도된 변경) checksum_disabled가DeleteObjects체크섬 헤더를 제거하지 않음19.0 - 19.1 모든 패치 릴리스 19.2.0
GitLab 19.0에서 레거시 s3 컨테이너 레지스트리 스토리지 드라이버(AWS SDK v1)가 제거됩니다.
s3 및 s3aws 드라이버 이름은 이제 s3_v2 드라이버(AWS SDK v2)의 별칭입니다.
이전 드라이버 이름이 계속 동작하므로, 재구성한 적이 없는 인스턴스도
업그레이드하면 AWS SDK v2로 전환됩니다.
이 변경은 두 가지 설치 유형에 영향을 줍니다.
- Ceph RGW, MinIO, OVH S3 같은 S3 호환 오브젝트 스토리지 백엔드를 사용하는 설치
- AWS S3를 사용하면서 아웃바운드 네트워크 트래픽을 제한하는 설치. 자세한 내용은 AWS S3의 사전 서명된 URL 호스트 이름을 참고합니다.
s3_v2 드라이버는 AWS가 아닌 S3 호환 백엔드에 두 가지 호환성을 깨는 변경을 도입합니다.
-
regionendpoint에는 스킴을 포함한 전체 URI가 필요합니다.s3_v2드라이버는regionendpoint값에https://(또는http://)를 요구합니다.storage.example.com같은 호스트 이름만 있는 값은 더 이상 유효하지 않으며 시작 오류를 일으킵니다.endpoint rule error, Custom endpoint `storage.example.com` was not a valid URI구성에 스킴을 포함하도록 업데이트합니다.
registry['storage'] = { 's3_v2' => { 'regionendpoint' => 'https://storage.example.com', # ... } } -
AWS SDK v2는 기본적으로 향상된 체크섬을 전송합니다.
s3_v2드라이버는 업로드 시x-amz-content-sha256및 CRC64NVME 체크섬을 전송합니다. Ceph RGW, 이전 MinIO 버전, OVH S3 및 기타 S3 호환 백엔드는 이를 HTTP 400(XAmzContentSHA256Mismatch)으로 거부할 수 있습니다. 이 동작을 비활성화하려면'checksum_disabled' => true를 추가합니다.GitLab 19.0과 19.1에서
checksum_disabled는DeleteObjects호출에서 체크섬 헤더를 제거하지 않습니다. 해당 버전에서는checksum_disabled가true여도 레지스트리가DeleteObjects호출에 CRC32 체크섬 헤더를 보내며,gitlab.rb설정으로는 이를 바꿀 수 없습니다. 백엔드가 이 헤더를 거부하면 블롭 삭제를 유발하는 이미지 푸시가MissingContentMD5또는InvalidRequest오류로 실패합니다.GitLab 19.2.0은 컨테이너 레지스트리
v4.40.2-gitlab으로 이 문제를 수정합니다.checksum_disabled가true이면 레지스트리는DeleteObjects호출에 체크섬 헤더 대신Content-MD5헤더를 보냅니다.이 문제를 해결하려면
checksum_disabled를true로 설정하고 GitLab 19.2.0 이상으로 업그레이드합니다. self-compiled 설치에서는 레지스트리도v4.40.2-gitlab이상으로 업그레이드합니다. 업그레이드할 수 없다면 S3 호환 스토리지 백엔드를 CRC32 체크섬 헤더를 지원하는 버전으로 업그레이드합니다. 최소 버전은 스토리지 공급자의 문서를 참고합니다. 자세한 내용은 이슈 2309를 참고합니다.
Ceph RGW와 대부분의 S3 호환 백엔드에서는 다음과 같이 구성을 업데이트합니다.
registry['storage'] = {
's3_v2' => {
'accesskey' => '<your-access-key>',
'secretkey' => '<your-secret-key>',
'bucket' => '<your-bucket>',
'region' => '<your-region>',
'regionendpoint' => 'https://<your-s3-endpoint>',
'pathstyle' => true,
'checksum_disabled' => true
}
}
자세한 내용은 컨테이너 레지스트리 오브젝트 스토리지 문서와 지원 중단 공지를 참고합니다.
AWS S3의 사전 서명된 URL 호스트 이름#
레지스트리가 블롭을 제공할 때 클라이언트를 사전 서명된 S3 URL로 리디렉션합니다.
AWS SDK v2는 레지스트리 구성의 리전에 맞는 S3 엔드포인트를 확인하므로,
이러한 사전 서명된 URL은 AWS SDK v1이 반환할 수 있던 전역 s3.amazonaws.com 호스트 이름 대신
s3.us-east-1.amazonaws.com 같은 리전별 호스트 이름을 사용할 수 있습니다.
레지스트리 자체는 계속 동작하지만, 클라이언트가 새 호스트 이름에 접근할 수 있어야 합니다.
프록시, 방화벽, 보안 웹 게이트웨이로 아웃바운드 트래픽을 필터링하는 환경에서
s3.amazonaws.com만 포함하는 허용 목록은 리디렉션 대상을 차단합니다.
그러면 이미지 풀이 S3가 아니라 필터링 장치가 반환하는 403 Forbidden 응답으로 실패합니다.
업그레이드하기 전에 컨테이너 이미지 클라이언트의 아웃바운드 트래픽을 필터링하는 모든 장치의 허용 목록에
버킷 리전의 리전별 호스트 이름을 추가합니다.
Amazon S3 전체를 포괄하는 와일드카드 대신 s3.eu-west-2.amazonaws.com처럼
해당 리전의 구체적인 리전별 호스트 이름을 사용합니다.
인스턴스가 S3 VPC 엔드포인트나 다른 고정 엔드포인트를 사용한다면 regionendpoint를 해당
엔드포인트로 설정해 사전 서명된 URL이 직접 관리하는 호스트 이름을 사용하도록 합니다.
자세한 내용은 오브젝트 스토리지 사용을 참고합니다.
업그레이드 후 블롭 풀을 검증하려면 다음을 수행합니다.
-
풀이 캐시가 아니라 블롭 리디렉션으로 제공되도록 몇 메가바이트보다 큰 이미지를 풀합니다.
docker pull gitlab.example.com:5050/mygroup/myproject/myimage:latest -
풀이 실패하면 블롭을 직접 요청해 리디렉션 대상을 확인합니다.
curl --head "https://gitlab.example.com:5050/v2/mygroup/myproject/myimage/blobs/<digest>"location응답 헤더에서 클라이언트가 리디렉션되는 호스트 이름을 확인한 다음, 해당 호스트 이름이 송신 제어에서 허용되는지 확인합니다.
프로젝트가 nil일 때 Geo 디자인 관리 복제에서 NoMethodError 발생#
- 영향 대상: Geo
- 영향받는 버전: 16.0.0 - 19.0.1
Geo 보조 사이트에서 연결된 프로젝트가 삭제되어 고아 DesignManagement::Repository 레코드가 남은 경우,
디자인 관리 리포지터리를 복제하는 동안 NoMethodError가 발생할 수 있었습니다. GitLab 19.0.2가
이 문제를 수정합니다.
자세한 내용은 이슈 597049를 참고합니다.
PostgreSQL 17 최소 요구 사항#
- 영향 대상: 모든 설치 방법
- 영향받는 버전: 19.0.0
지원되는 PostgreSQL의 최소 버전은 이제 17입니다. GitLab 19.0을 설치하기 전에 다음을 수행합니다.
- 패키지에 포함된 PostgreSQL 16을 사용한다면 패키지에 포함된 PostgreSQL 서버를 업그레이드합니다.
- 외부 PostgreSQL 인스턴스를 사용한다면 PostgreSQL 17로 업그레이드합니다.
자세한 내용은 지원 중단 공지를 참고합니다.
웹훅 페이로드 타임스탬프가 ISO 8601 형식으로 변경됨#
- 영향 대상: 모든 설치 방법
- 영향받는 버전: 19.0.0
GitLab 19.0 이전에는 웹훅 페이로드의 타임스탬프 값(예: object_attributes.created_at)이
YYYY-MM-DD HH:MM:SS 뒤에 시간대가 붙는 형식을 사용했습니다. 예: 2026-04-23 12:30:45 UTC.
GitLab 19.0 이상에서는 이러한 타임스탬프가 밀리초 정밀도와 시간대
지정자가 있는 ISO 8601 형식을 사용합니다. 예: 2026-04-23T12:30:45.123Z.
이 변경은 프로젝트 웹훅, 그룹 웹훅, 사용자 지정 웹훅 템플릿의 모든 타임스탬프에 적용되며
한 가지 예외가 있습니다. 파이프라인 이벤트는 builds[]와 bridges[] 안의
created_at, started_at, finished_at 필드에 이전 형식을 유지합니다.
웹훅 수신기가 이러한 타임스탬프 필드를 파싱한다면 밀리초 정밀도의 ISO 8601을 받아들이도록 업데이트합니다. 각 필드의 형식은 웹훅 이벤트를 참고합니다.
이 변경은 머지 리퀘스트 233400에서 도입되었으며 이슈 622832에서 추적됩니다.
Geo 컨테이너 리포지터리 동기화가 OCI 이미지 인덱스 태그를 알림 없이 건너뜀#
-
영향 대상: Geo(컨테이너 레지스트리)
-
영향받는 버전:
릴리스 영향받는 패치 릴리스 수정된 패치 수준 19.0 19.0.0 - 19.0.1 19.0.2
Geo 보조 사이트에서 컨테이너 리포지터리 동기화가 매니페스트가 OCI 이미지 인덱스
(application/vnd.oci.image.index.v1+json)인 태그를 알림 없이 건너뛰었습니다.
멀티 아키텍처 이미지와 BuildKit 캐시 태그가 이 매니페스트 유형을 흔히 사용합니다.
오류는 발생하지 않았고 태그 수도 일치했지만, 보조 사이트에서 영향받는 태그를 docker pull하면
manifest unknown이 반환되었습니다. 같은 근본 원인으로 보조 사이트에
동기화가 제거할 수 없는 고아 태그도 남았습니다.
기본 사이트와 보조 사이트를 모두 수정된 버전으로 업그레이드하면 새로 동기화되는 태그는 올바르게 처리됩니다. 이전에 영향받은 리포지터리는 다음 검증 주기에 정상화되며, 이는 재검증 간격(기본값 90일)만큼 걸릴 수 있습니다. 영향받은 리포지터리를 즉시 복구하려면 보조 사이트에서 컨테이너 리포지터리를 다시 동기화합니다.
자세한 내용은 이슈 600486을 참고합니다.
Geo 검증 동시성 제한이 전역 총합으로 적용됨#
- 영향 대상: Geo
- 영향받는 버전: 19.3.0
Verification concurrency limit Geo 사이트 설정은 이제 모든 데이터 유형을 합쳐 사이트에서 동시에 실행되는 검증 job 수에 대한 단일 전역 제한으로 적용됩니다. 이전에는 설정된 값을 적용하기 전에 데이터 유형 수로 나누었으므로, 실제 동시성이 더 낮았고 데이터 유형이 추가되거나 통합될 때 달라졌습니다.
사용 중인 실제 동시성을 유지하고 검증 부하가 급증하는 것을 막기 위해, GitLab
19.3은 각 사이트에 저장된 Verification concurrency limit를
max(1, floor(previous_value / number_of_data_types))로 자동 재조정합니다. 그 결과
관리자 UI에 표시되고 API가 반환하는 값이 감소합니다. 업그레이드한 후 이 설정을 검토하고 다시 조정합니다.
API나 코드형 인프라로 이 설정을 관리한다면 저장된 값을 이에 맞게 업데이트합니다.
자세한 내용은 이슈 596579를 참고합니다.
시험 실행 모드가 더 이상 auth.log에 기록하지 않음#
- 영향 대상: 모든 설치 방법
- 영향받는 버전: 19.3.0 이상
GitLab 19.3 이상에서는 Rack::Attack 속도 제한기 대신 LabKit 속도 제한기가 사용자 및 IP 속도 제한을
적용합니다. 시험 실행 모드에서는
GitLab은 요청이 제한에 도달하게 될 때 env가 track으로 설정된 메시지를 auth.log 또는 auth_json.log에 더 이상 기록하지 않습니다.
- GitLab 19.3과 19.4에서는 사용자나 IP 주소 없이 Prometheus 메트릭만 이러한 요청을 계산합니다.
GitLab 19.3에서는
action="log"인gitlab_labkit_rate_limiter_calls_total, GitLab 19.4에서는result="log"인gitlab_labkit_rate_limiter_rule_evaluations_total입니다. - GitLab 19.5 이상에서는 요청별 구조화 로그의
rate_limit_state필드를 확인합니다.
자세한 내용은 이슈 635754를 참고합니다.
허용 목록 사용자의 요청에 throttle_user_allowlist가 표시되지 않음#
- 영향 대상: 모든 설치 방법
- 영향받는 버전: 19.3.0 이상
GitLab 19.3 이상에서 사용자 허용 목록에 있는 사용자의 요청은
여전히 속도 제한기를 우회합니다. 그러나 production_json.log와 api_json.log는 이러한 요청을
"throttle_safelist":"throttle_user_allowlist" 대신 대부분의 다른 요청도 가지는 값인
"throttle_safelist":"labkit_fully_enforced"로 표시합니다.
GitLab 19.5 이상에서는 rate_limit_state 필드가 이러한 요청을 user_allowlist 규칙에 대한 skip 결과로
기록합니다. 예: rack_request:user_allowlist:skip.
자세한 내용은 이슈 635759를 참고합니다.
Ubuntu 20.04에 대한 Linux package 지원이 중단됨#
- 영향 대상: Linux package
- 영향받는 버전: 19.0.0
Ubuntu 20.04는 2025년 5월에 표준 지원이 종료되었습니다. GitLab 19.0부터 Ubuntu 20.04용 Linux package는 더 이상 제공되지 않습니다. GitLab 18.11이 이 배포판용 패키지가 있는 마지막 릴리스입니다. GitLab 19.0으로 업그레이드하기 전에 Ubuntu 22.04 또는 다른 지원되는 운영 체제로 마이그레이션합니다.
자세한 내용은 지원 중단 공지를 참고합니다.
Redis 6 지원이 제거됨#
- 영향 대상: Linux package
- 영향받는 버전: 19.0.0
GitLab 19.0에서 Redis 6 지원이 제거됩니다. 외부 Redis 6 배포를 사용한다면 업그레이드하기 전에 Redis 7.0 이상 또는 Valkey 7.2로 마이그레이션합니다. Redis 7.2 또는 Valkey 7.2를 권장합니다. Redis 7.0은 업스트림에서 수명 종료(EOL)에 도달했지만, Amazon ElastiCache for Redis 7.1처럼 공급업체가 적극적으로 유지 관리하는 경우도 있습니다. Linux package에 포함된 번들 Redis는 GitLab 16.2부터 Redis 7을 사용했으므로 영향을 받지 않습니다.
자세한 내용은 지원 중단 공지를 참고합니다.
Linux package에서 Mattermost가 제거됨#
- 영향 대상: Linux package
- 영향받는 버전: 19.0.0
GitLab 19.0에서 번들 Mattermost가 Linux package에서 제거됩니다. 현재 번들 Mattermost를 사용한다면 마이그레이션 지침은 Linux package에서 Mattermost Standalone으로 마이그레이션을 참고합니다. 번들 Mattermost를 사용하지 않는다면 영향을 받지 않습니다.
GitLab 19.0으로 업그레이드하기 전에 /etc/gitlab/gitlab.rb에서 모든 mattermost[...] 설정을 제거하거나 주석 처리합니다.
mattermost[...] 키가 하나라도 남아 있으면 패키지가 설치된 직후 gitlab-ctl reconfigure가 다음 메시지와 함께
즉시 중단됩니다.
RuntimeError: Removed configurations found in gitlab.rb. Aborting reconfigure.
특정 18.11.x 버전에서 업그레이드할 때는 동작이 다릅니다.
- 18.11.0부터 18.11.6까지: 업그레이드가 오래된 Mattermost 구성을 감지하지 못하므로,
정리가 끝나지 않았더라도 경고 없이 업그레이드가 진행됩니다.
업그레이드하기 전에 Mattermost 키 제거를 검증하는 데
gitlab-ctl check-config --version 19.0.x를 신뢰하지 않습니다(이슈 9916). - 18.11.7:
gitlab.rb에서 모든mattermost[...]키를 제거했더라도 업그레이드가 차단됩니다. 이 차단은 GitLab이 노드 캐시에 무조건 생성한 오래된 Mattermost 시크릿으로 인한 오탐입니다. 업그레이드 차단을 해제하려면 다음 중 하나를 사용합니다.- 19.0으로 업그레이드하기 전에 18.11.9 이상으로 업그레이드합니다.
- 수동 해결 방법을 적용합니다.
자세한 내용은 지원 중단 공지를 참고합니다.
SUSE 배포판에 대한 Linux package 지원이 중단됨#
- 영향 대상: Linux package
- 영향받는 버전: 19.0.0
SUSE 배포판에 대한 Linux package 지원이 GitLab 19.0에서 종료되며, openSUSE Leap 15.6, SUSE Linux Enterprise Server 12.5, SUSE Linux Enterprise Server 15.6이 영향을 받습니다. GitLab 18.11이 이 배포판용 Linux package가 있는 마지막 버전입니다. SUSE 배포판을 계속 사용하려면 GitLab Docker 배포로 마이그레이션합니다.
자세한 내용은 지원 중단 공지를 참고합니다.
Linux package와 GitLab Helm 차트에서 Spamcheck가 제거됨#
- 영향 대상: Linux package, Helm chart
- 영향받는 버전: 19.0.0
GitLab 19.0에서 Spamcheck가 Linux package와 GitLab Helm 차트에서 제거됩니다. 현재 Spamcheck를 사용하지 않는 고객은 영향을 받지 않습니다. 번들 Spamcheck를 사용한다면 Docker를 사용해 별도로 배포할 수 있습니다. 데이터 마이그레이션은 필요하지 않습니다.
자세한 내용은 지원 중단 공지를 참고합니다.
NGINX Ingress가 Envoy Gateway 기반 Gateway API로 대체됨#
- 영향 대상: Helm chart
- 영향받는 버전: 19.0.0
GitLab 19.0에서 Envoy Gateway 기반 Gateway API가 GitLab Helm 차트의 기본 네트워킹 구성이 되어, 2026년 3월에 수명 종료된 NGINX Ingress를 대체합니다. Envoy Gateway로의 마이그레이션이 즉시 어렵다면 번들 NGINX Ingress를 명시적으로 다시 활성화할 수 있으며, GitLab 20.0에서 제거가 제안될 때까지 계속 사용할 수 있습니다. 이 변경은 Linux package에서 사용하는 NGINX나, 외부에서 관리하는 Ingress 또는 Gateway API 컨트롤러를 사용하는 Helm 차트 인스턴스에는 영향을 주지 않습니다.
자세한 마이그레이션 단계는 Helm 차트 10.0 업그레이드 노트를 참고합니다.
자세한 내용은 지원 중단 공지를 참고합니다.
GitLab Helm 차트에서 번들 PostgreSQL, Redis, MinIO가 제거됨#
- 영향 대상: Helm chart
- 영향받는 버전: 19.0.0
번들 Bitnami PostgreSQL, Bitnami Redis, MinIO 차트가 GitLab 19.0에서 GitLab Helm 차트와 GitLab Operator에서 대체 수단 없이 제거됩니다. 이러한 구성 요소는 개념 증명 및 테스트 환경용으로만 의도되었으며 프로덕션 환경에서는 사용을 권장하지 않습니다. 번들 서비스를 사용하는 인스턴스를 운영 중이라면 GitLab 19.0으로 업그레이드하기 전에 마이그레이션 가이드에 따라 외부 서비스를 구성합니다.
자세한 내용은 지원 중단 공지를 참고합니다.
Linux package RPM 설치의 고아 .agents 및 .claude 디렉터리#
-
영향 대상: Linux package (RPM)
-
영향받는 버전:
릴리스 영향받는 패치 릴리스 수정된 패치 수준 19.0 19.0.0 - 19.0.2 19.0.3 19.1 19.1.0 19.1.1
영향받는 패치 릴리스의 Linux package에는 /opt/gitlab/embedded/service/gitlab-rails/ 아래의
디렉터리 두 개가 실수로 포함되어 있었습니다.
.agents/.claude/
이 디렉터리는 수정된 패치 수준부터, 그리고 GitLab 19.2 이상에서는 기본적으로 패키지 페이로드에서 제외됩니다. 자세한 내용은 이슈 603547을 참고합니다.
RPM 기반 배포판에서 RPM은 더 이상 소유하지 않는 디렉터리라도 파일이 남아 있으면 제거하지 않습니다. Linux package RPM 설치를 수정된 버전 이후로 업그레이드한 뒤에도 다음 디렉터리가 디스크에 남아 있을 수 있습니다.
/opt/gitlab/embedded/service/gitlab-rails/.agents/opt/gitlab/embedded/service/gitlab-rails/.claude
RPM은 이러한 고아 디렉터리를 자동으로 제거하지 않습니다. 이 디렉터리가 있는지 확인하고, 있다면 수동으로 제거합니다.
-
디렉터리가 있는지 확인합니다.
ls -la /opt/gitlab/embedded/service/gitlab-rails/.agents \ /opt/gitlab/embedded/service/gitlab-rails/.claude -
디렉터리가 있다면 제거합니다.
sudo rm -rf /opt/gitlab/embedded/service/gitlab-rails/.agents \ /opt/gitlab/embedded/service/gitlab-rails/.claude
DEB 기반 배포판은 dpkg가 업그레이드 중에 더 이상 소유하지 않는 디렉터리를 제거하므로
영향을 받지 않습니다.