GitLab Helm 차트 5.0

GitLab 14.0 릴리즈와 함께, 차트 버전을 5.0으로 업그레이드했습니다.

주요 변경 사항 요약

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

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

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

Error: UPGRADE FAILED: Job failed: 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 업그레이드 단계에 포함되어 있습니다.

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

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으로 업그레이드했습니다. 새 버전은 cert-manager.io/v1 API 버전을 Issuer에서 사용하므로 별도의 Cert-Manager를 사용하고 있었지만 이 차트에서 제공되는 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 패치와 함께 차트의 새 버전을 릴리즈할 것입니다.

차트 버전을 어떻게 구성하는지에 대한 자세한 내용은 릴리즈 문서에서 찾을 수 있습니다.

이 리포지터리의 이슈 및 Merge Request와 함께 changelog를 사용하면 업데이트를 더 쉽게 따를 수 있습니다.

Kubernetes 배포 지원

GitLab은 다음에서 테스트되었습니다.

다른 Kubernetes 배포도 작동해야 합니다. 특정하지 않은 GKE 배포 문제의 경우 문제를 제기하세요.

이 릴리즈는 Kubernetes 버전 v1.17.17-gke.4900와 v1.15.12-eks-31566f에 대한 자동화된 CI 테스트를 포함합니다.

기술 지원

이슈를 열기 전에 알려진 문제와 제한 사항을 검토하고, 유사한 문제가 이미 있는지 검색하세요.

커뮤니티의 보다 폭넓은 테스트를 크게 환영하며, 문제를 보고해 주시기를 장려합니다. 자세한 문제를 보고해 주시면 대응하도록 노력하겠습니다.

Merge 리퀘스트 형태로 기여된 개선 사항을 환영합니다. 기여자 설명서로 시작하세요.