GitLab 19.0 브레이킹 체인지 가이드
GitLab은 매 주요 릴리즈마다 브레이킹 체인지를 지속적으로 줄여왔습니다. GitLab 17.0에서는 80개, 18.0에서는 27개였던 브레이킹 체인지가 다가오는 19.0에서는 단 15개로 줄어들 예정입니다. 이러한 개선은 영향 완화 및 리더십 서명을 요구하는 필수 브레이킹 체인지 승인 프로세스 덕분입니다.
본 내용은 GitLab 공식 블로그의 브레이킹 체인지 가이드를 번역 및 재편집한 것이며, 원문은 A guide to the breaking changes in GitLab 19.0에서 확인할 수 있습니다.
배포 일정
GitLab.com
- 기본 일정: 2026년 5월 4 ~ 6일 (09:00~22:00 UTC)
- 예비 일정: 2026년 5월 11 ~ 13일 (09:00~22:00 UTC)
GitLab Self-Managed
2026년 5월 21일부터 이용 가능
GitLab Dedicated
2026년 6월 22일 주간 할당된 유지보수 시간에 업그레이드
높은 영향도 브레이킹 체인지
1. NGINX Ingress가 Gateway API와 Envoy Gateway로 대체
영향 대상: GitLab Self-Managed (Helm Chart)
번들된 NGINX Ingress가 2026년 3월에 지원 종료(EOL)에 도달합니다. GitLab은 기본값으로 Gateway API와 Envoy Gateway로 전환합니다. 필요한 경우 GitLab 20.0에서 완전히 제거되기 전까지 NGINX Ingress를 다시 활성화할 수 있습니다.
영향을 받지 않는 환경:
- Linux 패키지의 NGINX
- 외부 Ingress 또는 Gateway API 컨트롤러를 사용하는 Helm Chart 인스턴스
필요 조치: 업그레이드 전에 Gateway API 또는 외부에서 관리하는 컨트롤러로의 마이그레이션을 계획하세요.
2. Helm Chart에서 번들 PostgreSQL, Redis, MinIO 제거
영향 대상: GitLab Self-Managed (Helm Chart)
Bitnami PostgreSQL, Bitnami Redis, 포크된 MinIO 차트가 라이선스 변경 및 유지보수 고려 사항으로 인해 제거됩니다. 이 컴포넌트들은 개념 증명(PoC) 및 테스트 환경만을 위한 용도였습니다.
필요 조치: 19.0으로 업그레이드하기 전에 마이그레이션 가이드를 따라 외부 서비스를 구성하세요. Linux 패키지의 Redis와 PostgreSQL은 영향을 받지 않습니다.
3. ROPC(Resource Owner Password Credentials) OAuth Grant 제거
영향 대상: GitLab.com | Self-Managed | Dedicated
OAuth RFC 버전 2.1 표준에 맞춰 ROPC 그랜트가 완전히 제거됩니다. GitLab.com에서는 2025년 4월 8일부터 클라이언트 인증이 필수였습니다. 18.0에서는 관리자 설정을 통해 옵트아웃이 가능했습니다.
필요 조치: 업그레이드 전에 애플리케이션을 Authorization Code 플로우 또는 지원되는 OAuth 플로우로 마이그레이션하세요. 19.0 이후에는 어떠한 상황에서도 ROPC를 사용할 수 없습니다.
4. PostgreSQL 16 지원 중단 — PostgreSQL 17 최소 요구
영향 대상: GitLab Self-Managed
PostgreSQL 17이 최소 요구 버전이 됩니다. PostgreSQL 17은 GitLab 18.9부터 이용 가능합니다.
필요 조치:
- 단일 PostgreSQL 인스턴스(Linux 패키지): 18.11 업그레이드 시 PostgreSQL 17로 자동 업그레이드가 발생할 수 있습니다. 충분한 디스크 공간을 확보하세요.
- PostgreSQL 클러스터 또는 옵트아웃한 인스턴스: GitLab 19.0 이전에 수동으로 PostgreSQL 17로 업그레이드해야 합니다.
중간 영향도 브레이킹 체인지
1. Ubuntu 20.04 Linux 패키지 지원 중단
영향 대상: GitLab Self-Managed
Ubuntu 표준 지원이 2025년 5월에 종료되었습니다. GitLab의 정책에 따라 벤더가 지원을 중단하면 패키지도 삭제됩니다.
필요 조치: GitLab 19.0으로 업그레이드하기 전에 Ubuntu 22.04 또는 다른 지원되는 운영체제로 업그레이드하세요. GitLab 18.11이 Ubuntu 20.04 패키지를 제공하는 마지막 릴리즈입니다.
2. Redis 6 지원 제거
영향 대상: GitLab Self-Managed
외부 Redis 6을 사용하는 인스턴스는 Redis 7.2 또는 Valkey 7.2로 마이그레이션해야 합니다. Valkey 베타는 GitLab 18.9에서 이용 가능하며, GA는 19.0에서 제공될 예정입니다.
클라우드별 마이그레이션 리소스:
- AWS ElastiCache: Redis 7.2 또는 Valkey 7.2로 업그레이드
- GCP Memorystore: Redis 7.2 또는 Valkey 7.2로 업그레이드
- Azure Cache for Redis: VM이나 AKS에서 셀프 호스팅하거나 Linux 패키지를 사용하세요. Valkey 7.2 지원은 19.0 GA에서 계획되어 있습니다.
- 셀프 호스팅: Redis 6에서 Redis 7.2 또는 Valkey 7.2로 업그레이드
3. heroku/builder:22 이미지가 heroku/builder:24로 교체
영향 대상: GitLab.com | Self-Managed | Dedicated
Auto DevOps에서 사용하는 클라우드 네이티브 빌드팩 빌더 이미지가 업데이트됩니다. Auto DevOps에서 auto-build-image를 사용하는 파이프라인에 영향이 있습니다.
영향 확인: Heroku-24 스택 릴리즈 노트와 업그레이드 노트를 검토하여 워크로드에 미치는 영향을 평가하세요.
완화 방법: 필요한 경우 CI/CD 변수 AUTO_DEVOPS_BUILD_IMAGE_CNB_BUILDER를 heroku/builder:22로 설정하세요.
4. Linux 패키지에서 Mattermost 제거
영향 대상: GitLab Self-Managed
2015년에 처음 포함된 번들 Mattermost가 제거됩니다. Mattermost는 현재 독립형 배포 옵션을 제공하고 있으며, GitLab SSO는 Mattermost 무료 티어에서 v11부터 더 이상 지원되지 않게 되었습니다.
필요 조치: 번들 Mattermost를 사용 중인 경우, Mattermost 문서의 "GitLab Omnibus에서 Mattermost Standalone으로 마이그레이션" 가이드를 참조하세요.
5. SUSE 배포판 Linux 패키지 지원 중단
영향 대상: GitLab Self-Managed
다음 배포판의 지원이 종료됩니다:
- openSUSE Leap 15.6
- SUSE Linux Enterprise Server 12.5
- SUSE Linux Enterprise Server 15.6
GitLab 18.11이 이 배포판들의 패키지를 제공하는 마지막 버전입니다.
권장 경로: 기존 배포판에서 Docker 배포로 마이그레이션하세요.
낮은 영향도 브레이킹 체인지
1. Linux 패키지 및 Helm Chart에서 Spamcheck 제거
영향 대상: GitLab Self-Managed
Spamcheck는 주로 대규모 공개 인스턴스에 해당됩니다. 제거를 통해 패키지 크기와 의존성 범위가 줄어듭니다.
필요 조치: 번들 Spamcheck를 사용 중인 경우, Docker를 사용하여 별도로 배포하세요. 데이터 마이그레이션은 필요하지 않습니다.
2. Slack 슬래시 명령 통합 제거
영향 대상: Self-Managed | Dedicated
더 안전한 통합과 동등한 기능을 제공하는 GitLab for Slack 앱으로 대체되어 폐기되었습니다.
필요 조치: GitLab 19.0부터 사용자는 Slack 슬래시 명령을 구성하거나 사용할 수 없습니다.
3. Bitbucket Cloud 가져오기 API에서 앱 비밀번호 지원 중단
영향 대상: GitLab.com | Self-Managed | Dedicated
Atlassian이 Bitbucket Cloud의 앱 비밀번호(사용자명/비밀번호 인증)를 폐기하며, 2026년 6월 9일에 종료됩니다.
필요 조치: GitLab API를 통한 리포지토리 가져오기 시 앱 비밀번호 대신 사용자 API 토큰을 사용해야 합니다. UI를 통한 가져오기와 Bitbucket Server 가져오기는 영향을 받지 않습니다.
4. Explore Projects 페이지에서 Trending 탭 제거
영향 대상: GitLab.com | Self-Managed | Dedicated
Trending 탭과 관련 GraphQL 인수가 제거됩니다. 트렌딩 알고리즘은 공개 프로젝트만 고려했기 때문에 Self-Managed 인스턴스에서는 효과적이지 않았습니다.
변경 사항: GitLab 19.0 릴리즈 한 달 전부터 Trending 탭은 별(Stars) 내림차순으로 정렬된 Active 탭으로 리다이렉트됩니다.
함께 제거되는 항목: Query.adminProjects, Query.projects, Organization.projects GraphQL 타입에서 trending 인수가 제거됩니다.
5. Container Registry 스토리지 드라이버 업데이트
영향 대상: Self-Managed
두 개의 레거시 드라이버가 교체됩니다:
Azure 스토리지 드라이버: 레거시 azure 드라이버가 새로운 azure_v2 드라이버의 별칭이 됩니다. 안정성과 성능 향상을 위해 사전에 마이그레이션하는 것을 권장합니다.
S3 스토리지 드라이버(AWS SDK v1): 레거시 s3 드라이버가 새로운 s3_v2 드라이버의 별칭이 됩니다. s3_v2 드라이버는 Signature Version 2를 지원하지 않으며, v4auth: false 설정은 투명하게 무시됩니다. 업그레이드 전에 Signature Version 4로 마이그레이션하세요.
6. ciJobTokenScopeAddProject GraphQL 뮤테이션 제거
영향 대상: GitLab.com | Self-Managed | Dedicated
폐기된 뮤테이션이 제거됩니다. GitLab 18.0에서 CI/CD 작업 토큰 범위 변경과 함께 도입된 ciJobTokenScopeAddGroupOrProject로 대체되었습니다.
필요 조치: 업그레이드 전에 폐기된 뮤테이션을 사용하는 자동화 및 도구를 업데이트하세요.
7. ci_job_token_scope_enabled Projects API 속성 제거
영향 대상: GitLab.com | Self-Managed | Dedicated
Projects REST API의 이 속성이 제거됩니다. GitLab 18.0에서 폐기되었으며 항상 false를 반환했습니다.
완화 방법: CI/CD 작업 토큰 프로젝트 설정을 사용하여 작업 토큰 액세스를 제어하세요.
8. GitLab.com에서 비인증 Projects API 페이지네이션 제한 적용
영향 대상: GitLab.com 전용
비인증 Projects List REST API 요청에 최대 오프셋 제한 50,000이 적용됩니다. 예를 들어, 페이지당 20개 결과를 조회할 때 페이지 파라미터가 2,500페이지로 제한됩니다.
완화 방법: 더 많은 데이터 액세스가 필요한 워크플로우는 키셋 기반 페이지네이션 파라미터를 사용해야 합니다.
영향도 관리를 위한 리소스
GitLab Detective
Self-Managed 인스턴스를 위한 실험적 도구로, 구성 파일과 데이터베이스 값을 검사하여 알려진 문제를 자동으로 확인합니다. GitLab 노드에서 직접 실행해야 합니다.
지원
- 유료 플랜: GitLab 지원 포털에서 지원 티켓을 개설하세요
- 무료 GitLab.com 사용자: GitLab 문서, 커뮤니티 포럼, Stack Overflow를 통해 지원을 받으세요
전체 폐기 항목 목록은 Deprecations 페이지에서 GitLab 19.0에서 제거 예정인 항목의 전체 세부 정보를 확인할 수 있습니다.
업그레이드 안내
GitLab을 업데이트하려면 업그레이드 가이드를 참조하세요.
인포그랩은 GitLab의 공식 파트너사로서 릴리즈 관련 정보를 번역하여 제공합니다.
더 많은 GitLab에 대한 정보와 데모가 궁금하신가요? 혹은 GitLab 도입이 필요하신가요? 그렇다면 인포그랩에 연락하세요! DevOps 전문가가 도와드립니다.
관련 글
GitLab 보안 패치 릴리즈 19.3.1, 19.2.5, 19.1.7
GitLab 19.3.1, 19.2.5 및 19.1.7 보안 패치 릴리즈는 7건의 보안 취약점을 수정했으며, 모든 셀프‑관리형 인스턴스가 즉시 최신 버전으로 업그레이드하도록 권고합니다. 주요 수정 사항에는 Duo Claude AI 에이전트의 신뢰할 수 없는 제어 영역, 가져오기 파이프라인 및 SCIM API의 DoS, 보호된 환경 접근 제어, 컴플라이언스 프레임워크 인가 우회, 파이프라인 실행 정책 데이터 처리, 병합 요청 승인 규칙 인가 문제가 포함된다. 각 CVE와 심각도, CVSS 점수가 제공되며, 업그레이드 시 데이터베이스 마이그레이션과 다운타임 고려가 필요합니다.
GitLab 19.3 릴리즈 노트
GitLab 19.3 릴리즈 노트 한국어 정리. Flow Creator 에이전트, GitLab Duo 머지 충돌·리뷰 논의 해결 GA, 소스 코드 Secret Scanning 베타 등 주요 업데이트 29개를 지원 환경별로 정리했습니다.
GitLab 긴급 보안 패치 19.2.4, 19.1.6, 19.0.8, 18.11.11
GitLab CE/EE 19.2.4, 19.1.6, 19.0.8 및 18.11.11 긴급 보안 패치는 CVE‑2026‑19478(코드 인젝션, CVSS 9.4)과 CVE‑2026‑19650(CSRF, CVSS 7.1) 두 가지 고위험 취약점을 해결하며, 모든 셀프‑관리형 인스턴스는 즉시 해당 버전으로 업그레이드해야 합니다. 패치 적용 후 90일 이내에 상세 이슈가 공개되며, 업그레이드 시 데이터베이스 마이그레이션과 다운타임(단일 노드) 또는 무중단 절차(다중 노드)를 고려해야 합니다. 자세한 내용은 GitLab 릴리즈 핸드북 및 보안 FAQ를 참조하십시오.