오퍼레이터 업그레이드

아래는 GitLab Operator를 업그레이드하는 방법에 대한 안내입니다.

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

오퍼레이터를 업그레이드하기 전에 현재 GitLab 인스턴스가 최신 사용 가능한 차트 버전으로 업그레이드되었는지 확인하세요. 이를 위해 GitLab 업그레이드 가이드를 따르세요. 이러한 버전은 Version mapping 제목 아래의 릴리스 페이지에 나와 있습니다.

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

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

GitLab Operator의 전체 사용 가능한 버전 목록은 릴리스 페이지를 참조하세요.

예를 들어, 현재 오퍼레이터 버전이 릴리스 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: 새로운 버전의 오퍼레이터가 리더가 되는지 확인

오퍼레이터 배포는 이 변경으로 새로운 ReplicaSet을 생성해야 하며, 새로운 오퍼레이터 포드를 생성합니다. meanwhile, 이전 오퍼레이터 포드는 종료되어 리더 상태를 포기하게 됩니다. 이렇게 되면 새로운 오퍼레이터 포드가 리더가 됩니다.

단계 5: GitLab 커스텀 리소스(CR)에서 차트 버전 업데이트

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

Configuration error detected: chart version 5.7.0 not supported; please use one of the following: 5.7.1, 5.6.4, 5.5.4

이를 해결하기 위해 해당 릴리스의 사용 가능한 차트 버전 중 유효한 버전을 확인하세요.

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

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

새로운 오퍼레이터 포드의 로그를 지켜보세요. 정의한 차트 버전으로 업그레이드를 수행하는 것을 볼 수 있어야 합니다.

업그레이드가 성공했는지 확인하려면, GitLab CR의 상태를 가져오세요:

$ kubectl get gitlabs -n gitlab-system
NAME     STATUS    VERSION
gitlab   Running   5.7.1

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

오류가 발생하면, 먼저 우리의 문제 해결 문서를 참조하세요.

그곳에서 답변을 찾을 수 없다면, 기존 문제를 확인하거나 새로운 문제를 문제 추적기에 열어주세요.