GitLab 17 업그레이드 노트

GitLab 17의 마이너·패치 버전 업그레이드 정보를 설명합니다.

이 페이지는 GitLab 17의 마이너 및 패치 버전에 대한 업그레이드 정보를 담고 있습니다. 다음 사항에 대해 이 안내를 반드시 검토합니다. 설치 유형. 현재 버전과 목표 버전 사이의 모든 버전. Helm 차트 설치에 대한 추가 정보는 Helm 차트 8.0 업그레이드 노트 를 참고합니다. 업그레이드 시 알아둘 이슈 # 특정 GitLab 버전에서 업그레이드할 때 업그레이드에 영향을 줄 수 있는 이슈를 알아둡니다. GitLab 16.11에서 업그레이드하는 경우 # GitLab 16.11에서 업그레이드하는 경우: 백그라운드 마이그레이션 AlterWebhookDeletedAuditEvent: audit_events 는 완료까지 여러 시간이 걸릴 수 있습니다. 자세한 내용은 머지 리퀘스트 161320 을 참고합니다. GitLab 17.0 이상으로 업그레이드하기 전에 gitlab.rb 에서 지금은 폐지된 번들 Grafana 키에 대한 참조를 제거해야 합니다. 업그레이드 이후 gitlab.rb 에 이 키에 대한 참조가 남아 있으면 gitlab-ctl reconfigure 가 실패합니다. GitLab 17.0으로 업그레이드하기 전에 새 러너 등록 워크플로로 마이그레이션 해야 합니다. GitLab 16.0에서는 러너 인증 토큰을 사용해 러너를 등록하는 새 러너 생성 워크플로가 도입되었습니다. 등록 토큰을 사용하는 레거시 워크플로는 GitLab 17.0부터 기본적으로 비활성화되며 GitLab 20.0에서 제거될 예정입니다. 등록 토큰을 계속 사용 중이라면 GitLab 17.0으로 업그레이드할 때 러너 등록이 실패합니다. Gitaly 스토리지는 다음 예시처럼 더 이상 동일한 경로를 공유할 수 없습니다. gitaly[ 'configuration' ] = { storage: [ { name: 'default' , path: '/var/opt/gitlab/git-data/repositories' , }, { name: 'duplicate-path' , path: '/var/opt/gitlab/git-data/repositories' , }, ], } 이 예시에서는 duplicate-path 스토리지를 제거하거나 새 경로로 옮겨야 합니다. Gitaly 노드가 둘 이상인 경우 해당 노드에 대응하는 스토리지만 그 노드의 gitlab.rb 파일에 나열되어 있는지 반드시 확인합니다. 노드의 gitlab.rb 파일에서 스토리지를 제거한 경우, 그 스토리지와 연결된 모든 프로젝트는 GitLab 데이터베이스에서 스토리지 정보를 갱신해야 합니다. Rails 콘솔을 사용해 스토리지를 갱신할 수 있습니다. 예: $ sudo gitlab-rails console Project.where(repository_storage: 'duplicate-path').update_all(repository_storage: 'default') GitLab 16.x에서 GitLab 17.1.0 또는 17.1.1로 직접 업그레이드할 때 발생하는 마이그레이션 실패. 이 버그는 GitLab 17.1.2에