25.5. Cluster Operator 업그레이드

프로세스

1. 기존 Cluster Operator 리소스( /install/cluster-operator 디렉터리)에 대한 구성 변경 사항을 기록해 두십시오. Cluster Operator의 새 버전으로 변경 사항을 덮어씁니다.
2. Apache Kafka 버전 2.7에 사용할 수 있는 지원되는 구성 옵션을 반영하도록 사용자 지정 리소스를 업데이트합니다.

3. Cluster Operator를 업데이트합니다.

   1. Cluster Operator가 실행되는 네임스페이스에 따라 새 Cluster Operator 버전의 설치 파일을 수정합니다.

      Linux에서 다음을 사용하십시오.

      sed -i 's/namespace: .*/namespace: my-cluster-operator-namespace/' install/cluster-operator/*RoleBinding*.yaml

      Copy to Clipboard Toggle word wrap

      MacOS에서 다음을 사용하십시오.

      sed -i '' 's/namespace: .*/namespace: my-cluster-operator-namespace/' install/cluster-operator/*RoleBinding*.yaml

      Copy to Clipboard Toggle word wrap
   2. 기존 Cluster Operator 배포에서 하나 이상의 환경 변수를 수정한 경우 install/cluster-operator/060- Deployment -strimzi-cluster-operator.yaml 파일을 편집하여 해당 환경 변수를 사용합니다.

4. 업데이트된 구성이 있는 경우 나머지 설치 리소스와 함께 배포합니다.

   oc replace -f install/cluster-operator

   Copy to Clipboard Toggle word wrap

   롤링 업데이트가 완료될 때까지 기다립니다.

5. 새 Operator 버전이 업그레이드 중인 Kafka 버전을 더 이상 지원하지 않는 경우 Cluster Operator는 버전이 지원되지 않는 것으로 오류 메시지를 반환합니다. 그렇지 않으면 오류 메시지가 반환되지 않습니다.

   • 오류 메시지가 반환되면 새 Cluster Operator 버전에서 지원하는 Kafka 버전으로 업그레이드합니다.

     1. Kafka 사용자 정의 리소스를 편집합니다.
     2. spec.kafka.version 속성을 지원되는 Kafka 버전으로 변경합니다.
   • 오류 메시지가 반환 되지 않으면 다음 단계로 이동합니다. 나중에 Kafka 버전을 업그레이드합니다.

6. Kafka Pod의 이미지를 가져와 업그레이드가 성공적으로 수행되었는지 확인합니다.

   oc get pods my-cluster-kafka-0 -o jsonpath='{.spec.containers[0].image}'

   Copy to Clipboard Toggle word wrap

   image 태그는 Apache Kafka 버전의 새 Streams와 Kafka 버전이 차례로 표시됩니다.

   registry.redhat.io/amq-streams/strimzi-kafka-37-rhel9:2.7.0

   Copy to Clipboard Toggle word wrap

   Kafka 리소스 상태에서 업그레이드가 성공적으로 완료되었는지 확인할 수도 있습니다.

1. Apache Kafka 1.7의 Streams로 업그레이드합니다.
2. Apache Kafka 소프트웨어 다운로드 페이지에서 Streams for Apache Kafka 1.8와 함께 제공되는 Red Hat Streams for Apache Kafka API 변환 툴 을 다운로드합니다.

3. 사용자 정의 리소스 및 CRD를 v1beta2 로 변환합니다.

   자세한 내용은 Streams for Apache Kafka 1.7 업그레이드 설명서를 참조하십시오.

4. OperatorHub에서 Apache Kafka Operator용 Streams 1.7 버전을 삭제합니다.

5. 또한 존재하는 경우 Apache Kafka Operator용 Streams 2.7 버전을 삭제합니다.

   존재하지 않는 경우 다음 단계로 이동합니다.

   Apache Kafka Operator의 Streams에 대한 승인 전략이 자동으로 설정된 경우 Operator의 버전 2.7이 클러스터에 이미 존재할 수 있습니다. 사용자 정의 리소스 및 CRD를 릴리스 전에 v1beta2 API 버전으로 변환 하지 않은 경우 operator-managed 사용자 정의 리소스 및 CRD는 이전 API 버전을 사용합니다. 그 결과 2.7 Operator가 Pending 상태로 유지됩니다. 이 경우 버전 2.7 of the Streams for Apache Kafka Operator 및 버전 1.7을 삭제해야 합니다.

   두 Operator를 모두 삭제하면 새 Operator 버전이 설치될 때까지 조정이 일시 중지됩니다. 사용자 정의 리소스에 대한 변경 사항이 지연되지 않도록 다음 단계를 즉시 수행합니다.

6. OperatorHub에서 다음 중 하나를 수행합니다.

   • Apache Kafka Operator용 Streams 1.8로 업그레이드( ControlPlaneListener 기능 게이트는 기본적으로 비활성화되어 있음).
   • ControlPlaneListener 기능 게이트를 비활성화하여 Apache Kafka Operator용 Streams 2.0 또는 2.2( ControlPlaneListener 기능 게이트가 기본적으로 활성화되어 있음)로 업그레이드합니다.

7. Apache Kafka Operator의 Streams 2.7으로 즉시 업그레이드합니다.

   설치된 2.7 Operator는 클러스터를 모니터링하고 롤링 업데이트를 수행합니다. 이 프로세스 중에 클러스터 성능이 일시적으로 저하될 수 있습니다.