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: Job 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 에서
GitLab Helm 차트 버전 3.3.x로 업그레이드한 후 4.0.0으로 업그레이드하십시오.

3.3.x에서의 업그레이드

4.0 릴리스의 경우, 해당 차트의 일환으로 번들로 포함된 PostgreSQL 차트가 7.7.3에서 8.9.4로 업그레이드되었습니다. 이로써 PostgreSQL 버전이 10.9에서 11.7로 업데이트되었습니다. 이것은 드롭 인 대체가 아닙니다. 데이터베이스를 업그레이드하기 위해 수동 단계가 수행되어야 합니다.

4.0 업그레이드 단계에는 업그레이드 중에 필요한 수동 단계가 포함됩니다.

참고: PostgreSQL 11은 GitLab 13.0 (2020년 5월)에서 필요한 최소 PostgreSQL 버전입니다. PostgreSQL 9.6 및 PostgreSQL 10은 GitLab 13.0 이후로 더 이상 지원되지 않습니다.

Webservice 차트

Unicorn 서브차트가 Webservice로 이름이 변경되었습니다. 업그레이드시 Helm은 Unicorn의 모든 Kubernetes 리소스를 제거하고 Webservice 이름 아래에서 새 리소스를 생성합니다. 차트의 이름이 변경된 것은 Unicorn과 Puma가 이 차트에서 지원되는 웹 서버임을 반영하기 위함입니다. 자세한 내용은 변경 사항을 소개하는 Merge Request에서 확인할 수 있습니다.

참고: 새로운 포드가 준비될 때까지 차트가 업그레이드되는 동안 GitLab에 액세스할 수 없습니다.

Puma 웹 서버

Webservice 차트에서 기본 웹 서버가 Puma로 설정되었습니다. 이로써 성능 향상과 같은 기능이 의존성 프록시와 같은 기능에 대한 작업이 차단되지 않습니다.

Unicorn 웹 서버는 현재도 지원되며 다음과 같이 구성할 수 있습니다. 

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 패치마다 차트의 새 버전을 릴리스할 것입니다.

차트를 버전별로 관리하는 방법에 대한 자세한 내용은 릴리스 문서에서 찾을 수 있습니다.

이 저장소의 이슈 및 병합 요청과 함께 변경 로그를 사용하면 업데이트를 쉽게 따를 수 있습니다.

Kubernetes 배포 지원

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

다른 Kubernetes 배포도 작동해야 합니다. 특정 non-GKE 배포 문제가 발생한 경우에는 문제를 제기해주세요.

이 릴리스에서는 Kubernetes 버전 v1.14.10-gke.17 및 v1.13.12-eks-879c36에 대한 자동화된 CI 테스트가 있습니다.

기술 지원

문제를 열기 전에 알려진 문제 및 제한 사항을 확인하고, 이미 유사한 문제가 있는지 검색해보세요.

우리는 커뮤니티의 넓은 테스트를 강력히 지지하며, 문제를 보고해주시면 감사하겠습니다. 이를 통해 문제를 해결할 수 있습니다.

병합 요청 형태로 기여된 어떠한 향상들도 환영합니다. 기여자 문서를 통해 시작해보세요.