오퍼레이터 업그레이드

아래는 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 Custom Resource (CR)에서 차트 버전 업데이트

대부분의 경우, 오퍼레이터 버전 간에 사용 가능한 차트 버전이 동일하지 않을 것입니다. 더 새로운 버전의 오퍼레이터가 시작되면 기존의 GitLab Custom Resource (CR)를 조정하려고 할 것입니다. 아마도 다음과 같은 오류가 표시될 것입니다:

구성 오류가 감지되었습니다: 차트 버전 5.7.0은 지원되지 않음; 다음 중 하나를 사용하십시오: 5.7.1, 5.6.4, 5.5.4

이에 대한 대안으로, 해당 릴리스의 사용 가능한 차트 버전 중에서 가장 가까운 유효한 버전을 식별하세요.

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

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

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

업그레이드가 성공적으로 수행되었는지 확인하기 위해 GitLab CR의 상태를 가져와 보세요:

$ kubectl get gitlabs -n gitlab-system
이름     상태       버전
gitlab   실행 중    5.7.1

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

만약 에러가 있으면, 먼저 문제 해결 문서를 참조하세요. 답변이 없는 경우, 기존 이슈를 확인하거나 새 이슈를 오픈하세요. 여기 이슈 트래커에서 확인할 수 있습니다.