GitLab Helm 차트 4.0

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

주요 변경 사항 요약

문제가 있는 Helm 2.15

Helm v2.15.x에는 심각한 버그가 있으며, 절대 사용해서는 안 됩니다.

Helm 2를 사용하는 경우, 2.14.3 또는 >= 2.16.1을 사용하세요.

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

차트의 4.0 버전으로 업그레이드하려면, 먼저 차트의 최신 3.3.x 버전으로 업그레이드해야 합니다. 최신 패치 정보는 버전 매핑 세부 정보를 확인하세요.

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

Error: UPGRADE FAILED: 작업 실패: BackoffLimitExceeded

그럼 이 상황인지 확인하려면, 이름에 gitlab-upgrade-check 텍스트가 포함된 에러가 발생하는 파드를 확인하세요.

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

GitLab Helm 차트를 X (GitLab X)에서 4.0.0 (GitLab 13.0.0)로 업그레이드하려고 합니다.
계속 진행하기 전에 먼저 최신 3.3.x 버전으로 업그레이드해야 합니다.
업그레이드 문서를 팔로우하여 https://docs.gitlab.com/charts/releases/3_0.html
을 확인하고 4.0.0으로 업그레이드하기 전에 GitLab Helm 차트 버전 3.3.x로 업그레이드하세요.

3.3.x에서의 업그레이드

4.0 릴리즈의 업그레이드 단계를 확인하세요.

주요 변경 사항

PostgreSQL

이 차트의 4.0.0 릴리즈에 포함된 주요 변경 사항으로, 번들로 제공되는 PostgreSQL 차트를 7.7.3에서 8.9.4로 업그레이드했습니다. 이로써 PostgreSQL 버전이 10.9에서 11.7로 업데이트되었습니다. 이것은 대체 제품이 아닙니다. 데이터베이스를 업그레이드하려면 매뉴얼 단계를 수행해야 합니다.

4.0 업그레이드 단계에는 업그레이드 중에 필요한 매뉴얼 단계가 포함되어 있습니다.

note
PostgreSQL 11은 GitLab 13.0(2020년 5월)에서 요구하는 최소 PostgreSQL 버전입니다. PostgreSQL 9.6 및 PostgreSQL 10은 GitLab 13.0 이후로 더 이상 지원되지 않습니다.

웹서비스 차트

유니콘 서브차트가 웹서비스로 이름이 변경되었습니다. 업그레이드 시, Helm은 모든 유니콘에 대한 쿠버네티스 리소스를 제거하고 이를 웹서비스 이름으로 새로 생성합니다. 차트는 이제 유니콘과 Puma 양쪽 웹 서버를 지원한다는 사실을 반영하기 위해 이름이 변경되었습니다. 더 자세한 내용은 변경 사항을 소개하는 MR(Merge Request)에서 찾을 수 있습니다.

note
새로운 파드가 준비될 때까지 GitLab에 업그레이드 중 요청할 수 없습니다.

Puma 웹서버

웹서비스 차트에서 사용되는 기본 웹서버가 Puma로 설정되었습니다. 이로써 몇 가지 성능 개선을 이끌어내고 의존성 프록시와 같은 기능에 대한 작업을 차단 해제합니다.

유니콘 웹서버는 현재도 지원되며, 다음과 같이 구성할 수 있습니다: 

gitlab:
  webservice:
    webServer: unicorn

더 자세한 내용은 웹서버 옵션을 참조하세요.

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

4.0으로 업그레이드하기 전에 먼저 차트를 3.3.x 릴리즈로 업그레이드해야 합니다. 3.0 업그레이드 문서를 참고하세요.

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

3.0으로 업그레이드하기 전에 먼저 차트를 2.6.x 릴리즈로, 그리고 3.3.x 릴리즈로 업그레이드해야 합니다. 2.0 업그레이드 문서를 참고하세요.

알려진 문제 및 제한 사항

아래는 알려진 문제 및 제한 사항입니다. 다만, 이 디렉터리이 모두가 아닐 수 있습니다.

Helm 차트 문제/제한사항:

현재 범위를 벗어나 있는 기능:

릴리즈 주기

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

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

이 리포지터리의 이슈와 MR(Merge Request) 뿐만 아니라, 변경 로그도 업데이트를 더 쉽게 따를 수 있도록 제공됩니다.

Kubernetes 배포 지원

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

그 외의 Kubernetes 배포도 작동할 수 있습니다. 특정 non-GKE 배포 문제의 경우, 이슈를 등록해주시기 바랍니다.

이 릴리스는 Kubernetes 버전 v1.14.10-gke.17 및 v1.13.12-eks-879c36에 대해 자동화된 CI 테스팅이 이루어졌습니다.

기술 지원

이슈를 열기 전에, 알려진 문제 및 제한 사항을 먼저 확인하고, 검색하여 유사한 문제가 이미 존재하는지 확인해주시기 바랍니다.

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

기여 문서를 통해 제공되는 모든 개선 사항을 환영합니다. 당사의 기여 문서로 시작하세요.