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로 직접 업그레이드할 때 마이그레이션 실패. 이 버그는 GitL