오퍼레이터 업그레이드

아래는 GitLab 오퍼레이터를 업그레이드하는 방법입니다.

단계 1: 최신 사용 가능한 차트 버전으로 업그레이드

오퍼레이터를 업그레이드하기 전에 현재 GitLab 인스턴스가 최신 사용 가능한 차트 버전으로 업그레이드되었는지 확인하려면 GitLab 업그레이드 가이드를 따르세요. 이러한 버전은 릴리스 페이지에서 버전 매핑 제목 아래에 설명되어 있습니다.

예를 들어, 현재 오퍼레이터 버전이 릴리스 0.4.0인 경우, 사용 가능한 차트 업그레이드를 다음과 같은 순서대로 수행하세요: 5.5.3 -> 5.6.3 -> 5.7.0.

단계 2: 원하는 오퍼레이터 버전 확인

GitLab 오퍼레이터의 사용 가능한 버전 전체 목록은 릴리스 페이지를 확인하세요.

예를 들어, 현재 오퍼레이터 버전이 릴리스 0.4.0인 경우, 릴리스 0.4.1로 업그레이드할 수 있습니다.

단계 3: 원하는 버전 설치

다음 단계는 kubectl을 사용하여 원하는 오퍼레이터 버전의 매니페스트를 적용하는 것입니다.

VERSION=X.Y.Z
kubectl apply -f \
  https://gitlab.com/api/v4/projects/18899486/packages/generic/gitlab-operator/${VERSION}/gitlab-operator-kubernetes-${VERSION}.yaml

이 명령은 새로운 배포 이미지를 사용하는 관련 매니페스트의 변경 사항을 적용합니다.

단계 4: 새 버전의 오퍼레이터가 리더가 되었는지 확인

오퍼레이터 배포는 이 변경으로 새로운 레플리카세트를 만들어 새로운 오퍼레이터 파드를 만들어야 합니다. 한편, 이전의 오퍼레이터 파드는 종료되어 리더 권한을 포기합니다. 이런 일이 일어나면 새로운 오퍼레이터 파드가 리더가 됩니다.

단계 5: GitLab 사용자 지정 리소스 (CR)에서 차트 버전 업데이트

대부분의 경우, 오퍼레이터 버전 간에 사용 가능한 차트 버전이 동일하지 않을 것입니다. 더 높은 버전의 오퍼레이터가 시작되면 기존의 GitLab 사용자 지정 리소스 (CR)를 조정하려고 할 것입니다. 다음과 같은 오류가 발생할 것입니다:

구성 오류 감지됨: 차트 버전 5.7.0은 지원되지 않음; 다음 중 하나를 사용하세요: 5.7.1, 5.6.4, 5.5.4

이를 해결하려면 해당 릴리스의 사용 가능한 차트 버전에서 유효한 버전을 식별하세요.

예를 들어, 오퍼레이터 0.4.0에서 0.4.1로 업그레이드하는 경우, 이 경우에 가장 가까운 사용 가능한 차트 버전인 5.7.0에 가장 가까운 GitLab CR을 사용하여 CR을 업데이트하세요. 이 경우에는 5.7.1입니다.

단계 6: 오퍼레이터가 기대한 대로 GitLab을 조정하는지 확인

새 오퍼레이터 파드에서 로그를 확인하세요. 정의한 차트 버전으로 업그레이드를 수행하는지 확인해야 합니다.

업그레이드가 성공적으로 이루어졌는지 확인하려면 GitLab CR의 상태를 가져오세요.

$ kubectl get gitlabs -n gitlab-system
이름     상태      버전
gitlab   Running   5.7.1

Running 상태는 오퍼레이터가 인스턴스의 변경 사항을 조정할 수 있었다는 것을 의미합니다. 버전은 오퍼레이터 업그레이드 후에 지정한 차트 버전과 일치해야 합니다.

어떠한 오류도 발견된다면, 먼저 저희의 문제 해결 문서를 참조하세요. 그래도 답이 제공되지 않는다면, 기존 문제를 확인하거나 저희의 이슈 트래커에서 새 이슈를 열어주세요.