GitLab 15 변경사항

Tier: Free, Premium, Ultimate Offering: Self-managed

이 페이지는 GitLab 15의 마이너 및 패치 버전 업그레이드 정보를 포함하고 있습니다.

다음에 대한 지침을 검토해야 합니다:

  • 설치 유형.
  • 현재 버전과 대상 버전 사이의 모든 버전.

GitLab Helm Chart 업그레이드에 대한 자세한 내용은 6.0의 릴리즈 노트를 참조하세요.

15.11.1

15.11.0

  • 패치 릴리즈 15.11.3 이상으로 업그레이드하십시오. 이는 15.5.0 및 이전 버전에서 업그레이드할 때 문제 408304를 피할 수 있습니다.

  • 일반적으로 PgBouncer가 있는 환경에서 백업은 변수를 설정하여 PgBouncer를 우회해야 합니다. 변수는 GITLAB_BACKUP_ 접두사가 붙습니다. 그러나 문제로 인해 gitlab-backup은 오버라이드에 정의된 직접 연결 대신 PgBouncer를 통해 일반 데이터베이스 연결을 사용하므로 데이터베이스 백업이 실패합니다. 해결 방법은 pg_dump를 직접 사용하는 것입니다.

    영향을 받는 릴리즈:

    영향을 받는 마이너 릴리즈 영향을 받는 패치 릴리즈 수정됨
    15.11 모든 없음
    16.0 모든 없음
    16.1 모든 없음
    16.2 모든 없음
    16.3 모든 없음
    16.4 모든 없음
    16.5 모든 없음
    16.6 모든 없음
    16.7 16.7.0 - 16.7.6 16.7.7
    16.8 16.8.0 - 16.8.3 16.8.4

리눅스 패키지 설치

GitLab 15.11에서 PostgreSQL은 다음 경우를 제외하고 자동으로 13.x로 업그레이드됩니다:

  • 데이터베이스를 Patroni를 사용하여 고가용성으로 실행하는 경우.
  • 데이터베이스 노드가 GitLab Geo 구성의 일부인 경우.
  • PostgreSQL 자동 업그레이드에서 명시적으로 선택 해제한 경우.
  • /etc/gitlab/gitlab.rb에 postgresql['version'] = 12이 있는 경우.

장애 조치(fault-tolerant) 및 Geo 설치는 PostgreSQL 13으로의 수동 업그레이드를 지원합니다. HA/Geo 클러스터에 배포된 패키지 PostgreSQL을 참조하세요.

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 일부 프로젝트 가져오기는 프로젝트 생성 시 위키 리포지토리를 초기화하지 않습니다.
    자세한 내용과 해결 방법을 참조하세요.
  • pg_upgrade가 번들된 PostgreSQL 데이터베이스를 버전 13으로 업그레이드하지 못합니다.
    자세한 내용과 해결 방법을 참조하세요.

pg_upgrade가 번들된 PostgreSQL 데이터베이스를 버전 13으로 업그레이드하지 못함

영향을 받는 소규모 릴리즈 영향을 받는 패치 릴리즈 수정됨
15.2 - 15.10 모두 없음
15.11 15.11.0 - 15.11.11 15.11.12 및 이후

내장된 pg-upgrade 도구의 버그로 인해 번들된 PostgreSQL 데이터베이스를 버전 13으로 업그레이드하지 못합니다. 이로 인해 보조 사이트가 손상된 상태가 되어 Geo 설치를 GitLab 16.x로 업그레이드하는 것이 불가능합니다
(PostgreSQL 12 지원이 16.0에서 제거되었습니다 및 이후 릴리즈). 이는 번들된 PostgreSQL 소프트웨어를 사용하는 보조 사이트에서 발생하며, 동일한 노드에서 보조 메인 Rails 데이터베이스와 추적 데이터베이스를 실행하고 있습니다.
15.11.12 및 이후로 업그레이드할 수 없는 경우 수동 해결 방법을 고려하세요.

15.11.x

  • 버그로 인해 처음 로그인하는 새로운 LDAP 사용자에게 LDAP 사용자 속성이 아닌 이메일 주소를 기반으로 사용자 이름이 할당될 수 있습니다. 수동 해결 방법은 gitlab_rails['omniauth_auto_link_ldap_user'] = true로 설정하거나 버그가 수정된 GitLab 16.1 또는 그 이후로 업그레이드하는 것입니다.

15.10.5

  • Elastic Indexer Cron Workers의 버그로 인해 Sidekiq가 포화될 수 있습니다.
    • 이 문제가 발생하면 병합 요청이 병합되거나, 파이프라인, Slack 알림 및 기타 이벤트가 생성되지 않거나 발생하는 데 시간이 오래 걸립니다.
    • 이 문제는 Sidekiq가 충분히 포화되기까지 최대 일주일이 걸릴 수 있으므로 즉시 나타나지 않을 수 있습니다.
    • 이 문제가 발생하기 위해 Elasticsearch를 활성화할 필요는 없습니다.
    • 이 문제를 해결하려면 15.11로 업그레이드하거나 문제에 있는 해결 방법을 사용하세요.
  • 많은 프로젝트 가져오기 도구와 그룹 가져오기 도구가 이제 Developer 역할만 필요로 하는 대신 Maintainer 역할을 요구합니다. 사용하는 모든 가져오기 도구에 대한 문서를 참조하세요.

15.10.0

  • Elastic Indexer Cron Workers의 버그로 인해 Sidekiq가 포화될 수 있습니다.
    • 이 문제가 발생하면 병합 요청이 병합되거나, 파이프라인, Slack 알림 및 기타 이벤트가 생성되지 않거나 발생하는 데 시간이 오래 걸립니다.
    • 이 문제는 Sidekiq가 충분히 포화되기까지 최대 일주일이 걸릴 수 있으므로 즉시 나타나지 않을 수 있습니다.
    • 이 문제가 발생하기 위해 Elasticsearch를 활성화할 필요는 없습니다.
    • 이 문제를 해결하려면 15.11로 업그레이드하거나 문제에 있는 해결 방법을 사용하세요.
  • 제로 다운타임 재색인화에 대한 버그로 인해 재색인 중 Couldn't load task status 오류가 발생할 수 있습니다. Elasticsearch 호스트에서 sliceId must be greater than 0 but was [-1] 오류가 발생할 수도 있습니다.
    해결 방법으로 처음부터 재색인화를 고려하거나 GitLab 16.3으로 업그레이드하세요.
  • Gitaly 구성은 Omnibus GitLab 16.0에서 크게 변경됩니다. Omnibus GitLab 15.10에서 새로운 구조로 마이그레이션을 시작할 수 있으며, Omnibus GitLab 16.0에 이르기까지 이전 버전과의 호환성이 유지됩니다. 이 변경 사항에 대해 자세히 알아보세요.

  • GitLab 15.10으로 업그레이드하는 동안 다음 오류가 발생할 수 있습니다:

    STDOUT: rake aborted!  
StandardError: An error has occurred, all later migrations canceled:  
PG::CheckViolation: ERROR:  check constraint "check_70f294ef54" is violated by some row

    이 오류는 GitLab 15.8에서 도입된 배치 배경 마이그레이션이 GitLab 15.10 이전에 완료되지 않아 발생합니다. 이 오류를 해결하려면:

    1. 데이터베이스 콘솔(sudo gitlab-psql로 Linux 패키지 설치용)을 사용하여 다음 SQL 문을 실행하세요:

      UPDATE oauth_access_tokens SET expires_in = '7200' WHERE expires_in IS NULL;

    2. 데이터베이스 마이그레이션 다시 실행하기.

  • GitLab 15.10으로 업그레이드하는 동안 다음 오류가 발생할 수도 있습니다:

    "exception.class": "ActiveRecord::StatementInvalid",  
"exception.message": "PG::SyntaxError: ERROR:  zero-length delimited identifier at or near \"\"\"\"\nLINE 1: ...COALESCE(\"lock_version\", 0) + 1 WHERE \"ci_builds\".\"\" IN (SEL...\n

    이 오류는 GitLab 14.9에서 도입된 배치 배경 마이그레이션이 GitLab 15.10으로 업그레이드하기 전에 완료되지 않아 발생합니다. 이 오류를 해결하기 위해 안전하게 마이그레이션을 완료된 것으로 표시하세요:

    # Rails 콘솔 시작  

connection = Ci::ApplicationRecord.connection  

Gitlab::Database::SharedModel.using_connection(connection) do  
  migration = Gitlab::Database::BackgroundMigration::BatchedMigration.find_for_configuration(  
    Gitlab::Database.gitlab_schemas_for_connection(connection), 'NullifyOrphanRunnerIdOnCiBuilds', :ci_builds, :id, [])  

  # 모든 작업을 완료로 표시  
  migration.batched_jobs.update_all(status: Gitlab::Database::BackgroundMigration::BatchedJob.state_machine.states[:succeeded].value)  
  migration.update_attribute(:status, Gitlab::Database::BackgroundMigration::BatchedMigration.state_machine.states[:finished].value)  
end

    자세한 내용은 문제 415724을 참조하세요.

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • pg_upgrade가 번들로 제공되는 PostregSQL 데이터베이스를 버전 13으로 업그레이드하는 데 실패합니다.
    자세한 내용과 작업arounds를 참조하세요.
  • 보조 사이트에서 LFS 객체를 복제할 때 보조 사이트가 완전히 동기화되어 있더라도 기본 사이트에서 다운로드됩니다.
    자세한 내용과 작업arounds를 참조하세요.

15.9.0

  • Elastic Indexer Cron Workers의 버그가 Sidekiq에서 포화 상태를 유발할 수 있습니다.
    • 이 문제가 발생하면 병합 요청 병합, 파이프라인, Slack 알림 및 기타 이벤트가 생성되지 않거나 발생하는 데 오랜 시간이 걸립니다.
    • 이 문제는 Sidekiq가 충분히 포화될 때까지 최대 1주일이 걸릴 수 있으므로 즉시 나타나지 않을 수 있습니다.
    • 이 문제가 발생하려면 Elasticsearch를 활성화할 필요가 없습니다.
    • 이 문제를 해결하려면 15.11로 업그레이드하거나 문제의 작업arounds를 사용하세요.
  • BackfillTraversalIdsToBlobsAndWikiBlobs 고급 검색 마이그레이션의 버그로 인해 Elasticsearch 클러스터가 포화될 수 있습니다.
    • 이 문제가 발생하면 검색 속도가 느려지고 Elasticsearch 클러스터에 대한 업데이트가 완료되는 데 오랜 시간이 걸릴 수 있습니다.
    • 이 문제를 해결하려면 GitLab 15.10으로 업그레이드하여 마이그레이션 배치 크기를 줄이세요.
  • 패치 릴리즈 15.9.3 이상으로 업그레이드하세요. 이는 두 개의 데이터베이스 마이그레이션 버그에 대한 수정 사항을 제공합니다:
    • 패치 릴리즈 15.9.0, 15.9.1, 15.9.2에는 사용자 프로필 필드 linkedin, twitter, skype, website_url,
      location, 및 organization에서 데이터 손실을 유발할 수 있는 버그가 있습니다. 자세한 내용은
      문제 393216을 참조하세요.
    • 두 번째 버그 수정은 15.4.x에서 직접 업그레이드할 수 있도록 보장합니다.
  • CI 파티셔닝 노력의 일환으로 ci_builds_needs에 새 외래 키가 추가되었습니다.
    GitLab 인스턴스의 CI 테이블이 큰 경우 이 제약 조건을 추가하는 데 평소보다 오래 걸릴 수 있습니다.

  • Praefect의 메타데이터 검증기 잘못된 메타데이터 삭제 동작이 이제 기본적으로 활성화되어 있습니다.

    메타데이터 검증기는 Praefect 데이터베이스에서 복제 기록을 처리하고 복제본이 실제로 Gitaly 노드에 존재하는지 확인합니다.
    복제본이 존재하지 않으면 해당 메타데이터 기록이 삭제됩니다. 이는 Praefect가 메타데이터 기록에 따라 복제본이 정상인 것으로 표시되지만
    실제로는 디스크에 존재하지 않는 상황을 수정 할 수 있도록 합니다.
    메타데이터 기록이 삭제된 후, Praefect의 리컨실러는 복제 직무를 예약하여 복제본을 재생성합니다.

    상태 관리 논리에 대한 과거 문제로 인해 데이터베이스에 잘못된 메타데이터 기록이 있을 수 있습니다.
    이러한 기록은 예를 들어, 저장소의 불완전한 삭제 또는 부분적으로 완료된 이름 변경 때문에 존재할 수 있습니다.
    검증기는 영향을 받은 저장소의 이러한 오래된 복제 기록을 삭제합니다.
    이러한 저장소는 복제 기록이 제거됨에 따라 메트릭 및 praefect dataloss 하위 명령에서 사용할 수 없는 저장소로 표시될 수 있습니다.
    이러한 저장소가 발생하면 praefect remove-repository를 사용하여 저장소의 나머지 기록을 제거하세요.

    GitLab 15.0 및 이후에서 검증기가 출력한 로그 기록을 검색하여 잘못된 메타데이터 기록이 있는 저장소를 찾을 수 있습니다.
    저장소 검증에 대한 자세한 내용과 예제 로그 항목을 보려면을 참조하세요.

  • Praefect 구성은 Omnibus GitLab 16.0에서 크게 변경됩니다. Omnibus GitLab 16.0에 대한 이전에 호환성을 유지하면서
    Omnibus GitLab 15.9에서 새로운 구조로 마이그레이션할 수 있습니다. 이 변경 사항에 대한 자세한 내용을 읽어보세요.

직접 컴파일한 설치

  • 직접 컴파일한 (소스) 설치의 경우, gitlab-sshd와 함께 Kerberos 헤더가 GitLab Shell을 빌드하는 데 필요합니다.

    sudo apt install libkrb5-dev

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • pg_upgrade는 번들된 PostregSQL 데이터베이스를 버전 13으로 업그레이드하는 데 실패합니다.
    자세한 내용 및 해결 방법을 확인하세요.
  • LFS 객체를 클론할 때, 이차 사이트에서 기본 사이트로 다운로드가 이루어지며, 이차 사이트가 완전히 동기화되었을 때도 발생합니다. 자세한 내용 및 해결 방법을 확인하세요.

15.8.2

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 몇 가지 Geo 설치에서 프로젝트 및 위키의 복제 및 검증이 계속되지 않는 문제를 발견했습니다.
    검증을 위해 “대기 중” 상태로 지속적으로 표시되는 프로젝트 및/또는 위키가 보인다면 귀하의 설치가 영향을 받을 수 있습니다.
    이는 장애 조치 이후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받은 버전: GitLab 버전 15.6.x, 15.7.x 및 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 및 이후.

15.8.1

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 몇 가지 Geo 설치에서 프로젝트 및 위키의 복제 및 검증이 계속되지 않는 문제를 발견했습니다.
    검증을 위해 “대기 중” 상태로 지속적으로 표시되는 프로젝트 및/또는 위키가 보인다면 귀하의 설치가 영향을 받을 수 있습니다.
    이는 장애 조치 이후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받은 버전: GitLab 버전 15.6.x, 15.7.x 및 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 및 이후.

15.8.0

Geo 설치

Tier: Premium, Ultimate

Offering: Self-managed

  • pg_upgrade는 번들로 제공되는 PostregSQL 데이터베이스를 버전 13으로 업그레이드하는 데 실패합니다. 세부 정보 및 해결 방법을 참조하세요.
  • 소수의 Geo 설치에서 프로젝트 및 위키의 복제 및 검증이 제대로 이루어지지 않는 문제가 발견되었습니다. 검증을 위해 “대기 중” 상태에 지속적으로 있는 프로젝트 및/또는 위키가 있는 경우 귀하의 설치가 영향을 받을 수 있습니다. 이는 장애 조치 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정 사항을 포함한 버전: GitLab 15.8.3 및 이후 버전.
  • 보조 사이트에서 LFS 객체 복제는 보조 사이트가 완전히 동기화되어 있더라도 기본 사이트에서 다운로드됩니다. 세부 정보 및 해결 방법을 참조하세요.

15.7.6

Geo 설치

Tier: Premium, Ultimate

Offering: Self-managed

  • 소수의 Geo 설치에서 프로젝트 및 위키의 복제 및 검증이 제대로 이루어지지 않는 문제가 발견되었습니다. 검증을 위해 “대기 중” 상태에 지속적으로 있는 프로젝트 및/또는 위키가 있는 경우 귀하의 설치가 영향을 받을 수 있습니다. 이는 장애 조치 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정 사항을 포함한 버전: GitLab 15.8.3 및 이후 버전.

15.7.5

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 우리는 소수의 Geo 설치에서 프로젝트와 위키의 복제 및 검증이 지연되는 문제를 발견했습니다. 검증을 위해 “대기 중” 상태에서 지속적으로 표시되는 일부 프로젝트 및/또는 위키가 있다면, 귀하의 설치가 영향을 받을 수 있습니다. 이는 장애 조치 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받은 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정이 포함된 버전: GitLab 15.8.3 이상.

15.7.4

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 우리는 소수의 Geo 설치에서 프로젝트와 위키의 복제 및 검증이 지연되는 문제를 발견했습니다. 검증을 위해 “대기 중” 상태에서 지속적으로 표시되는 일부 프로젝트 및/또는 위키가 있다면, 귀하의 설치가 영향을 받을 수 있습니다. 이는 장애 조치 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받은 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정이 포함된 버전: GitLab 15.8.3 이상.

15.7.3

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 우리는 소수의 Geo 설치에서 프로젝트 및 위키의 복제 및 검증이 제대로 이루어지지 않는 문제를 발견했습니다. 검증을 위해 일부 프로젝트 및/또는 위키가 “대기 중” 상태로 지속적으로 표시되는 경우, 귀하의 설치가 영향을 받을 수 있습니다. 이는 페일오버 이후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 및 이후 버전.

15.7.2

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 컨테이너 레지스트리 푸시 이벤트가 거부됩니다 /api/v4/container_registry_event/events 엔드포인트에 의해, 결과적으로 Geo 보조 사이트가 컨테이너 레지스트리 이미지에 대한 업데이트를 인식하지 못하고, 이후 업그레이드를 복제하지 않습니다. 이로 인해 페일오버 후 보조 사이트에 오래된 컨테이너 이미지가 포함될 수 있습니다. 이는 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2 버전에 영향을 미칩니다. 컨테이너 저장소와 함께 Geo를 사용하고 있다면, 이 문제의 수정 사항이 포함된 GitLab 15.6.7, 15.7.3 또는 15.8.0으로 업그레이드하는 것이 좋습니다. 이는 페일오버 후 잠재적인 데이터 손실을 피할 수 있습니다.
  • 우리는 소수의 Geo 설치에서 프로젝트 및 위키의 복제 및 검증이 제대로 이루어지지 않는 문제를 발견했습니다. 검증을 위해 일부 프로젝트 및/또는 위키가 “대기 중” 상태로 지속적으로 표시되는 경우, 귀하의 설치가 영향을 받을 수 있습니다. 이는 페일오버 이후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 및 이후 버전.

15.7.1

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 컨테이너 레지스트리 푸시 이벤트가 거부됩니다 /api/v4/container_registry_event/events 엔드포인트에서 컨테이너 레지스트리 이미지에 대한 업데이트를 Geo 보조 사이트에서 인식하지 못하고 결과적으로 업데이트를 복제하지 않습니다. 이는 장애 조치 이후 오래된 컨테이너 이미지가 보조 사이트에 남아있게 만들 수 있습니다. 이 문제는 버전 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2에 영향을 미칩니다. 컨테이너 레지스트리를 사용하는 Geo를 사용하는 경우 GitLab 15.6.7, 15.7.3 또는 이 문제에 대한 수정 사항이 포함된 GitLab 15.8.0으로 업그레이드하는 것이 좋습니다.
  • 프로젝트 및 위키의 복제 및 검증이 지연되고 있다는 문제가 소수의 Geo 설치에서 발견되었습니다. 검증을 위해 “대기 중” 상태로 지속적으로 남아 있는 프로젝트 및/또는 위키를 보는 경우 설치가 영향을 받을 수 있습니다. 이는 장애 조치 이후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 및 이후 버전.

15.7.0

  • 이 버전은 issues.work_item_type_id 열에 대한 NOT NULL DB 제약 조건을 검증합니다.
    이 버전으로 업그레이드하려면 issues 테이블에 NULL work_item_type_id가 포함된 레코드가 존재하지 않아야 합니다.
    여러 개의 BackfillWorkItemTypeIdForIssues 백그라운드 마이그레이션이 완료되면
    EnsureWorkItemTypeBackfillMigrationFinished 포스트 배포 마이그레이션으로 마무리됩니다.
  • GitLab 15.4.0에서 배치된 백그라운드 마이그레이션이 도입되어
    이슈 테이블의 namespace_id 값 백필을 수행합니다.
    이 마이그레이션은 대규모 GitLab 인스턴스에서 완료하는 데 몇 시간 또는 며칠이 걸릴 수 있습니다.
    15.7.0으로 업그레이드하기 전에 마이그레이션이 성공적으로 완료되었는지 확인하세요.

  • 데이터베이스 제약 조건이 추가되어 issues 테이블의 namespace_id 열에
    NULL 값이 없도록 지정합니다.

    • 15.4에서 namespace_id 배치된 백그라운드 마이그레이션이 실패한 경우(위 참조)
      15.7 업그레이드는 데이터베이스 마이그레이션 오류로 실패합니다.

    • 대규모 이슈 테이블을 가진 GitLab 인스턴스에서 이 제약 조건을 검증하는 것은
      업그레이드 시간이 평소보다 더 걸리게 만듭니다. 모든 데이터베이스 변경 사항은 1시간 내에 완료되어야 합니다:

      FATAL: Mixlib::ShellOut::CommandTimeout: rails_migration[gitlab-rails]  
[..]  
Mixlib::ShellOut::CommandTimeout: Command timed out after 3600s:

      데이터 변경 및 업그레이드를 수동으로 완료하는 우회 방법이 있습니다.

  • 기본 Sidekiq max_concurrency가 20으로 변경되었습니다. 이제
    문서 및 제품 기본 설정와 일치합니다.

    예를 들어, 이전에는:

    • 리눅스 패키지 설치 기본값 (sidekiq['max_concurrency']): 50
    • 스스로 컴파일한 설치 기본값: 50
    • Helm 차트 기본값 (gitlab.sidekiq.concurrency): 25

    참조 아키텍처는 여전히 10의 기본값을 사용합니다. 이는
    이러한 구성에 대해 특별히 설정되었기 때문입니다.

    max_concurrency를 구성한 사이트는 이 변경의 영향을 받지 않습니다.
    Sidekiq 동시성 설정에 대해 더 읽어보세요.

  • GitLab Runner 15.7.0에서 CI/CD 작업에 영향을 미치는 작업 파일 변수 확장을 올바르게 처리합니다.
    이전에는 작업에서 정의한 변수들이
    파일 유형 변수를 참조하는 경우
    파일 변수(내용)의 값으로 확장되었습니다. 이 동작은
    일반적인 셸 변수 확장 규칙을 준수하지 않았습니다. 또한
    파일 변수 및 그 내용을 출력할 경우 비밀 정보가 누출될 가능성이 있었습니다.
    예를 들어, echo 출력에서 인쇄되는 경우입니다. 더 많은 정보는
    GitLab 15.7의 파일 유형 변수 확장 변경 이해하기를 참조하세요.
  • GitLab 15.4에 도입된 버그로 인해 Gitaly 클러스터의 하나 이상의 Git 리포지토리가 사용할 수 없는 경우,
    리포지토리 검사 및
    Geo 복제 및 검증 모든 프로젝트 또는 프로젝트 위키 리포지토리에 대해 실행이 중지됩니다.
    이 버그는 GitLab 15.9.0에서 변경 사항을 되돌려 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용할 수 없는” 리포지토리가 있는지 확인하세요.
    버그 문제에 대한 자세한 정보를 참조하세요.
  • 보조 사이트에서 LFS 객체 복제가 기본 사이트에서 다운로드되며 보조 사이트가 완전히 동기화되어 있을 때도 발생합니다. 자세한 내용 및 우회 방법을 참조하세요.

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • pg_upgrade는 번들로 제공되는 PostregSQL 데이터베이스를 버전 13으로 업그레이드하는 데 실패합니다. 자세한 내용과 해결책은 여기서 확인하세요.

  • 컨테이너 레지스트리 푸시 이벤트가 거부됩니다. /api/v4/container_registry_event/events 엔드포인트로 인해 Geo 보조 사이트가 컨테이너 레지스트리 이미지에 대한 업데이트를 인식하지 못하고, 따라서 업데이트가 복제되지 않습니다. 보조 사이트는 장애 조치 후 구식 컨테이너 이미지가 포함될 수 있습니다. 이는 버전 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2에 영향을 미칩니다. Geo를 컨테이너 레포지토리와 함께 사용 중인 경우 이 문제의 수정 사항이 포함된 GitLab 15.6.7, 15.7.3 또는 15.8.0으로 업그레이드할 것을 권장합니다.

  • 우리는 소수의 Geo 설치에서 프로젝트 및 위키의 복제 및 검증이 유지되지 않는 문제를 발견했습니다. 설치에서 일부 프로젝트 및/또는 위키가 “대기 중” 상태로 지속적으로 표시되면 영향을 받을 수 있습니다. 이는 장애 조치 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 및 이후 버전.

15.6.7

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 우리는 소수의 Geo 설치에서 프로젝트 및 위키의 복제 및 검증이 유지되지 않는 문제를 발견했습니다. 설치에서 일부 프로젝트 및/또는 위키가 “대기 중” 상태로 지속적으로 표시되면 영향을 받을 수 있습니다. 이는 장애 조치 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 및 이후 버전.

15.6.6

Geo installations

Tier: Premium, Ultimate

Offering: Self-managed

  • 컨테이너 레지스트리 푸시 이벤트가 /api/v4/container_registry_event/events 엔드포인트에 의해 거부되어 Geo 2차 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인식하지 못하고 해당 업데이트를 복제하지 않습니다. 이로 인해 2차 사이트는 장애 조치(failover) 후 구식 컨테이너 이미지를 포함할 수 있습니다. 이는 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2 버전에 영향을 미칩니다. 컨테이너 저장소와 함께 Geo를 사용하는 경우, 이 문제에 대한 수정 사항이 포함된 GitLab 15.6.7, 15.7.3 또는 15.8.0으로 업그레이드하는 것이 좋습니다. 장애 조치 후 잠재적인 데이터 손실을 피할 수 있습니다.
  • 프로젝트 및 위키의 복제 및 검증이 지연되는 문제를 발견했습니다. 소수의 Geo 설치에서 발생했습니다. 검증을 위해 “대기 중(Queued)” 상태로 지속적으로 남아 있는 프로젝트 및/또는 위키가 있는 경우, 귀하의 설치가 영향을 받을 수 있습니다. 이로 인해 장애 조치 후 데이터 손실이 발생할 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 및 이후 버전.

15.6.5

Geo installations

Tier: Premium, Ultimate

Offering: Self-managed

  • 컨테이너 레지스트리 푸시 이벤트가 /api/v4/container_registry_event/events 엔드포인트에 의해 거부되어 Geo 2차 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인식하지 못하고 해당 업데이트를 복제하지 않습니다. 이로 인해 2차 사이트는 장애 조치(failover) 후 구식 컨테이너 이미지를 포함할 수 있습니다. 이는 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2 버전에 영향을 미칩니다. 컨테이너 저장소와 함께 Geo를 사용하는 경우, 이 문제에 대한 수정 사항이 포함된 GitLab 15.6.7, 15.7.3 또는 15.8.0으로 업그레이드하는 것이 좋습니다. 장애 조치 후 잠재적인 데이터 손실을 피할 수 있습니다.
  • 프로젝트 및 위키의 복제 및 검증이 지연되는 문제를 발견했습니다. 소수의 Geo 설치에서 발생했습니다. 검증을 위해 “대기 중(Queued)” 상태로 지속적으로 남아 있는 프로젝트 및/또는 위키가 있는 경우, 귀하의 설치가 영향을 받을 수 있습니다. 이로 인해 장애 조치 후 데이터 손실이 발생할 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 및 이후 버전.
  • GitLab 15.4에 도입된 버그로 인해, Gitaly Cluster의 하나 이상의 Git 저장소가 사용 불가인 경우, 영향을 받은 Gitaly Cluster의 모든 프로젝트 또는 프로젝트 위키 저장소에 대해 저장소 검사 및 Geo 복제 및 검증이 중단됩니다. 이 버그는 GitLab 15.9.0에서 변경 사항을 되돌려서 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가” 저장소가 있는지 확인하세요. 자세한 내용은 버그 문제를 참조하세요.

15.6.4

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 컨테이너 레지스트리 푸시 이벤트가 거부됩니다 /api/v4/container_registry_event/events 엔드포인트에 의해, 그 결과로 Geo 보조 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인식하지 못하고 진행된 업데이트를 복제하지 않게 됩니다. 이로 인해 보조 사이트에는 페일오버 후 구버전의 컨테이너 이미지가 포함될 수 있습니다. 이는 15.6.0 - 15.6.6, 그리고 15.7.0 - 15.7.2 버전에 영향을 미칩니다. 컨테이너 리포지토리와 함께 Geo를 사용 중이라면, 이 문제에 대한 수정 사항이 포함된 GitLab 15.6.7, 15.7.3 또는 15.8.0으로 업그레이드할 것을 권장합니다. 이는 페일오버 후 데이터 손실의 가능성을 피할 수 있습니다.
  • 프로젝트와 위키의 복제 및 검증이 유지되지 않는 문제를 발견했습니다. 소수의 Geo 설치에서 발생하고 있습니다. 검증을 위해 ‘대기’ 상태에서 지속되는 프로젝트 및/또는 위키가 보이는 경우, 귀하의 설치에 영향을 미칠 수 있습니다. 이는 페일오버 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받은 버전: GitLab 버전 15.6.x, 15.7.x, 그리고 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 이후.
  • GitLab 15.4에서 도입된 버그로 인해, Gitaly 클러스터 내 하나 이상의 Git 리포지토리가 사용 불가능한 경우, 저장소 검증 및 Geo 복제 및 검증이 영향을 받은 Gitaly 클러스터 내 모든 프로젝트 또는 프로젝트 위키 리포지토리에서 실행 중지됩니다. 이 버그는 GitLab 15.9.0에서 변경 사항을 되돌림으로써 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능한” 저장소가 있는지 확인하세요. 자세한 내용은 버그 이슈를 참조하세요.

15.6.3

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • 컨테이너 레지스트리 푸시 이벤트가 거부됩니다 /api/v4/container_registry_event/events 엔드포인트에 의해, 그 결과로 Geo 보조 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인식하지 못하고 진행된 업데이트를 복제하지 않게 됩니다. 이로 인해 보조 사이트에는 페일오버 후 구버전의 컨테이너 이미지가 포함될 수 있습니다. 이는 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2 버전에 영향을 미칩니다. 컨테이너 리포지토리와 함께 Geo를 사용 중이라면, 이 문제에 대한 수정 사항이 포함된 GitLab 15.6.7, 15.7.3 또는 15.8.0으로 업그레이드할 것을 권장합니다. 이는 페일오버 후 데이터 손실의 가능성을 피할 수 있습니다.
  • 프로젝트와 위키의 복제 및 검증이 유지되지 않는 문제를 발견했습니다. 소수의 Geo 설치에서 발생하고 있습니다. 검증을 위해 ‘대기’ 상태에서 지속되는 프로젝트 및/또는 위키가 보이는 경우, 귀하의 설치에 영향을 미칠 수 있습니다. 이는 페일오버 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받은 버전: GitLab 버전 15.6.x, 15.7.x, 그리고 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 이후.
  • GitLab 15.4에서 도입된 버그로 인해, Gitaly 클러스터 내 하나 이상의 Git 리포지토리가 사용 불가능한 경우, 저장소 검증 및 Geo 복제 및 검증이 영향을 받은 Gitaly 클러스터 내 모든 프로젝트 또는 프로젝트 위키 리포지토리에서 실행 중지됩니다. 이 버그는 GitLab 15.9.0에서 변경 사항을 되돌림으로써 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능한” 저장소가 있는지 확인하세요. 자세한 내용은 버그 이슈를 참조하세요.

15.6.2

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed

  • 컨테이너 레지스트리 푸시 이벤트가 거부됩니다 /api/v4/container_registry_event/events 엔드포인트에서, 이로 인해 Geo 보조 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인지하지 못하고 이후에 업데이트를 복제하지 않게 됩니다. 보조 사이트는 장애 조치 후 구버전 컨테이너 이미지를 포함할 수 있습니다. 이는 버전 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2에 영향을 미칩니다. 컨테이너 리포지토리와 함께 Geo를 사용하는 경우, 이 문제를 해결한 GitLab 15.6.7, 15.7.3 또는 15.8.0으로 업그레이드할 것을 권장합니다. 이는 장애 조치 후 잠재적인 데이터 손실을 피하는 데 도움이 됩니다.

  • 프로젝트 및 위키의 복제 및 검증이 유지되지 않는 문제를 발견했습니다 소수의 Geo 설치에서. 검증을 위해 “대기 중” 상태로 지속적으로 표시되는 프로젝트 및/또는 위키가 있는 경우, 귀하의 설치가 영향을 받을 수 있습니다. 이는 장애 조치 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x 및 15.8.0 - 15.8.2.
    • 수정이 포함된 버전: GitLab 15.8.3 및 이후 버전.
  • GitLab 15.4에서 도입된 버그로 인해, Gitaly 클러스터 내의 하나 이상의 Git 리포지토리가 사용 불가능한 경우, 리포지토리 검사와 Geo 복제 및 검증이 영향을 받은 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지토리에 대해 실행을 중단합니다. 이 버그는 GitLab 15.9.0에서 변경 사항을 되돌림으로써 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능한” 리포지토리가 있는지 확인하세요. 추가 정보는 버그 문제를 참조하세요.

15.6.1

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed

  • 컨테이너 레지스트리 푸시 이벤트가 거부됩니다 /api/v4/container_registry_event/events 엔드포인트에서, 이로 인해 Geo 보조 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인지하지 못하고 이후에 업데이트를 복제하지 않게 됩니다. 보조 사이트는 장애 조치 후 구버전 컨테이너 이미지를 포함할 수 있습니다. 이는 버전 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2에 영향을 미칩니다. 컨테이너 리포지토리와 함께 Geo를 사용하는 경우, 이 문제를 해결한 GitLab 15.6.7, 15.7.3 또는 15.8.0으로 업그레이드할 것을 권장합니다. 이는 장애 조치 후 잠재적인 데이터 손실을 피하는 데 도움이 됩니다.

  • 프로젝트 및 위키의 복제 및 검증이 유지되지 않는 문제를 발견했습니다 소수의 Geo 설치에서. 검증을 위해 “대기 중” 상태로 지속적으로 표시되는 프로젝트 및/또는 위키가 있는 경우, 귀하의 설치가 영향을 받을 수 있습니다. 이는 장애 조치 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x 및 15.8.0 - 15.8.2.
    • 수정이 포함된 버전: GitLab 15.8.3 및 이후 버전.
  • GitLab 15.4에서 도입된 버그로 인해, Gitaly 클러스터 내의 하나 이상의 Git 리포지토리가 사용 불가능한 경우, 리포지토리 검사와 Geo 복제 및 검증이 영향을 받은 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지토리에 대해 실행을 중단합니다. 이 버그는 GitLab 15.9.0에서 변경 사항을 되돌림으로써 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능한” 리포지토리가 있는지 확인하세요. 추가 정보는 버그 문제를 참조하세요.

15.6.0

  • 공식 지원되는 PostgreSQL 버전을 사용해야 합니다. 일부 데이터베이스 마이그레이션은 이전 PostgreSQL 버전에서 안정성과 성능 문제를 일으킬 수 있습니다.

  • Git 2.37.0 이상이 Gitaly에서 필요합니다. 자체 컴파일된 설치의 경우, Gitaly에서 제공하는 Git 버전을 사용해야 합니다.

  • 네 개의 인덱스 행동을 수정하는 데이터베이스 변경이 이 인스턴스에서 인덱스가 존재하지 않아 실패합니다:

    Caused by:
PG::UndefinedTable: ERROR:  relation "index_issues_on_title_trigram" does not exist

    나머지 세 개의 인덱스는: index_merge_requests_on_title_trigram, index_merge_requests_on_description_trigram, 그리고 index_issues_on_description_trigram입니다.

    이 문제는 GitLab 15.7에서 수정되었습니다 및 GitLab 15.6.2에 이전되었습니다. 이 문제는 다음과 같이 해결할 수도 있습니다: 이 인덱스를 생성하는 방법을 읽어보세요.

Linux 패키지 설치

GitLab 15.6에서 omnibus-gitlab 패키지와 함께 제공되는 PostgreSQL 버전이 12.12와 13.8로 업그레이드되었습니다. 명시적으로 선택 해제하지 않는 한, 이로 인해 PostgreSQL 서비스가 자동으로 재시작될 수 있으며, 잠재적으로 다운타임이 발생할 수 있습니다.

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed

  • pg_upgrade가 번들된 PostregSQL 데이터베이스를 버전 13으로 업그레이드하는 데 실패합니다. 자세한 내용 및 해결 방법을 참조하세요.

  • 컨테이너 레지스트리 푸시 이벤트가 거부됩니다 /api/v4/container_registry_event/events 엔드포인트에 의해 초래되어 Geo 보조 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인식하지 못하고 결과적으로 업데이트를 복제하지 못합니다. 보조 사이트는 장애 조치 후 오래된 컨테이너 이미지를 포함할 수 있습니다. 이는 버전 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2에 영향을 미칩니다. 컨테이너 리포지토리와 함께 Geo를 사용 중이라면, 이 문제를 해결하고 장애 조치 후 잠재적인 데이터 손실을 방지하기 위해 GitLab 15.6.7, 15.7.3 또는 15.8.0으로 업그레이드하는 것이 좋습니다.

  • 몇 개의 Geo 설치에서 프로젝트 및 위키의 복제 및 검증이 따라가지 못하는 문제를 발견했습니다. 확인을 위해 “대기 중” 상태에 지속적으로 있는 프로젝트 및/또는 위키가 있는 경우, 귀하의 설치가 영향을 받을 수 있습니다. 이로 인해 장애 조치 후 데이터 손실이 발생할 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x, 및 15.8.0 - 15.8.2.
    • 수정된 버전: GitLab 15.8.3 이상.

  • GitLab 15.4에서 도입된 버그로 인해, Gitaly 클러스터에 하나 이상의 Git 리포지토리가 사용 불가능한 경우, 리포지토리 검사 및 Geo 복제 및 검증이 영향을 받는 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지토리에 대해 실행되지 않습니다. 이 버그는 GitLab 15.9.0에서 변경 사항을 되돌려 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능한” 리포지토리가 있는지 확인하세요. 자세한 내용은 버그 이슈를 참조하세요.

  • 보조 사이트에서 LFS 객체를 복제하면 주 사이트에서 다운로드되며, 보조 사이트가 완전히 동기화되어 있어도 마찬가지입니다. 자세한 내용 및 해결 방법을 보세요.

15.5.5

15.5.4

15.5.3

  • GitLab 15.4.0은 모든 작업을 default 큐로 라우팅하는 기본 Sidekiq 라우팅 규칙을 도입했습니다. 큐 선택기를 사용하는 인스턴스에서는 일부 Sidekiq 프로세스가 유휴 상태가 되어 성능 문제가 발생합니다.

    • 기본 라우팅 규칙은 15.5.4에서 롤백되었으므로 해당 버전 또는 이후 버전으로 업그레이드하면 이전 동작으로 돌아갑니다.

    • 현재 GitLab 인스턴스가 default 큐만 수신하는 경우(현재 권장되지 않음), 이 라우팅 규칙을 /etc/gitlab/gitlab.rb에 다시 추가해야 합니다:

      sidekiq['routing_rules'] = [['*', 'default']]

  • GitLab 15.4에서 도입된 버그로 인해 Gitaly 클러스터의 하나 이상의 Git 저장소가 사용 불가능한 경우, 해당 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 저장소에 대해 저장소 검사 및 Geo 복제 및 검증이 중단됩니다. 이 버그는 GitLab 15.9.0에서 변경사항을 롤백하여 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능” 저장소가 있는지 확인하세요. 자세한 내용은 버그 이슈를 참조하세요.

15.5.2

  • GitLab 15.4.0에서는 모든 작업을 default 큐로 라우팅하는 기본 Sidekiq 라우팅 규칙을 도입했습니다. 큐 선택기를 사용하는 인스턴스에서는 일부 Sidekiq 프로세스가 유휴 상태가 되어 성능 문제를 초래합니다.

    • 기본 라우팅 규칙은 15.5.4에서 되돌려졌으므로 해당 버전 이상으로 업그레이드하면 이전 동작으로 돌아갑니다.

    • 현재 GitLab 인스턴스가 default 큐만 수신하는 경우(현재 추천되지 않음), /etc/gitlab/gitlab.rb에 이 라우팅 규칙을 다시 추가해야 합니다:

      sidekiq['routing_rules'] = [['*', 'default']]

  • GitLab 15.4에서 도입된 버그로 인해 Gitaly 클러스터의 하나 이상의 Git 리포지토리가 사용 가능하지 않을 경우, 리포지토리 검사 및 Geo 복제 및 검증이 영향을 받은 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지토리에 대해 실행을 중단합니다. 이 버그는 GitLab 15.9.0에서 변경 사항을 되돌림으로써 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 가능하지 않은” 리포지토리가 있는지 확인하세요. 자세한 내용은 버그 이슈를 참조하세요.

15.5.1

  • GitLab 15.4.0에서는 모든 작업을 default 큐로 라우팅하는 기본 Sidekiq 라우팅 규칙을 도입했습니다. 큐 선택기를 사용하는 인스턴스에서는 일부 Sidekiq 프로세스가 유휴 상태가 되어 성능 문제를 초래합니다.

    • 기본 라우팅 규칙은 15.5.4에서 되돌려졌으므로 해당 버전 이상으로 업그레이드하면 이전 동작으로 돌아갑니다.

    • 현재 GitLab 인스턴스가 default 큐만 수신하는 경우(현재 추천되지 않음), /etc/gitlab/gitlab.rb에 이 라우팅 규칙을 다시 추가해야 합니다:

      sidekiq['routing_rules'] = [['*', 'default']]

  • GitLab 15.4에서 도입된 버그로 인해 Gitaly 클러스터의 하나 이상의 Git 리포지토리가 사용 가능하지 않을 경우, 리포지토리 검사 및 Geo 복제 및 검증이 영향을 받은 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지토리에 대해 실행을 중단합니다. 이 버그는 GitLab 15.9.0에서 변경 사항을 되돌림으로써 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 가능하지 않은” 리포지토리가 있는지 확인하세요. 자세한 내용은 버그 이슈를 참조하세요.

15.5.0

Geo installations

Tier: Premium, Ultimate

Offering: Self-managed

  • pg_upgrade가 번들된 PostregSQL 데이터베이스를 버전 13으로 업그레이드하지 못합니다. 자세한 사항과 해결 방법을 참조하세요.
  • LFS 객체를 보조 사이트에서 복제할 때 주 사이트에서 다운로드되며, 보조 사이트가 완전히 동기화되어 있어도 마찬가지입니다. 자세한 사항과 해결 방법을 참조하세요.

15.4.6

15.4.5

15.4.4

15.4.3

15.4.2

  • 라이선스 캐싱 문제로 인해 새 라이선스를 추가하면 GitLab의 일부 프리미엄 기능이 올바르게 작동하지 않습니다. 이 문제에 대한 해결 방법은 다음과 같습니다:

    • 새 라이선스를 적용한 후 모든 Rails, Sidekiq, Gitaly 노드를 재시작합니다. 이는 관련 라이선스 캐시를 지우고 모든 프리미엄 기능이 올바르게 작동하도록 합니다.

    • 이 문제의 영향을 받지 않는 버전으로 업그레이드합니다. 영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:

      • 15.2.5 –> 15.3.5

      • 15.3.0 - 15.3.4 –> 15.3.5

      • 15.4.1 –> 15.4.3

  • GitLab 15.4에서 도입된 버그로 인해, Gitaly 클러스터에서 하나 이상의 Git 저장소가 사용 불가능한 경우, 영향을 받은 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 저장소에 대해 저장소 검사 및 지오 복제 및 검증이 중지됩니다. 이 버그는 GitLab 15.9.0에서 변경 사항을 되돌려 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능” 저장소가 있는지 확인하세요. 자세한 내용은 버그 문제를 참조하세요.

15.4.1

  • 라이선스 캐싱 이슈로 인해 새로운 라이선스를 추가하면 GitLab의 일부 프리미엄 기능이 제대로 작동하지 않습니다. 이 문제에 대한 해결 방법은 다음과 같습니다:

    • 새로운 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 재시작합니다. 이렇게 하면 관련 라이선스 캐시가 지워지고 모든 프리미엄 기능이 올바르게 작동합니다.

    • 이 문제의 영향을 받지 않는 버전으로 업그레이드합니다. 영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:

      • 15.2.5 –> 15.3.5

      • 15.3.0 - 15.3.4 –> 15.3.5

      • 15.4.1 –> 15.4.3

  • GitLab 15.4에서 도입된 버그로 인해 Gitaly 클러스터 내의 하나 이상의 Git 저장소가 사용 불가능하면, 저장소 검사 및 Geo 복제 및 검증이 영향을 받는 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 저장소에 대해 실행되지 않습니다. 이 버그는 GitLab 15.9.0에서 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능” 저장소가 있는지 확인하십시오. 자세한 내용은 버그 이슈를 참조하십시오.

15.4.0

  • GitLab 15.4.0은 ci_job_artifacts 테이블의 expire_at에서 잘못된 값을 제거하기 위한 배치 백그라운드 마이그레이션을 포함합니다. 이 마이그레이션은 더 큰 GitLab 인스턴스에서 완료하는 데 몇 시간 또는 며칠이 걸릴 수 있습니다.

  • 기본적으로 Gitaly 및 Praefect 노드는 pool.ntp.org의 시간 서버를 사용합니다. 인스턴스가 pool.ntp.org에 연결할 수 없는 경우, NTP_HOST 변수를 설정해야 합니다. 그렇지 않으면 로그 및 gitlab-rake gitlab:gitaly:check의 출력에서 ntp: read udp ... i/o timeout 오류가 발생할 수 있습니다. 다만, Gitaly 호스트의 시간이 동기화되어 있으면 이러한 오류는 무시할 수 있습니다.

  • GitLab 15.4.0에서는 모든 작업을 default 큐로 라우팅하는 기본 Sidekiq 라우팅 규칙을 도입했습니다. 큐 선택기를 사용하는 인스턴스에서는 일부 Sidekiq 프로세스가 유휴 상태가 되어 성능 문제가 발생할 수 있습니다.

    • 기본 라우팅 규칙은 15.4.5에서 되돌려졌으므로 해당 버전 또는 이후 버전으로 업그레이드하면 이전 동작으로 돌아갑니다.

    • 현재 GitLab 인스턴스가 default 큐에만 수신 대기하는 경우(현재 권장되지 않음) /etc/gitlab/gitlab.rb에 이 라우팅 규칙을 다시 추가해야 합니다:

      sidekiq['routing_rules'] = [['*', 'default']]

  • /etc/gitlab/gitlab-secrets.json의 구조가 GitLab 15.4에서 수정되었으며, gitlab_pages, grafana, mattermost 섹션에 대한 새로운 구성이 추가되었습니다. 고 가용성 또는 GitLab Geo 환경에서는 모든 노드에서 비밀이 동일해야 합니다. 노드 간에 비밀 파일을 수동으로 동기화하거나 /etc/gitlab/gitlab.rb에서 비밀을 수동으로 지정하는 경우, /etc/gitlab/gitlab-secrets.json이 모든 노드에서 동일한지 확인하십시오.

  • GitLab 15.4.0은 문제 테이블의 namespace_id 값을 백필하기 위한 배치 백그라운드 마이그레이션을 도입했습니다. 이 마이그레이션은 더 큰 GitLab 인스턴스에서 완료하는 데 여러 시간 또는 며칠이 걸릴 수 있습니다. 15.7.0 이상으로 업그레이드하기 전에 마이그레이션이 성공적으로 완료되었는지 확인하십시오.

  • GitLab 15.4에서 도입된 버그로 인해 Gitaly 클러스터 내의 하나 이상의 Git 저장소가 사용 불가능하면, 저장소 검사 및 Geo 복제 및 검증이 영향을 받는 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 저장소에 대해 실행되지 않습니다. 이 버그는 GitLab 15.9.0에서 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능” 저장소가 있는지 확인하십시오. 자세한 내용은 버그 이슈를 참조하십시오.

  • GitLab 15.4 및 이후 버전에서는 개선 사항이 포함된 새롭게 디자인된 로그인 페이지가 기본적으로 활성화되어 있습니다. 자세한 내용은 Epic 8557를 참조하십시오. 기능 플래그로 비활성화할 수 있습니다. Rails 콘솔을 시작하고 다음을 실행하십시오:

    Feature.disable(:restyle_login_page)

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • pg_upgrade가 번들된 PostregSQL 데이터베이스를 버전 13으로 업그레이드하는 데 실패합니다.
    자세한 내용 및 해결 방법을 참조하세요.
  • 보조 사이트에서 LFS 객체를 복제할 때, 보조 사이트가 완전히 동기화되었음에도 불구하고 기본 사이트에서 다운로드됩니다.
    자세한 내용 및 해결 방법을 참조하세요.

15.3.4

라이선스 캐싱 문제로 인해 새로운 라이선스를 추가하면 GitLab의 일부 프리미엄 기능이 올바르게 작동하지 않습니다. 이 문제에 대한 해결 방법:

  • 새로운 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 재시작합니다.
    이는 관련된 라이선스 캐시를 지우고 모든 프리미엄 기능이 올바르게 작동하도록 합니다.

  • 이 문제에 영향을 받지 않는 버전으로 업그레이드합니다.
    영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:

    • 15.2.5 –> 15.3.5
    • 15.3.0 - 15.3.4 –> 15.3.5
    • 15.4.1 –> 15.4.3

15.3.3

  • GitLab 15.3.3에서, SAML 그룹 링크 API의 access_level 속성 유형이 integer로 변경되었습니다.
    API 문서를 참조하세요.

  • 라이선스 캐싱 문제로 인해 새로운 라이선스를 추가하면 GitLab의 일부 프리미엄 기능이 올바르게 작동하지 않습니다. 이 문제에 대한 해결 방법:

    • 새로운 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 재시작합니다.
      이는 관련된 라이선스 캐시를 지우고 모든 프리미엄 기능이 올바르게 작동하도록 합니다.

    • 이 문제에 영향을 받지 않는 버전으로 업그레이드합니다.
      영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:

      • 15.2.5 –> 15.3.5
      • 15.3.0 - 15.3.4 –> 15.3.5
      • 15.4.1 –> 15.4.3

15.3.2

라이선스 캐싱 문제로 인해 새로운 라이선스를 추가하면 GitLab의 일부 프리미엄 기능이 올바르게 작동하지 않습니다. 이 문제에 대한 해결 방법:

  • 새로운 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 재시작합니다.
    이는 관련된 라이선스 캐시를 지우고 모든 프리미엄 기능이 올바르게 작동하도록 합니다.

  • 이 문제에 영향을 받지 않는 버전으로 업그레이드합니다.
    영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:

    • 15.2.5 –> 15.3.5
    • 15.3.0 - 15.3.4 –> 15.3.5
    • 15.4.1 –> 15.4.3

15.3.1

라이선스 캐싱 문제로 인해 새로운 라이선스를 추가하면 GitLab의 일부 프리미엄 기능이 올바르게 작동하지 않습니다. 이 문제에 대한 해결 방법:

  • 새로운 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 재시작합니다.
    이는 관련된 라이선스 캐시를 지우고 모든 프리미엄 기능이 올바르게 작동하도록 합니다.

  • 이 문제에 영향을 받지 않는 버전으로 업그레이드합니다.
    영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:

    • 15.2.5 –> 15.3.5
    • 15.3.0 - 15.3.4 –> 15.3.5
    • 15.4.1 –> 15.4.3

15.3.0

  • Gitaly 클러스터에서 새로 생성된 Git 리포지토리는 더 이상 @hashed 저장 경로를 사용하지 않습니다. 새 리포지토리에 대한 서버 훅은 다른 위치로 복사되어야 합니다. Praefect는 이제 Gitaly 클러스터에서 사용할 복제 경로를 생성합니다. 이 변경은 Gitaly 클러스터에서 Git 리포지토리를 원자적으로 생성, 삭제 및 이름 변경하기 위한 전제 조건입니다.

    복제 경로를 식별하려면, Praefect 리포지토리 메타데이터를 쿼리하세요 그리고 @hashed 저장 경로를 -relative-path에 전달하세요.

    이 정보를 통해 서버 훅을 올바르게 설치할 수 있습니다.

  • 라이선스 캐싱 문제로 인해 새 라이선스를 추가하면 일부 프리미엄 기능이 올바르게 작동하지 않습니다. 이 문제에 대한 해결 방법:

    • 새 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 재시작하세요. 이렇게 하면 관련 라이선스 캐시가 지워져 모든 프리미엄 기능이 올바르게 작동합니다.

    • 이 문제의 영향을 받지 않는 버전으로 업그레이드하세요. 영향을 받는 버전에 대한 다음 업그레이드 경로가 있습니다:

      • 15.2.5 –> 15.3.5
      • 15.3.0 - 15.3.4 –> 15.3.5
      • 15.4.1 –> 15.4.3

Geo installations

Tier: Premium, Ultimate Offering: Self-managed

LFS transfers redirect to primary from secondary site mid-session

영향을 받는 마이너 릴리즈 영향을 받는 패치 릴리즈 수정된 버전
15.1 모두 없음
15.2 모두 없음
15.3 15.3.0 - 15.3.2 15.3.3 이상

LFS 전송이 미세션 중에 주사이트에서 보조사이트로 리다이렉트될 수 있습니다,
이로 인해 GitLab 15.1.0에서 15.3.2까지의 풀 및 클론 요청이 실패하게 됩니다
Geo 프록시가 활성화된 경우. Geo 프록시는 GitLab 15.1 이상에서 기본적으로 활성화되어 있습니다.

이 문제는 GitLab 15.3.3에서 해결되었으므로, 다음 구성을 가진 고객은 15.3.3 이상으로 업그레이드해야 합니다:

  • LFS가 활성화되어 있습니다.
  • LFS 객체가 Geo 사이트 간에 복제되고 있습니다.
  • 리포지토리가 Geo 보조 사이트를 사용하여 풀되고 있습니다.
  • 보조 사이트에서 LFS 객체를 클론할 때 주사이트에서 다운로드되며 보조 사이트가 완전히 동기화되어 있어도 마찬가지입니다.
    자세한 내용 및 해결 방법을 참조하세요.

잘못된 객체 저장소 LFS 파일 삭제에 대한 2차 사이트

영향을 받는 마이너 릴리즈 영향을 받는 패치 릴리즈 수정됨
15.0 모두 없음
15.1 모두 없음
15.2 모두 없음
15.3 15.3.0 - 15.3.2 15.3.3 및 이후

Geo 2차 사이트에서 객체 저장소 파일의 잘못된 삭제는 다음 상황에서 GitLab 15.0.0에서 15.3.2까지 발생할 수 있습니다:

  • GitLab 관리 객체 저장소 복제가 비활성화되어 있고, 객체 저장소가 활성화된 프로젝트를 가져오는 동안 LFS 객체가 생성됩니다.
  • GitLab 관리 복제가 객체 저장소를 동기화하도록 활성화된 후 비활성화됩니다.

이 문제는 15.3.3에서 해결됩니다. LFS가 활성화되어 있고 LFS 객체가 Geo 사이트 간에 복제되고 있는 고객은 2차 사이트에서 데이터 손실 위험을 줄이기 위해 15.3.3으로 직접 업그레이드해야 합니다.

15.2.5

새 라이센스를 추가할 경우 라이센스 캐싱 문제로 인해 GitLab의 일부 프리미엄 기능이 올바르게 작동하지 않습니다. 이 문제에 대한 해결 방법:

  • 새 라이센스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 재시작합니다. 이는 관련 라이센스 캐시를 지우고 모든 프리미엄 기능이 올바르게 작동하도록 합니다.
  • 이 문제에 영향을 받지 않는 버전으로 업그레이드합니다. 영향을 받는 버전의 업그레이드 경로는 다음과 같습니다:
    • 15.2.5 –> 15.3.5
    • 15.3.0 - 15.3.4 –> 15.3.5
    • 15.4.1 –> 15.4.3

15.2.0

  • 여러 웹 노드가 있는 GitLab 설치는 15.1로 업그레이드한 후 15.2(및 이후)로 업그레이드해야 합니다. 이는 ETag 키 생성이 불일치하게 될 수 있는 Rails의 구성 변경 때문입니다.
  • 이 릴리즈에서 일부 Sidekiq 작업자가 이름이 변경되었습니다. 중단을 피하기 위해 보류 중인 작업을 마이그레이션하기 위해 Rake 작업을 실행하세요 GitLab 15.2.0으로 업그레이드하기 전에.

  • Gitaly는 이제 런타임 위치에서 이진 파일을 실행합니다. Omnibus GitLab의 경우 기본적으로 이 경로는 /var/opt/gitlab/gitaly/run/입니다. 이 위치가 noexec로 마운트 되어 있으면 병합 요청에서 다음과 같은 오류가 발생합니다:

    fork/exec /var/opt/gitlab/gitaly/run/gitaly-<nnnn>/gitaly-git2go-v15: permission denied

    이를 해결하려면 파일 시스템 마운트에서 noexec 옵션을 제거하세요. 대안으로 Gitaly 런타임 디렉토리를 변경할 수 있습니다:

    1. /etc/gitlab/gitlab.rb에 gitaly['runtime_dir'] = '<PATH_WITH_EXEC_PERM>'를 추가하고 noexec가 설정되지 않은 위치를 지정합니다.
    2. sudo gitlab-ctl reconfigure를 실행하세요.

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed
  • pg_upgrade가 번들된 PostgreSQL 데이터베이스를 버전 13으로 업그레이드하지 못합니다.
    세부정보 및 해결 방법을 참조하세요.
  • LFS 전송이 세션 중에 보조 사이트에서 주요 사이트로 리디렉션 될 수 있습니다.
    세부정보 및 해결 방법을 참조하세요.
  • Geo 보조 사이트에서 잘못된 객체 스토리지 LFS 파일 삭제가 발생합니다.
    세부정보 및 해결 방법을 참조하세요.
  • 보조 사이트에서 LFS 객체를 복제하면 부가적으로 동기화가 완료되었더라도 주요 사이트에서 다운로드됩니다.
    세부정보 및 해결 방법을 참조하세요.

15.1.0

  • GitLab 15.1.0에서는 Rails ActiveSupport::Digest를 MD5 대신 SHA256을 사용하도록 전환합니다.
    이것은 원시 스니펫 파일 다운로드와 같은 리소스의 ETag 키 생성에 영향을 미칩니다.
    업그레이드할 때 여러 웹 노드 전반에 걸쳐 일관된 ETag 키 생성을 보장하려면 모든 서버를 먼저 15.1.6으로 업그레이드한 후
    15.2.0 이상으로 업그레이드해야 합니다:

    1. 모든 GitLab 웹 노드가 GitLab 15.1.6을 실행하고 있는지 확인합니다.

    2. 클라우드 네이티브 GitLab Helm 차트를 사용하여 Kubernetes에서 GitLab을 실행하는 경우, 모든
      웹서비스 파드가 GitLab 15.1.Z를 실행하고 있는지 확인합니다:

      kubectl get pods -l app=webservice -o custom-columns=webservice-image:{.spec.containers[0].image},workhorse-image:{.spec.containers[1].image}

    3. ActiveSupport::Digest를 SHA256을 사용하도록 전환하려면 active_support_hash_digest_sha256 피처 플래그를 활성화합니다:

      1. 레일 콘솔 시작

      2. 피처 플래그 활성화:

        Feature.enable(:active_support_hash_digest_sha256)
    4. 그 후에만 GitLab의 최신 버전으로 업그레이드를 진행합니다.

  • ciConfig GraphQL 필드에 대한 인증되지 않은 요청은 더 이상 지원되지 않습니다.
    GitLab 15.1로 업그레이드하기 전에 요청에 액세스 토큰을 추가해야 합니다.
    토큰을 생성하는 사용자는 프로젝트에서 파이프라인을 생성할 수 있는 권한을 가져야 합니다.

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed

15.0.0

  • Elasticsearch 6.8 더 이상 지원되지 않습니다. GitLab 15.0으로 업그레이드하기 전에, Elasticsearch를 7.x 버전으로 업데이트하세요.

  • 외부 PostgreSQL로 GitLab을 실행하는 경우, 특히 AWS RDS를 사용하는 경우, GitLab 14.8 또는 이후 버전으로 업그레이드하기 전에 PostgreSQL을 최소 12.7 또는 13.3의 패치 레벨로 업그레이드 해야 합니다.

    14.8에서 GitLab Enterprise Edition과 15.0에서 GitLab Community Edition을 위해 Loose Foreign Keys라는 GitLab 기능이 활성화되었습니다.

    활성화된 후, 데이터베이스 엔진 버그로 인해 세그멘테이션 오류(segmentation fault)가 발생하여 계획에 없던 PostgreSQL 재시작이 보고되었습니다.

    자세한 내용은 문제 364763를 참조하세요.

  • 암호화된 S3 버킷의 스토리지 특정 구성 사용은 background_upload의 지원을 제거한 후 더 이상 지원되지 않습니다.
  • 인증서 기반 Kubernetes 통합(사용 중지됨)은 기본적으로 비활성화되어 있지만, GitLab 16.0까지 certificate_based_clusters 기능 플래그를 통해 다시 활성화할 수 있습니다.
  • GitLab Helm Chart 프로젝트를 사용자 지정 serviceAccount와 함께 사용할 때, serviceAccount 및 secret 리소스에 대해 get 및 list 권한이 있어야 합니다.
  • FF_GITLAB_REGISTRY_HELPER_IMAGE 기능 플래그가 제거되었으며, 헬퍼 이미지는 항상 GitLab 레지스트리에서 가져옵니다.

Linux 패키지 설치

  • 전역 서버 후크를 구성하기 위한 custom_hooks_dir 설정이 이제 Gitaly에서 구성됩니다. GitLab Shell의 이전 구현은 GitLab 15.0에서 제거되었습니다. 이 변경으로 인해 전역 서버 후크는 후크 유형의 이름을 딴 하위 디렉터리에만 저장됩니다. 전역 서버 후크는 더 이상 사용자 지정 후크 디렉터리의 루트에 있는 단일 후크 파일이 될 수 없습니다. 예를 들어, <custom_hooks_dir>/<hook_name> 대신 <custom_hooks_dir>/<hook_name>.d/*를 사용해야 합니다.
    • Omnibus GitLab의 경우 gitlab.rb에서 gitaly['custom_hooks_dir']를 사용하세요. 이는 gitlab_shell['custom_hooks_dir']를 대체합니다.

  • PostgreSQL 13.6이 새로운 설치의 기본 버전으로 제공되며, 업그레이드에는 12.10이 제공됩니다. 필요한 경우 업그레이드 문서를 참조하여 PostgreSQL 13.6으로 수동으로 업그레이드할 수 있습니다:

    sudo gitlab-ctl pg-upgrade -V 13

    PostgreSQL 12가 제거될 때까지 호환성 또는 테스트 환경 이유로 PostgreSQL 버전을 고정할 수 있습니다.

    장애 내성과 Geo 설치는 추가 단계 및 계획이 필요합니다.

    기본 구조 변경으로 인해, 데이터베이스 마이그레이션을 실행하기 전에 업그레이드할 때 실행 중인 PostgreSQL 프로세스를 반드시 재시작해야 합니다. 자동 재시작이 건너뛰어진 경우, 마이그레이션 실행 전에 다음 명령을 실행해야 합니다:

    # PostgreSQL 사용 시
sudo gitlab-ctl restart postgresql

# 데이터베이스 복제를 위해 Patroni를 사용하는 경우
sudo gitlab-ctl restart patroni

    PostgreSQL을 재시작하지 않으면 라이브러리 로드와 관련된 오류를 겪을 수 있습니다.

  • GitLab 15.0부터 postgresql 및 geo-postgresql 서비스는 PostgreSQL 버전이 변경될 때 자동으로 재시작됩니다. PostgreSQL 서비스를 재시작하면 데이터베이스의 일시적인 사용 불가능으로 인해 다운타임이 발생합니다. 이 재시작은 데이터베이스 서비스의 적절한 작동을 위해 필수적이지만, PostgreSQL이 재시작되는 시점에 대한 제어를 더 원할 수 있습니다. 이를 위해 gitlab-ctl reconfigure의 일부로 자동 재시작을 건너뛰고 서비스를 수동으로 재시작할 수 있습니다.

    GitLab 15.0 업그레이드의 자동 재시작을 건너뛰려면 업그레이드 이전에 다음 단계를 수행하세요:

    1. /etc/gitlab/gitlab.rb를 편집하고 다음 줄을 추가하세요:

      # PostgreSQL/Patroni의 경우
postgresql['auto_restart_on_version_change'] = false

# Geo PostgreSQL의 경우
geo_postgresql['auto_restart_on_version_change'] = false

    2. GitLab 재구성:

      sudo gitlab-ctl reconfigure

    참고: 기본 버전이 변경될 때는 PostgreSQL을 재시작해야 하며, 이를 통해 다운타임을 초래할 수 있는 필요한 라이브러리 로드와 관련된 오류를 피할 수 있습니다. 따라서 위 방법을 사용하여 자동 재시작을 건너뛰는 경우, GitLab 15.0으로 업그레이드하기 전에 서비스를 수동으로 재시작해야 합니다.

  • GitLab 15.0부터 NGINX에서는 AES256-GCM-SHA384 SSL 암호가 기본적으로 허용되지 않습니다. 이 암호가 필요한 경우(예: AWS의 Classic Load Balancer를 사용하는 경우), 아래 단계를 따라 암호를 허용 목록에 추가할 수 있습니다:

    1. /etc/gitlab/gitlab.rb를 편집하고 다음 줄을 추가하세요:

      nginx['ssl_ciphers'] = "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:AES256-GCM-SHA384"

    2. GitLab 재구성:

      sudo gitlab-ctl reconfigure

  • Gitaly의 내부 소켓 경로에 대한 지원이 제거되었습니다.

    GitLab 14.10에서는 Gitaly가 올바르게 작동하는 데 필요한 모든 런타임 데이터를 보유하는 새 디렉터리를 도입했습니다. 이 새로운 디렉터리는 이전 내부 소켓 디렉터리를 대체하였으며, 그 결과 gitaly['internal_socket_dir']의 사용이 사용 중지되었습니다.

    이전의 gitaly['internal_socket_dir'] 구성은 이 릴리스에서 제거되었습니다.

  • 객체 스토리지에 대한 백그라운드 업로드 설정이 제거되었습니다. 객체 스토리지는 이제 직접 업로드를 선호합니다.

    /etc/gitlab/gitlab.rb에서 더 이상 지원되지 않는 키는 다음과 같습니다:

    • gitlab_rails['artifacts_object_store_direct_upload']
    • gitlab_rails['artifacts_object_store_background_upload']
    • gitlab_rails['external_diffs_object_store_direct_upload']
    • gitlab_rails['external_diffs_object_store_background_upload']
    • gitlab_rails['lfs_object_store_direct_upload']
    • gitlab_rails['lfs_object_store_background_upload']
    • gitlab_rails['uploads_object_store_direct_upload']
    • gitlab_rails['uploads_object_store_background_upload']
    • gitlab_rails['packages_object_store_direct_upload']
    • gitlab_rails['packages_object_store_background_upload']
    • gitlab_rails['dependency_proxy_object_store_direct_upload']
    • gitlab_rails['dependency_proxy_object_store_background_upload']

자체 컴파일 설치

  • GitLab에 여러 데이터베이스에 대한 지원이 추가되었습니다. 자체 컴파일(소스) 설치의 경우, config/database.yml에는 데이터베이스 구성에 데이터베이스 이름이 포함되어야 합니다. main: database가 가장 먼저 와야 합니다. 잘못되거나 더 이상 사용되지 않는 구문이 사용될 경우, 애플리케이션 시작 시 오류가 발생합니다:

    ERROR: This installation of GitLab uses unsupported 'config/database.yml'.
The main: database needs to be defined as a first configuration item instead of primary. (RuntimeError)

    이전에 config/database.yml 파일은 다음과 같았습니다:

    production:
  adapter: postgresql
  encoding: unicode
  database: gitlabhq_production
  ...

    GitLab 15.0부터는 main 데이터베이스를 가장 먼저 정의해야 합니다:

    production:
  main:
    adapter: postgresql
    encoding: unicode
    database: gitlabhq_production
    ...

Geo 설치

Tier: Premium, Ultimate Offering: Self-managed