GitLab 15 변경 사항

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

이 페이지에는 GitLab 15의 소규모 및 패치 버전에 대한 업그레이드 정보가 포함되어 있습니다. 다음을 위해이 지침을 검토해야합니다.

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

GitLab Helm 차트 업그레이드에 대한 자세한 정보는 6.0 릴리스 노트를 참조하십시오.

15.11.1

  • 많은 프로젝트 가져오기 및 그룹 가져오기가 이제 관리자 역할을 필요로 하며, 개발자 역할만 필요로 하는 것이 아닙니다. 자세한 내용은 사용하는 가져오기 도구의 문서를 참조하십시오.

15.11.0

  • 패치 릴리스 15.11.3 또는 그 이후로 업그레이드하십시오. 이렇게 함으로써 이슈 408304가 발생하지 않습니다. 15.5.0 이전 버전에서 업그레이드 할 때 문제가 발생합니다.

  • 일반적으로, PgBouncer가있는 환경의 백업은 GITLAB_BACKUP_로 접두사가 지정된 변수를 설정하여 PgBouncer를 우회해야합니다. 그러나 이슈로 인해 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

Linux 패키지 설치

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

  • Patroni를 사용하여 고가용성으로 데이터베이스 실행.
  • 데이터베이스 노드가 GitLab Geo 구성의 일부.
  • PostgreSQL의 자동 업그레이드를 명시 적으로 거부.
  • /etc/gitlab/gitlab.rb에 postgresql['version'] = 12가 있습니다.

고가용성 및 Geo 설치는 PostgreSQL 13로 매뉴얼 업그레이드를 지원하며, 자세한 내용은 HA/Geo 클러스터에 패키지로 배포 된 PostgreSQL를 참조하십시오.

Geo 설치

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

pg_upgrade는 번들 PostregSQL 데이터베이스를 버전 13으로 업그레이드하지 못합니다.

영향받는 소규모 릴리스 영향 받는 패치 릴리스 수정된 내용
15.2 - 15.10 모든 없음
15.11 15.11.0 - 15.11.11 15.11.12 및 이후

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

15.11.x

  • 이슈 411604로 인해 새 LDAP 사용자가 처음으로 로그인하면 LDAP 사용자 이름 속성 대신 이메일 주소를 기반으로 사용자 이름이 할당될 수 있습니다. 매뉴얼 해결책은 gitlab_rails['omniauth_auto_link_ldap_user'] = true를 설정하거나 버그가 수정 된 GitLab 16.1 또는 이후 버전으로 업그레이드하는 것입니다.

15.10.5

  • Elastic Indexer Cron Workers와 관련된 버그는 Sidekiq을 포화 상태로 만들 수 있습니다.
    • 이 문제가 발생하면 MR(Merge Request) Merge, 파이프 라인, Slack 알림 등의 이벤트가 생성되지 않거나 오랜 시간이 걸릴 수 있습니다.
    • 이 문제는 Sidekiq이 포화 상태가 될 때까지 최대 1 주일이 걸릴 수 있으므로 즉시 나타나지 않을 수도 있습니다.
    • Elasticsearch가 활성화되지 않아도이 문제가 발생할수도 있습니다.
    • 이 문제를 해결하려면 15.11로 업그레이드하거나 문제에 대한 해결책을 사용하십시오.
  • 많은 프로젝트 가져오기 및 그룹 가져오기가 이제 관리자 역할을 필요로 하며, 개발자 역할만 필요로 하는 것이 아닙니다. 자세한 내용은 사용하는 가져오기 도구의 문서를 참조하십시오.

15.10.0

  • Elastic Indexer Cron Workers와 관련된 버그는 Sidekiq을 포화 상태로 만들 수 있습니다.
    • 이 문제가 발생하면 MR(Merge Request) Merge, 파이프 라인, Slack 알림 등의 이벤트가 생성되지 않거나 오랜 시간이 걸릴 수 있습니다.
    • 이 문제는 Sidekiq이 포화 상태가 될 때까지 최대 1 주일이 걸릴 수 있으므로 즉시 나타나지 않을 수도 있습니다.
    • Elasticsearch가 활성화되지 않아도이 문제가 발생할수도 있습니다.
    • 이 문제를 해결하려면 15.11로 업그레이드하거나 문제에 대한 해결책을 사용하십시오. –zero-downtime reindexing과 관련된 버그는 재색인 시 Couldn't load task status 오류가 발생할 수 있습니다. Elasticsearch 호스트에서 sliceId must be greater than 0 but was [-1] 오류도 발생할 수 있습니다. 해결책으로 scratch에서 재색인 또는 GitLab 16.3으로 업그레이드를 고려하십시오.
  • Omnibus GitLab 16.0에서 Gitaly 구성 변경이 상당히 큽니다. Omnibus GitLab 16.0으로 이행하는 동안 역 호환성이 유지되는 동안 Omnibus GitLab 15.10으로 이전 시작할 수 있습니다. 이 변경에 대한 자세한 내용 및 지원을 알아보십시오.

  • 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. 데이터베이스 콘솔에서 다음 SQL 문을 실행하십시오 (sudo gitlab-psql은 Linux 패키지 설치에 사용됨): 

      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버전으로 업그레이드하지 못하는 문제가 있습니다. 자세한 내용 및 해결 방법은 여기를 참조하세요.
  • 보조 사이트에서 LFS 객체를 복제할 때, 보조 사이트가 완전히 동기화되었더라도 주 사이트에서 다운로드됩니다. 자세한 내용과 해결 방법은 gitlab_16_changes.md를 참조하세요.

15.9.0

  • Elastic Indexer Cron Workers 버그로 인해 Sidekiq에서 포화 상태가 발생할 수 있습니다.
    • 이 문제가 발생하면, Merge Request Merge, 파이프라인, Slack 알림 및 다른 이벤트가 생성되지 않거나 오랜 시간이 걸릴 수 있습니다.
    • 이 문제는 즉시 나타나지 않을 수 있으며, Sidekiq가 포화 상태가 되기까지 최대 1주일이 걸릴 수 있습니다.
    • Elasticsearch는 이 문제가 발생할 수 있도록 활성화되지 않아도 됩니다.
    • 이 문제를 해결하려면, 15.11로 업그레이드하거나 해당 문제에 대한 해결책을 사용하세요.
  • BackfillTraversalIdsToBlobsAndWikiBlobs 고급 검색 마이그레이션 버그로 인해 Elasticsearch 클러스터가 포화될 수 있습니다.
    • 이 문제가 발생하면, 검색이 느려지고 Elasticsearch 클러스터 업데이트가 오랜 시간이 걸릴 수 있습니다.
    • 이 문제를 해결하려면, 마이그레이션 배치 크기를 줄이세요 또는 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 Partitioning 작업의 일환으로 ci_builds_needs에 새로운 Foreign Key가 추가되었습니다. 대용량 CI 테이블을 가진 GitLab 인스턴스에서 이 제약 조건을 추가하는 데 시간이 오래 걸릴 수 있습니다.

  • Praefect의 메타데이터 확인자의 유효하지 않은 메타데이터 삭제 동작가 기본적으로 활성화되었습니다.

    메타데이터 확인자는 Praefect 데이터베이스의 복제본 레코드를 처리하고 복제본이 실제로 Gitaly 노드에 있는지 확인합니다. 복제본이 없는 경우 해당 메타데이터 레코드가 삭제됩니다. 이를 통해 Praefect는 복제본이 괜찮다고 표시되지만 실제로 디스크에 존재하지 않는 상황을 해결할 수 있습니다. 메타데이터 레코드가 삭제된 후, Praefect의 조정자는 복제 작업을 다시 예약합니다.

    과거의 상태 관리 로직 문제로 인해 데이터베이스에 유효하지 않은 메타데이터 레코드가 있을 수 있습니다. 예를 들어, 레파지토리의 불완전한 삭제 또는 부분적인 이름 바꾸기 등으로 인해 발생할 수 있습니다. 확인자에 의해 영향을 받은 불필요한 레파지토리의 유효하지 않은 복제본 레코드를 삭제합니다. 이러한 레파지토리는 메트릭 및 praefect dataloss 하위 명령어에서 이유로 인해 사용할 수 없는 레파지토리로 표시될 수 있습니다. 이러한 레파지토리를 만나면, 남은 레파지토리 레코드를 제거하기 위해 praefect remove-repository를 사용하세요.

    GitLab 15.0 이상에서 이전에 잘못된 메타데이터 레코드가 있는 레파지토리를 확인자가 출력한 로그 레코드로 찾을 수 있습니다. 리포지터리 확인 및 예제 로그 항목을 보려면 더 읽어보세요.

  • Omnibus GitLab 16.0에서 Praefect 구성 변경이 크게 바뀌었습니다. Omnibus GitLab 15.9에서 이전 구조로 마이그레이션을 시작할 수 있으며, Omnibus GitLab 16.0 이전의 호환성은 유지됩니다. 이 변경에 대해 자세히 알아보세요.

직접 컴파일된 인스톨

  • 직접 컴파일된 (소스) 인스톨의 경우, gitlab-sshd가 추가되면 Kerberos 헤더가 GitLab Shell을 빌드하기 위해 필요합니다. 

    sudo apt install libkrb5-dev

Geo프로 인스톨

Tier: Premium, Ultimate Offering: Self-Managed
  • pg_upgrade가 번들로 제공되는 PostregSQL 데이터베이스를 13버전으로 업그레이드하지 못하는 문제가 있습니다. 자세한 내용 및 해결 방법은 여기를 참조하세요.
  • 보조 사이트에서 LFS 객체를 복제할 때, 보조 사이트가 완전히 동기화되었더라도 주 사이트에서 다운로드됩니다. 자세한 내용과 해결 방법은 gitlab_16_changes.md를 참조하세요.

15.8.2

Geo프로 인스톨

Tier: Premium, Ultimate Offering: Self-Managed
  • 소수의 Geo프로 인스톨에서 프로젝트 및 위키의 복제와 검증이 따라잡지 못하는 문제가 발견되었습니다. 귀하의 인스톨이 영향을 받을 수 있으며, 일부 프로젝트 및/또는 위키가 계속해서 “대기 중” 상태로 표시된다면 데이터 손실이 발생할 수 있습니다. 이 문제는 버전 15.6.x, 15.7.x 및 15.8.0 - 15.8.2에서 영향을 받을 수 있습니다.
    • 영향을 받는 버전: 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프로 인스톨에서 프로젝트 및 위키의 복제와 검증이 따라잡지 못하는 문제가 발견되었습니다. 귀하의 인스톨이 영향을 받을 수 있으며, 일부 프로젝트 및/또는 위키가 계속해서 “대기 중” 상태로 표시된다면 데이터 손실이 발생할 수 있습니다. 이 문제는 버전 15.6.x, 15.7.x 및 15.8.0 - 15.8.2에서 영향을 받을 수 있습니다.
    • 영향을 받는 버전: 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

15.7.5

Geo 설치

Tier: Premium, Ultimate Offering: Self-Managed

15.7.4

Geo 설치

Tier: Premium, Ultimate Offering: Self-Managed

15.7.3

Geo 설치

Tier: Premium, Ultimate Offering: Self-Managed
  • 우리는 일부 Geo 설치에서 프로젝트 및 위키의 복제 및 확인이 실시간으로 이뤄지지 않는 문제를 발견했습니다. 귀하의 설치가 영향을 받을 수 있습니다. “Queued” 상태에 지속적으로 표시되는 프로젝트 및/또는 위키가 있는 경우입니다. 이는 장애 조치 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: 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 버전에 영향을 미칩니다. 컨테이너 리포지터리를 사용 중이라면, 데이터 손실을 피하고 이 문제를 수정한 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.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 버전에 영향을 미칩니다. 컨테이너 리포지터리를 사용 중이라면, 데이터 손실을 피하고 이 문제를 수정한 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.7.0

  • 이 버전에서는 issues.work_item_type_id 열의 NOT NULL DB 제약 조건을 검증합니다. 이 버전으로 업그레이드하려면 issues 테이블에서 NULL work_item_type_id로 된 레코드가 없어야 합니다.
  • 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으로 변경되었습니다. 이제 이는 문서와 제품 기본값 모두에서 일관됩니다.

    예를들어, 이전에는:

    • Linux 패키지 설치 기본값 (sidekiq['max_concurrency']): 50
    • 자체 컴파일된 설치 기본값: 50
    • Helm 차트 기본값 (gitlab.sidekiq.concurrency): 25

    참조 아키텍처는 여전히 해당 구성에 특별히 설정된 기본값 10을 사용합니다.

    max_concurrency를 구성한 사이트는 이 변경에 영향받지 않습니다. Sidekiq 동시성 설정에 대해 자세히 알아보세요.

  • GitLab Runner 15.7.0은 CI/CD 작업에 영향을 주는 중요 변경 사항을 도입했습니다: job file 변수의 확장을 올바르게 처리. 이전에는 파일 유형 변수를 참조하는 작업 정의 변수가 해당 파일 변수의 값(콘텐츠)으로 확장되었습니다. 이 동작은 일반적인 쉘 변수 확장 규칙을 준수하지 않았습니다. 또한 파일 변수 및 해당 콘텐츠가 출력되면 비밀 또는 민감한 정보가 노출될 수 있습니다. 예를들어, echo 출력에 기록된 경우입니다. 자세한 내용은 GitLab 15.7에서 파일 유형 변수 확장 변경의 영향을 참조하세요.
  • GitLab 15.4에서 도입된 버그로 인해 Gitaly Cluster의 한 개 이상의 Git 리포지터리가 사용 불가 상태인 경우, 해당 Gitaly Cluster 내 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대한 리포지터리 확인 및 Geo 복제 및 확인가 중단됩니다. 이 버그는 GitLab 15.9.0에서 변경 사항을 되돌림으로써 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가” 리포지터리가 있는지 확인하세요. 자세한 내용은 버그 이슈를 참조하세요.
  • 보조 사이트에서 LFS 객체를 복제할 때 보조 사이트가 완전히 동기화되었더라도 주 서버에서 다운로드합니다. 자세한 내용 및 해결책은 변경 내용 및 해결책을 참조하세요.

Geo 설치

Tier: Premium, Ultimate Offering: Self-Managed
  • pg_upgrade가 번들 PostregSQL 데이터베이스를 버전 13으로 업그레이드하지 못하는 문제가 있습니다. 자세한 내용 및 해결 방법은 여기를 참조하십시오.
  • 컨테이너 레지스트리 푸시 이벤트가 /api/v4/container_registry_event/events 엔드포인트에 의해 거부되어 Geo 보조 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인지하지 못하고 결과적으로 업데이트를 복제하지 못하는 문제가 있습니다. 보조 사이트는 장애 조치(Failover) 후 오래된 컨테이너 이미지를 포함할 수 있습니다. 이는 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2 버전에 영향을 미칩니다. 컨테이너 리포지터리를 사용 중이라면 이 문제를 수정한 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.7

Geo 설치

Tier: Premium, Ultimate Offering: Self-Managed
  • 일부 Geo 설치에서 프로젝트 및 위키의 복제 및 검증이 따라가지 못하는 문제를 발견했습니다. 설치가 “Queued” 상태에 있는 프로젝트 및/또는 위키를 계속 확인하는 경우 설치에 영향을 줄 수 있습니다. 이는 장애 조치 후 데이터 손실로 이어질 수 있습니다.
    • 영향을 받는 버전: GitLab 버전 15.6.x, 15.7.x 및 15.8.0 - 15.8.2.
    • 수정 사항이 포함된 버전: GitLab 15.8.3 및 이후 버전.

15.6.6

Geo 설치

Tier: Premium, Ultimate Offering: Self-Managed
  • 컨테이너 레지스트리 푸시 이벤트가 /api/v4/container_registry_event/events 엔드포인트에 의해 거부되어 Geo 보조 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인지하지 못하고 결과적으로 업데이트를 복제하지 못하는 문제가 있습니다. 보조 사이트는 장애 조치(Failover) 후 오래된 컨테이너 이미지를 포함할 수 있습니다. 이는 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2 버전에 영향을 미칩니다. 컨테이너 리포지터리를 사용 중이라면 이 문제를 수정한 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 클러스터의 하나 이상의 Git 리포지터리가 사용 불가능한 경우, 리포지터리 확인 및 Geo 복제 및 확인이 영향을 받는 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에서 실행되지 않습니다. 이 버그는 GitLab 15.9.0에서 변경 되돌림하여 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능”한 리포지터리가 있는지 확인하십시오. 자세한 내용은 버그 이슈를 참조하십시오.

Geo 설치

Tier: Premium, Ultimate Offering: Self-Managed
  • 컨테이너 레지스트리 푸시 이벤트가 /api/v4/container_registry_event/events 엔드포인트에 의해 거부되어 Geo 보조 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인지하지 못하고 결과적으로 업데이트를 복제하지 못하는 문제가 있습니다. 보조 사이트는 장애 조치(Failover) 후 오래된 컨테이너 이미지를 포함할 수 있습니다. 이는 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2 버전에 영향을 미칩니다. 컨테이너 리포지터리를 사용 중이라면 이 문제를 수정한 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 클러스터의 하나 이상의 Git 리포지터리가 사용 불가능한 경우, 리포지터리 확인 및 Geo 복제 및 확인이 영향을 받는 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에서 실행되지 않습니다. 이 버그는 GitLab 15.9.0에서 변경 되돌림하여 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가능”한 리포지터리가 있는지 확인하십시오. 자세한 내용은 버그 이슈를 참조하십시오.

Geo 설치

Tier: Premium, Ultimate Offering: Self-Managed
  • 컨테이너 레지스트리 푸시 이벤트가 /api/v4/container_registry_event/events 엔드포인트에 의해 거부되어 Geo 보조 사이트가 컨테이너 레지스트리 이미지의 업데이트를 인지하지 못하고 결과적으로 업데이트를 복제하지 못하는 문제가 있습니다. 보조 사이트는 장애 조치(Failover) 후 오래된 컨테이너 이미지를 포함할 수 있습니다. 이는 15.6.0 - 15.6.6 및 15.7.0 - 15.7.2 버전에 영향을 미칩니다. 컨테이너 리포지터리를 사용 중이라면 이 문제를 수정한 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 클러스터의 하나 이상의 Git 리포지터리가 사용 불가능한 경우, 리포지터리 확인 및 Geo 복제 및 확인이 영향을 받는 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에서 실행되지 않습니다. 이 버그는 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

  • 하나의 공식 지원 PostgresSQL 버전을 사용해야 합니다. 일부 데이터베이스 마이그레이션은 이전 PostgresSQL 버전에서 안정성과 성능 문제를 일으킬 수 있습니다.
  • Gitaly에는 Git 2.37.0 이상이 필요합니다. 소스로 컴파일된 설치의 경우 Gitaly에서 제공하는 Git 버전을 사용해야 합니다.

  • 4개의 인덱스 동작을 수정하기 위한 데이터베이스 변경은 해당 인덱스가 없는 인스턴스에서 실패합니다: 

    원인:
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에서 수정되었습니다 and backported to 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 and 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.0에서 도입된 기본 Sidekiq 라우팅 규칙은 모든 작업을 default 대기열로 라우팅합니다. 대기열 선택기를 사용하는 인스턴스의 경우, 일부 Sidekiq 프로세스가 유휴 상태가 될 수 있어 성능 문제가 발생할 수 있습니다.
    • 기본 라우팅 규칙은 15.5.4에서 되돌려졌으므로, 해당 버전 이상으로 업그레이드하면 이전 동작이 되돌아갑니다.

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

      sidekiq['routing_rules'] = [['*', 'default']]
  • GitLab 15.4에서 도입된 버그로 인해, Gitaly Cluster의 하나 이상의 Git 리포지터리가 사용 불가능한 경우, 해당 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대한 리포지터리 확인 및 Geo 복제 및 확인가 중단됩니다. 버그는 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은 기본 Sidekiq 라우팅 규칙을 도입하여 모든 작업을 default 대기열로 라우팅합니다. 대기열 선택기(queue selectors)를 사용하는 인스턴스의 경우, 일부 Sidekiq 프로세스가 비활성화되어 성능 문제가 발생합니다(성능 문제).
    • 기본 라우팅 규칙이 15.5.4에서 되돌아가므로 해당 버전 이상으로 업그레이드하면 이전 동작으로 돌아갑니다.
    • 현재 default 대기열에만 듣는 GitLab 인스턴스의 경우(현재 권장되지는 않음), /etc/gitlab/gitlab.rb에 이 라우팅 규칙을 다시 추가해야 합니다. 
      sidekiq['routing_rules'] = [['*', 'default']]
  • GitLab 15.4에서 소개된 버그로인해 (GitLab 15.4에서 소개된 버그로), Gitaly 클러스터의 하나 이상의 Git 리포지터리가 사용 불가 상태인 경우, 해당 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대해 리포지터리 확인 및 Geo 복제 및 확인가 중지됩니다. 이 버그는 GitLab 15.9.0에서 변경사항을 되돌림으로 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가” 리포지터리를 확인하세요. 자세한 내용은 버그 이슈를 참조하세요.

15.5.1

  • GitLab 15.4.0은 기본 Sidekiq 라우팅 규칙을 도입하여 모든 작업을 default 대기열로 라우팅합니다. 대기열 선택기를 사용하는 인스턴스의 경우, 일부 Sidekiq 프로세스가 비활성화되어 성능 문제가 발생합니다.
    • 기본 라우팅 규칙이 15.5.4에서 되돌아가므로 해당 버전 이상으로 업그레이드하면 이전 동작으로 돌아갑니다.
    • 현재 default 대기열에만 듣는 GitLab 인스턴스의 경우(현재 권장되지는 않음), /etc/gitlab/gitlab.rb에 이 라우팅 규칙을 다시 추가해야 합니다. 
      sidekiq['routing_rules'] = [['*', 'default']]
  • GitLab 15.4에서 소개된 버그로인해 (GitLab 15.4에서 소개된 버그로), Gitaly 클러스터의 하나 이상의 Git 리포지터리가 사용 불가 상태인 경우, 해당 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대해 리포지터리 확인 및 Geo 복제 및 확인가 중지됩니다. 이 버그는 GitLab 15.9.0에서 변경사항을 되돌림으로 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가” 리포지터리를 확인하세요. 자세한 내용은 버그 이슈를 참조하세요.

15.5.0

  • GitLab 15.4.0은 기본 Sidekiq 라우팅 규칙을 도입하여 모든 작업을 default 대기열로 라우팅합니다. 대기열 선택기를 사용하는 인스턴스의 경우, 일부 Sidekiq 프로세스가 비활성화되어 성능 문제가 발생합니다.
    • 기본 라우팅 규칙이 15.5.4에서 되돌아가므로 해당 버전 이상으로 업그레이드하면 이전 동작으로 돌아갑니다.
    • 현재 default 대기열에만 듣는 GitLab 인스턴스의 경우(현재 권장되지는 않음), /etc/gitlab/gitlab.rb에 이 라우팅 규칙을 다시 추가해야 합니다. 
      sidekiq['routing_rules'] = [['*', 'default']]
  • GitLab 15.4에서 소개된 버그로인해 (GitLab 15.4에서 소개된 버그로), Gitaly 클러스터의 하나 이상의 Git 리포지터리가 사용 불가 상태인 경우, 해당 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대해 리포지터리 확인 및 Geo 복제 및 확인가 중지됩니다. 이 버그는 GitLab 15.9.0에서 변경사항을 되돌림으로 수정되었습니다. 이 버전으로 업그레이드하기 전에 “사용 불가” 리포지터리를 확인하세요. 자세한 내용은 버그 이슈를 참조하세요.

Geo 설치

Tier: Premium, Ultimate Offering: Self-Managed
  • pg_upgrade는 번들 PostregSQL 데이터베이스를 버전 13으로 업그레이드하지 못합니다. 세부 정보 및 해결책을 확인하세요.
  • 보조 사이트에서 LFS 객체를 복제하면 보조사이트가 완전히 동기화되었을 때에도 주 사이트에서 다운로드됩니다. 세부 정보 및 해결책을 확인하세요.

15.4.6

15.4.5

  • GitLab 15.4에서 발생한 버그로 인해, Gitaly 클러스터의 하나 이상의 Git 리포지터리가 사용할 수 없는 경우, 해당 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대한 리포지터리 확인 및 Geo 복제 및 확인이 실행되지 않습니다. 해당 버그는 GitLab 15.9.0에서의 변경으로 복구되었습니다. 이 버전으로 업그레이드하기 전에 “사용할 수 없는” 리포지터리가 있는지 확인하십시오. 자세한 내용은 버그 이슈를 참조하십시오.

15.4.4

  • GitLab 15.4에서 발생한 버그로 인해, Gitaly 클러스터의 하나 이상의 Git 리포지터리가 사용할 수 없는 경우, 해당 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대한 리포지터리 확인 및 Geo 복제 및 확인이 실행되지 않습니다. 해당 버그는 GitLab 15.9.0에서의 변경으로 복구되었습니다. 이 버전으로 업그레이드하기 전에 “사용할 수 없는” 리포지터리가 있는지 확인하십시오. 자세한 내용은 버그 이슈를 참조하십시오.

15.4.3

  • GitLab 15.4에서 발생한 버그로 인해, Gitaly 클러스터의 하나 이상의 Git 리포지터리가 사용할 수 없는 경우, 해당 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대한 리포지터리 확인 및 Geo 복제 및 확인이 실행되지 않습니다. 해당 버그는 GitLab 15.9.0에서의 변경으로 복구되었습니다. 이 버전으로 업그레이드하기 전에 “사용할 수 없는” 리포지터리가 있는지 확인하십시오. 자세한 내용은 버그 이슈를 참조하십시오.

15.4.2

  • GitLab 15.4에서 발생한 라이선스 캐싱 문제로 인해 새 라이선스를 추가하면 GitLab의 일부 Premium 기능이 올바르게 작동하지 않습니다. 이 문제에 대한 해결책:
    • 새 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 다시 시작합니다. 이렇게 하면 관련 라이선스 캐시가 지워지고 모든 Premium 기능이 올바르게 작동합니다.
    • 이 문제에 영향을 받는 버전에 대한 다음 업그레이드 경로:
      • 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 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대한 리포지터리 확인 및 Geo 복제 및 확인이 실행되지 않습니다. 해당 버그는 GitLab 15.9.0에서의 변경으로 복구되었습니다. 이 버전으로 업그레이드하기 전에 “사용할 수 없는” 리포지터리가 있는지 확인하십시오. 자세한 내용은 버그 이슈를 참조하십시오.

15.4.1

  • GitLab 15.4에서 발생한 라이선스 캐싱 문제로 인해 새 라이선스를 추가하면 GitLab의 일부 Premium 기능이 올바르게 작동하지 않습니다. 이 문제에 대한 해결책:
    • 새 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 다시 시작합니다. 이렇게 하면 관련 라이선스 캐시가 지워지고 모든 Premium 기능이 올바르게 작동합니다.
    • 이 문제에 영향을 받는 버전에 대한 다음 업그레이드 경로:
      • 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 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대한 리포지터리 확인 및 Geo 복제 및 확인이 실행되지 않습니다. 해당 버그는 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 변수를 구성해야 합니다. 그렇지 않으면 로그에 ntp: read udp ... i/o timeout 오류가 발생하고 gitlab-rake gitlab:gitaly:check의 출력에 오류가 표시됩니다. 그러나 Gitaly 호스트의 시간이 동기화되어 있는 경우 이러한 오류는 무시할 수 있습니다.
  • GitLab 15.4.0에서는 모든 작업을 default 큐로 라우팅하는 기본 Sidekiq 라우팅 규칙이 도입되었습니다. 큐 선택기를 사용하는 인스턴스의 경우,이로 인해 성능 문제가 발생할 수 있습니다.
    • 기본 라우팅 규칙은 15.4.5에서 되돌아갔으므로 해당 버전 또는 이후 버전으로 업그레이드하면 이전 동작으로 돌아갑니다.

    • 현재 default 큐만 수신하는 GitLab 인스턴스는 (현재 권장되지 않음) /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 값을 backfill하는 배치된 백그라운드 마이그레이션이 포함되어 있습니다. 이 마이그레이션은 큰 GitLab 인스턴스에서 여러 시간 또는 여러 일이 걸릴 수 있습니다. 15.7.0 이상으로 업그레이드하기 전에 마이그레이션이 정상적으로 완료되었는지 확인하십시오.
  • GitLab 15.4에서 발생한 버그로 인해, Gitaly 클러스터의 하나 이상의 Git 리포지터리가 사용할 수 없는 경우, 해당 Gitaly 클러스터의 모든 프로젝트 또는 프로젝트 위키 리포지터리에 대한 리포지터리 확인 및 Geo 복제 및 확인이 실행되지 않습니다. 해당 버그는 GitLab 15.9.0에서의 변경으로 복구되었습니다. 이 버전으로 업그레이드하기 전에 “사용할 수 없는” 리포지터리가 있는지 확인하십시오. 자세한 내용은 버그 이슈를 참조하십시오.

  • GitLab 15.4 및 이후 버전에서는 기본적으로 리디자인된 로그인 페이지가 활성화되었으며, 나중의 릴리스에서 개선 사항이 제공됩니다. 자세한 내용은 에픽 8557을 참조하십시오. 이 기능은 feature flag로 비활성화할 수 있습니다. Rails 콘솔을 시작하고 다음을 실행하십시오: 

    Feature.disable(:restyle_login_page)

Geo헤 설치

Tier: Premium, Ultimate Offering: Self-Managed
  • pg_upgrade가 번들된 PostregSQL 데이터베이스를 버전 13으로 업그레이드하지 못하는 문제가 있습니다. 자세한 내용과 해결 방법은 다음을 참조하세요(#pg_upgrade-fails-to-upgrade-the-bundled-postregsql-database-to-version-13).
  • 보조 사이트에서 LFS 객체를 복제할 때, 보조 사이트가 완전히 동기화되었을 때라도 주 사이트에서 다운로드됩니다. 자세한 내용과 해결 방법은 다음을 참조하세요여기.

15.3.4

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

  • 새 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 다시 시작합니다. 이렇게 하면 관련 라이선스 캐시가 지워지고 모든 Premium 기능이 올바르게 작동할 수 있습니다.
  • 이 문제에 영향을 받는 버전을 업그레이드합니다. 영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:
    • 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의 일부 Premium 기능이 올바르게 작동하지 않을 수 있습니다. 이 문제에 대한 해결 방법은 다음과 같습니다:

    • 새 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 다시 시작합니다. 이렇게 하면 관련 라이선스 캐시가 지워지고 모든 Premium 기능이 올바르게 작동할 수 있습니다.
    • 이 문제에 영향을 받는 버전을 업그레이드합니다. 영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:
      • 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의 일부 Premium 기능이 올바르게 작동하지 않을 수 있습니다. 이 문제에 대한 해결 방법은 다음과 같습니다:

  • 새 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 다시 시작합니다. 이렇게 하면 관련 라이선스 캐시가 지워지고 모든 Premium 기능이 올바르게 작동할 수 있습니다.
  • 이 문제에 영향을 받는 버전을 업그레이드합니다. 영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:
    • 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의 일부 Premium 기능이 올바르게 작동하지 않을 수 있습니다. 이 문제에 대한 해결 방법은 다음과 같습니다:

  • 새 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 다시 시작합니다. 이렇게 하면 관련 라이선스 캐시가 지워지고 모든 Premium 기능이 올바르게 작동할 수 있습니다.
  • 이 문제에 영향을 받는 버전을 업그레이드합니다. 영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:
    • 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 저장 경로를 사용하지 않습니다. 새 리포지터리의 서버 후크를 다른 위치에 복사해야 합니다. 이 정보를 사용하여 정확한 서버 후크를 설치할 수 있습니다.

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

    • 새 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 다시 시작합니다. 이렇게 하면 관련 라이선스 캐시가 지워지고 모든 Premium 기능이 올바르게 작동할 수 있습니다.
    • 이 문제에 영향을 받는 버전을 업그레이드합니다. 영향을 받는 버전에 대한 업그레이드 경로는 다음과 같습니다:
      • 15.2.5 –> 15.3.5
      • 15.3.0 - 15.3.4 –> 15.3.5
      • 15.4.1 –> 15.4.3

Geo헤 설치

Tier: Premium, Ultimate Offering: Self-Managed
  • pg_upgrade가 번들된 PostregSQL 데이터베이스를 버전 13으로 업그레이드하지 못하는 문제가 있습니다. 자세한 내용과 해결 방법은 다음을 참조하세요(#pg_upgrade-fails-to-upgrade-the-bundled-postregsql-database-to-version-13).
  • LFS 전송은 세션 중에 보조 사이트로부터 주 사이트로 리디렉션될 수 있습니다. 자세한 내용과 해결 방법은 다음을 참조하세요(#lfs-transfers-redirect-to-primary-from-secondary-site-mid-session).

LFS 전송은 세션 중에 보조 사이트로부터 주 사이트로 리디렉션될 수 있습니다

영향 받는 마이너 릴리스 영향 받는 패치 릴리스 수정 버전
15.1 모든 없음
15.2 모든 없음
15.3 15.3.0 - 15.3.2 15.3.3 및 이후

LFS 전송은 세션 중에 보조 사이트로부터 주 사이트로 리디렉션될 수 있습니다. 이 문제는 GitLab 15.1.0에서 15.3.2에서 Geo 프록시 기능이 활성화된 경우에 pull 및 clone 요청이 실패하는 것을 야기합니다. Geo 프록시는 GitLab 15.1부터 기본적으로 활성화됩니다.

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

  • LFS가 활성화되어 있습니다.
  • LFS 객체가 Geo 사이트 간에 복제됩니다.
  • 보조 사이트를 통해 리포지터리가 풀되고 있습니다.
  • 보조 사이트에서 LFS 객체를 복제할 때, 보조 사이트가 완전히 동기화되었을 때라도 주 사이트로부터 다운로드됩니다. 자세한 내용과 해결 방법은 다음을 참조하세요여기.

보조 사이트에서의 잘못된 오브젝트 스토리지 LFS 파일 삭제

영향 받는 마이너 릴리스 영향 받는 패치 릴리스 수정 버전
15.0 모든 없음
15.1 모든 없음
15.2 모든 없음
15.3 15.3.0 - 15.3.2 15.3.3 및 이후

GitLab 15.0.0에서 15.3.2에서 보조 사이트에서 개체 스토리지 파일이 잘못 삭제될 수 있습니다. 이 문제는 다음과 같은 상황에서 발생할 수 있습니다:

  • GitLab 관리 개체 스토리지 복제가 비활성화되어 있고, 객체 스토리지가 활성화된 프로젝트를 가져올 때 LFS 객체가 생성됩니다.
  • GitLab 관리 복제를 사용하여 객체 스토리지 동기화가 활성화되었다가 비활성화됩니다.

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

15.2.5

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

  • 새 라이선스를 적용한 후 모든 Rails, Sidekiq 및 Gitaly 노드를 다시 시작합니다. 이렇게 하면 관련 라이선스 캐시가 지워지고 Premium 기능이 모두 올바르게 작동할 수 있습니다.
  • 이 문제에 영향을 받는 버전에 대해 사용 가능한 다음 업그레이드 경로로 업그레이드합니다:
    • 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.2 (이후 버전)로 업그레이드하기 전에 15.1로 업그레이드해야 합니다. Rails의 구성 변경으로 불일치하는 ETag 키 생성이 발생할 수 있기 때문입니다.
  • 이 릴리스에서 일부 Sidekiq 워커가 이름이 바뀌었습니다. 어떠한 중단도 방지하려면 GitLab 15.2.0 업그레이드를 시작하기 전에 대기 중인 작업을 마이그레이션하려면 Rake 작업을 실행하세요.

  • Gitaly는 이제 런타임 위치에서 이진 파일을 실행합니다. 기본적으로 Omnibus GitLab에서 이 경로는 /var/opt/gitlab/gitaly/run/입니다. 이 위치가 noexec로 마운트된 경우 Merge Request이 다음 오류를 생성합니다: 

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

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

    1. /etc/gitlab/gitlab.rb에 gitaly['runtime_dir'] = '<EXEC_PERM이 설정된_경로>'를 추가하고 noexec가 설정되지 않은 위치를 지정하세요.
    2. sudo gitlab-ctl reconfigure를 실행하세요.

Geo 설치

Tier: Premium, Ultimate Offering: Self-Managed
  • pg_upgrade는 번들 PostregSQL 데이터베이스를 버전 13으로 업그레이드하지 못합니다. 세부 정보 및 해결 방법은 여기를 참조하세요.
  • LFS 전송은 세컨더리 사이트로부터 주요 사이트로 중간 세션에서 리디렉션할 수 있습니다. 세부 정보 및 해결 방법은 여기를 참조하세요.
  • Geo 세컨더리 사이트에서 잘못된 객체 리포지터리 LFS 파일 삭제가 발생할 수 있습니다. 세부 정보와 해결 방법은 여기를 참조하세요.
  • 세컨더리 사이트에서 LFS 객체를 복제하면 세컨더리가 완전히 동기화되어 있더라도 주요 사이트에서 다운로드됩니다. 자세한 내용과 해결 방법은 여기를 참조하세요.

15.1.0

  • GitLab 15.1.0에서는 Rails ActiveSupport::Digest를 MD5 대신 SHA256을 사용하도록 전환합니다. 이것은 원본 스니펫 파일 다운로드와 같은 리소스에 대한 일관된 ETag 키 생성에 영향을 미칩니다. 업그레이드할 때 여러 웹 노드에서 일관된 ETag 키 생성을 보장하려면 모든 서버가 먼저 15.1.6으로 업그레이드되어야 합니다. 1. 모든 GitLab 웹 노드가 GitLab 15.1.6을 실행하도록합니다. 1. GitLab on Kubernetes를 실행하여 클라우드 네이티브 GitLab Helm 차트를 사용하는 경우 모든 webservice pod이 GitLab 15.1.Z를 실행하는지 확인하세요.

    1. active_support_hash_digest_sha256 피처 플래그를 활성화하여 ActiveSupport::Digest가 SHA256을 사용하도록 변경하세요.
      1. rails console를 시작하고 피처 플래그를 활성화하세요: 
         Feature.enable(:active_support_hash_digest_sha256)
    2. 그런 다음 GitLab을 최신 버전으로 업그레이드하세요.

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

Geo 설치

Tier: Premium, Ultimate OffeMORE사이트어: Self-Managed
  • 15.1에서 기본 설정된 Geo 프록시가 15.1에 서로 다른 URL에 대해 기본으로 사용되도록 설정되었습니다. 필요한 경우 Geo 프록시 사용 해제하세요. 다른 URL을 사용하여 SAML을 사용하는 경우 SAML 구성 및 Identity Provider 구성을 수정해야 합니다. 자세한 내용은 Geo with Single Sign-On (SSO) documentation을 참조하세요.
  • LFS 전송은 세컨더리 사이트로부터 주요 사이트로 중간 세션에서 리디렉션할 수 있습니다. 자세한 내용 및 해결 방법은 여기를 참조하세요.
  • Geo 세컨더리 사이트에서 잘못된 객체 리포지터리 LFS 파일 삭제가 발생할 수 있습니다. 세부 정보 및 해결 방법은 여기를 참조하세요.
  • 세컨더리 사이트에서 LFS 객체를 복제하면 세컨더리가 완전히 동기화되어 있더라도 주요 사이트에서 다운로드됩니다. 자세한 내용과 해결 방법은 gitlab_16_changes.md를 참조하세요.

15.0.0

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

  • 외부 PostgreSQL로 GitLab을 실행하는 경우 특히 AWS RDS의 경우 GitLab 14.8 이후로 업그레이드하기 전에 PostgreSQL을 12.7 이상 또는 13.3 최소 패치 수준까지 업그레이드하세요.

    GitLab Enterprise Edition에서 14.8 또는 GitLab Community Edition에서 15.0로 업그레이드한 후 GitLab 기능인 Loose Foreign Keys가 활성화되었습니다.

    활성화된 후 데이터베이스 엔진 버그로 인해 비예측적인 PostgreSQL 재시작이 발생하는 경우가 있었습니다.

    자세한 내용은 issue 364763을 참조하세요.

  • 리포지터리별 구성을 사용하는 암호화된 S3 버킷의 사용이 백그라운드 업로드 사용 제거 이후 더 이상 지원되지 않습니다.
  • 인증서 기반의 쿠버네티스 통합 (DEPRECATED)은 기본적으로 비활성화되어 있지만 GitLab 16.0 이전에 certificate_based_clusters 피처 플래그를 통해 다시 활성화할 수 있습니다.
  • GitLab Helm Chart 프로젝트에서 사용자 지정 serviceAccount로 실행하는 경우 serviceAccount 및 secret 리소스에 대한 get 및 list 권한이 있어야 합니다.
  • FF_GITLAB_REGISTRY_HELPER_IMAGE feature flag가 제거되고 헬퍼 이미지가 항상 GitLab 레지스트리에서 가져와집니다.

Linux 패키지 설치

  • 전역 서버 후크를 구성하는 custom_hooks_dir 설정은 이제 Gitaly에서 구성됩니다. 이전 구현(GitLab 15.0에서 제거됨)에서는 GitLab Shell에 있었습니다. 이 변경으로 인해 전역 서버 후크는 이제 후크 유형 이름으로 된 하위 디렉터리에만 저장됩니다. 전역 서버 후크는 더 이상 사용되지 않으며, 더 이상 사용되지 않습니다. 예를 들어 <custom_hooks_dir>/<hook_name>.d/* 대신에 <custom_hooks_dir>/<hook_name>.d/*를 사용해야 합니다.
    • 옴니버스 GitLab의 경우 gitlab_shell['custom_hooks_dir']를 대체하기 위해 gitlab.rb에서 gitaly['custom_hooks_dir']를 사용하십시오.

  • 새 설치에는 PostgreSQL 13.6이 기본 버전으로 제공되고 업그레이드에는 12.10이 제공됩니다. 매뉴얼으로 PostgreSQL 13.6으로 업그레이드하려면 업그레이드 문서를 따르십시오.: 

    sudo gitlab-ctl pg-upgrade -V 13

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

    Fault tolerant and Geo installations require additional steps and planning.

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

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

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

  • GitLab 15.0부터 postgresql 및 geo-postgresql 서비스는 PostgreSQL 버전 변경시 자동으로 다시 시작됩니다. PostgreSQL 서비스를 다시 시작하는 것은 데이터베이스가 일시적으로 사용할 수 없게되어 다운타임이 발생하므로 본래의 서비스 기능을 위해 필수적입니다. 이러한 재시작은 gitlab-ctl reconfigure의 일부로 필수적이지만 PostgreSQL을 매뉴얼으로 재시작하고 싶을 수 있습니다.

    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
    note
    데이터베이스 버전 변경 시 PostgreSQL을 반드시 다시 시작하여 필요한 라이브러리를 로드할 수 없는 오류와 같은 오류가 발생하지 않도록하는 것이 반드시입니다. 따라서 위의 방법으로 자동 재시작을 건너뛴 경우 반드시 GitLab 15.0으로 업그레이드하기 전에 서비스를 매뉴얼으로 다시 시작하는 것을 확실하게 해야 합니다.

  • GitLab 15.0부터 AES256-GCM-SHA384 SSL 암호는 기본적으로 NGINX에서 허용되지 않습니다. 이 암호가 필요한 경우(예: 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['runtime_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
  • Geo 보조 사이트에서 잘못된 객체 리포지터리 LFS 파일 삭제. 자세한 내용 및 해결 방법은 여기를 참조하십시오.