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 18.11 릴리즈 노트
GitLab 18.11이 공식 출시되었습니다. 이번 릴리즈에서는 Duo Agent Platform의 취약점 해결 기능이 GA 되었으며, GitLab 데이터 분석가 에이전트(GA)와 CI 전문가 에이전트(베타)가 새로 도입되었습니다. 또 자동 취약점 심각도 오버라이드, 서비스 계정 확장, 세분화된 개인 액세스 토큰(베타) 등 핵심 기능이 포함되었습니다.
2026년 4월 17일
GitLab, 2026 Omdia Universe 리더로 선정
GitLab이 2026 Omdia Universe AI 기반 소프트웨어 개발 부문에서 리더로 선정되었습니다. 19개 벤더 중 솔루션 범위를 포함한 3개 카테고리에서 업계 최고 점수를 획득한 GitLab의 성과가 엔지니어링 팀에 갖는 의미를 살펴봅니다.
2026년 4월 17일
GitLab 보안 패치 릴리즈 18.10.3, 18.9.5, 18.8.9
GitLab Community Edition과 Enterprise Edition의 18.10.3, 18.9.5, 18.8.9 버전이 출시되었으며, 중요한 버그 및 보안 수정 사항이 포함되어 있습니다. 모든 사용자는 즉시 최신 버전으로 업그레이드할 것을 권장하며, GitLab.com은 이미 패치된 버전을 실행 중입니다. 보안 수정 사항에는 여러 취약점이 포함되어 있으며, 각 취약점에 대한 자세한 내용은 30일 후에 공개됩니다. 업그레이드 시 다중 노드 배포가 가능하며, 새로운 마이그레이션은 포함되어 있지 않습니다.
2026년 4월 9일