GitLab Helm 차트 5.0

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

주요 변경 사항 요약

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

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

만약 최신 4.12.x 패치로 먼저 업그레이드하지 않으면, helm upgrade에서 다음과 같은 오류가 발생합니다. 

오류: 업그레이드 실패: 작업 실패: BackoffLimitExceeded

그런 다음 이름에 gitlab-upgrade-check 텍스트가 포함된 오류 상태의 pod를 찾아 이 상황인지 확인할 수 있습니다.

해당 pod의 로그를 확인하면 버전 업그레이드 오류 메시지가 표시됩니다. 

GitLab Helm 차트를 X(GitLab X)에서 5.0.0(GitLab 14.0.0)로 업그레이드하려는 것으로 보입니다.
진행하기 전에 먼저 최신 4.12.x 버전으로 업그레이드해야 합니다.
업그레이드에 대한 문서를 https://docs.gitlab.com/charts/releases/5_0.html에서 확인하고 5.0.0으로 업그레이드하기 전에 GitLab Helm 차트 버전 4.12.x로 업그레이드하세요.

4.12.x부터의 업그레이드

5.0 릴리스의 업그레이드 단계를 따르세요.

주요 변경 사항

PostgreSQL

이 차트의 5.0.0 릴리스의 일환으로, PostgreSQL 버전을 11.9에서 12.7로 업그레이드했습니다. 이는 즉시 대체할 수 있는 것이 아닙니다. 데이터베이스를 업그레이드하려면 수동 단계를 수행해야 합니다.

업그레이드 중 필요한 수동 단계는 5.0 업그레이드 단계에 포함되어 있습니다.

참고: PostgreSQL 12는 GitLab 14.0 (2021년 6월)에서 필수 최소 PostgreSQL 버전입니다. PostgreSQL 11은 GitLab 14.0 이후로 더 이상 지원되지 않습니다.

Unicorn 웹서버

차트의 버전 4.0.0에서 Unicorn을 웹서버로 사용하는 것이 중단되었으며 기본적으로 더 이상 사용되지 않고, 대신에 Puma가 기본 웹서버로 사용되었습니다. 5.0.0에서는 Unicorn 지원이 제거되었습니다.

최신 버전으로 업그레이드하기 전에 값을 통해 Unicorn 구성을 제거해야 합니다.

Puma 구성 옵션은 Webservice 세부 정보를 참조하세요.

Helm 2

Helm 2는 2020년 11월에 마지막 릴리스를 하고 지원이 중단되었습니다. GitLab Helm 차트의 4.12 릴리스가 Tiller Helm 2.x를 지원하는 마지막 릴리스입니다.

Helm 2에서 3으로의 마이그레이션 문서를 참조하세요.

Cert-Manager

이 차트의 5.0.0 릴리스의 일환으로, Cert-Manager 차트를 0.10.1에서 1.2.0로 업그레이드했습니다. 새 버전은 Issuer를 위해 cert-manager.io/v1 API 버전을 사용하므로, 이 차트에서 제공하는 Issuer를 사용하고 있었더라도 cert-manager.io/v1 버전을 지원하는 버전의 Cert-Manager로 업그레이드해야 합니다.

Cert-Manager와 이 차트에서 제공하는 Issuer를 사용 중이라면, 업그레이드는 자동으로 이루어집니다. 업그레이드 과정에서 Cert-Manager Deployment 오브젝트(이전에 이름에 certmanager가 포함된)는 삭제되고, 새로운 오브젝트가 cert-manager 이름으로 생성됩니다.

업그레이드 중 Cert-Manager에 문제가 발생하는 경우 Cert-Manager 업그레이드 문제 해결 섹션을 확인하세요.

4.x 이전 버전에서의 업그레이드 경로

4.0로 업그레이드하기 전에 먼저 차트의 4.12.x 릴리스로 업그레이드해야 합니다. 4.0 업그레이드 문서를 참조하세요.

알려진 문제점 및 제한 사항

아래는 알려진 문제점 및 제한 사항 목록이지만, 모두를 포괄하는 것은 아닐 수 있습니다.

현재 범위를 벗어난 기능:

릴리스 주기

새로운 GitLab 패치마다 차트의 새 버전을 릴리스할 것입니다.

차트의 버전을 어떻게 지정하는지에 대한 자세한 정보는 릴리스 문서에서 확인할 수 있습니다.

이 저장소의 이슈 및 병합 요청과 함께 changelog를 사용하여 업데이트를 더 쉽게 파악할 수 있습니다.

Kubernetes 배포 지원

GitLab은 다음과 같이 테스트되었습니다:

다른 Kubernetes 배포도 작동해야 합니다. 특정 비-GKE 배포 이슈가 발생할 경우, 이슈를 제기해주십시오.

본 릴리스는 Kubernetes 버전 v1.17.17-gke.4900 및 v1.15.12-eks-31566f에 대한 자동화된 CI 테스트가 포함되어 있습니다.

기술 지원

이슈를 오픈하기 전에 알려진 이슈 및 제한 사항을 확인하고, 유사한 이슈가 이미 존재하는지 검색해주십시오.

우리는 커뮤니티의 넓은 테스팅을 크게 감사히 여기며, 문제를 해결할 수 있도록 자세한 이슈를 보고 장려합니다.

우리는 병합 요청 형식으로 기여된 어떤 개선 사항도 환영합니다. 기여자 문서를 통해 시작하세요.