GitLab 클라우드 네이티브 차트 7.0

GitLab 16.0 릴리스와 함께, 차트 버전을 7.0으로 업데이트했습니다.

주요 변경 사항 요약

6.x에서의 업그레이드 경로

차트의 7.0 버전으로 업그레이드하려면, 먼저 최신 6.11.x 릴리스로 업그레이드해야 합니다. 최신 패치에 대한 버전 매핑 세부 정보를 확인하세요.

GitLab은 이제 기본적으로 두 개의 데이터베이스 연결을 사용합니다. 업그레이드 전에 PostgreSQL max_connections가 충분히 높은지 확인할 수 있습니다 (사용 가능한 최대 연결의 50% 이상 사용). Toolbox 컨테이너를 사용하여 다음 Rake 작업을 실행하여 이를 확인할 수 있습니다. 

gitlab-rake gitlab:db:decomposition:connection_status

작업에서 max_connections가 충분히 높음을 나타내면, 업그레이드를 진행할 수 있습니다. 그렇지 않거나 단일 연결로 유지하려는 경우, 업그레이드 전에 ci.enabled 키를 false로 설정할 수 있습니다.

6.11.x에서의 업그레이드

7.0 릴리스의 업그레이드 단계를 따라 주세요.

주요 변경 사항

PostgreSQL

이 차트의 7.0.0 릴리스의 일환으로, 기본 PostgreSQL 버전이 12.7에서 14.8로 업그레이드되었습니다. 이는 PostgreSQL 차트 버전이 8.9.4에서 12.5.2로 업그레이드됨을 의미합니다.

이는 단순한 대체가 아닙니다. 데이터베이스를 업그레이드하려면 매뉴얼 단계를 수행해야 합니다. 이러한 단계는 업그레이드 단계에서 문서화되어 있습니다.

note
PostgreSQL 13은 GitLab 16.0에서 필수 요구 사항입니다. PostgreSQL 12는 GitLab 16.0 및 이후에서 더 이상 지원되지 않습니다.

번들된 certmanager

번들된 certmanager 차트는 1.5.4에서 1.11.1로 업그레이드되었습니다. 클러스터 및 도구에 따라 이를 업그레이드하기 전에 매뉴얼으로 개입해야 할 수 있습니다.

certmanager 1.11을 지원하는 클러스터 버전인지 확인하세요. 해당 릴리스는 Kubernetes 1.21부터 1.26 및 OpenShift 4.8부터 4.13을 지원합니다. 자세한 내용은 certmanager 지원되는 릴리스에서 확인하세요.

기본 certmanager 구성은 이제 acme.cert-manager.io/http01-edit-in-place 주석을 사용합니다. 결과적으로, certmanager는 새로운 Ingress를 생성하는 대신 기존 Ingress를 사용하여 ACME 챌린지를 완료합니다. 이 변경으로 인해 ingressClassName을 설정해야 하는 Ingress 컨트롤러와의 호환성이 보장됩니다.

OpenShift 사용자는 certmanager 1.10+를 배포하려면 보안 컨텍스트 제한을 수정해야 할 수 있습니다. 자세한 내용은 certmanager 1.10 릴리스 노트에서 확인하세요.

GitLab 차트가 관리하지 않는 certmanager 사용자 리소스를 배포하거나 cert-manager와 관련된 추가 스크립트나 도구를 사용하는 경우, 업그레이드하기 전에 certmanager 1.6에서 1.11의 잠재적으로 파괴적인 변경 사항을 숙지하세요.

In-place Ingress 수정 비활성화

가끔씩 기존 Ingress를 재사용하여 유효성을 검사하는 로직이 적합하지 않을 수 있습니다. 예를 들어, Ingress에 IP 허용 디렉터리이나 기타 제한 사항이 있는 경우에는 공개 인터넷에서 접근할 수 없습니다.

7.7.0부터 global.issuer.useNewIngressForCerts 값을 true(기본값: false)로 설정하여 Ingress를 동적으로 생성하여 ACME 챌린지를 검증할 수 있습니다.

useNewIngressForCerts를 true로 설정하려면 Ingress 컨트롤러에서 ingressClassName 필드를 지원해야 합니다. 이 필드는 Kubernetes 1.18부터 사용 가능하지만 모든 컨트롤러에서 지원되지는 않습니다. 예를 들어, GKE Ingress를 사용하는 경우에는 아직 사용할 수 없습니다.

기존 클러스터에서 GitLab 차트 7.0-7.6를 실행 중인 경우, 업그레이드 중에 이 필드를 활성화해야 하는 경우 업그레이드 지침을 따르세요.

Redis

포함된 bitnami/Redis 서브 차트가 이전에 설치된 11.3.4에서 버전 16.13.2로 업데이트되었습니다. 이로써 Redis 버전이 6.0.9에서 6.2.7로 업그레이드되었습니다.

번들된 Redis를 사용하는 경우, 업그레이드하기 전에 매뉴얼 단계가 필요합니다. 번들된 Redis 서브 차트 업그레이드를 확인하세요.