1.11.2. 업그레이드 고려 사항

maistra.io/ 레이블 또는 주석은 Red Hat OpenShift Service Mesh Operator에서 리소스를 생성하고 관리해야 함을 나타내기 때문에 사용자가 생성한 사용자 정의 리소스에서 사용해서는 안 됩니다.

주의

업그레이드 중에 Operator는 파일을 삭제하거나 교체하는 등 Operator가 리소스를 관리함을 나타내는 다음 라벨 또는 주석을 포함하는 리소스로 변경합니다.

다음 라벨 또는 주석이 포함된 사용자 생성 사용자 정의 리소스를 업그레이드하기 전에 다음을 수행합니다.

maistra.io/ 및 app.kubernetes.io/managed-by 레이블을 maistra-istio-operator (Red Hat OpenShift Service Mesh)로 설정합니다.
Kiali.io/ (Kiali)
Jaegertracing.io/ (Red Hat OpenShift Distributed Tracing Platform (Jaeger))
logging.openshift.io/ (Red Hat Elasticsearch)

업그레이드하기 전에 사용자가 생성한 사용자 정의 리소스에서 Operator가 관리되었음을 나타내는 레이블 또는 주석이 있는지 확인합니다. Operator에서 관리하지 않으려는 사용자 정의 리소스에서 레이블 또는 주석을 제거합니다.

버전 2.0으로 업그레이드할 때 Operator는 SMCP와 동일한 네임스페이스에 이러한 라벨이 있는 리소스만 삭제합니다.

버전 2.1으로 업그레이드할 때 Operator는 모든 네임스페이스에서 이러한 라벨을 사용하여 리소스를 삭제합니다.

업그레이드에 영향을 줄 수 있는 알려진 문제는 다음과 같습니다.

Operator를 업그레이드할 때 Jaeger 또는 Kiali의 사용자 정의 구성이 되돌릴 수 있습니다. Operator를 업그레이드하기 전에 Service Mesh 프로덕션 배포에서 Jaeger 또는 Kiali 오브젝트에 대한 사용자 정의 구성 설정을 기록하여 다시 생성할 수 있습니다.
Red Hat OpenShift Service Mesh는 명시적으로 문서화된 경우를 제외하고 EnvoyFilter 구성 사용을 지원하지 않습니다. 이는 기본 Envoy API와의 긴밀한 결합으로 인해 이전 버전과의 호환성을 유지할 수 없기 때문입니다. Envoy 필터를 사용하고 ServiceMeshControlPlane 업그레이드를 통해 도입된 Envoy의 마지막 버전으로 인해 Istio에서 생성한 구성이 변경되어 구현했을 수 있는 EnvoyFilter 가 손상될 수 있습니다.
OSSM-1505 ServiceMeshExtension 은 AWS 버전 4.11의 Red Hat OpenShift Service에서 작동하지 않습니다. ServiceMeshExtension 이 Red Hat OpenShift Service Mesh 2.2에서 더 이상 사용되지 않기 때문에 이 알려진 문제는 해결되지 않으며 WasmPluging으로 확장을 마이그레이션해야 합니다.
OSSM-1396 게이트웨이 리소스에 ServiceMeshControlPlane 이 업데이트될 때 다시 생성되는 대신 spec.externalIPs 설정이 포함된 경우 게이트웨이가 제거되고 다시 생성되지 않습니다.

OSSM-1052 Service Mesh Control Plane에서 ingressgateway에 대한 서비스 ExternalIP 를 구성할 때 서비스가 생성되지 않습니다. SMCP의 스키마에는 서비스의 매개변수가 누락되어 있습니다.
해결방법: SMCP 사양에서 게이트웨이 생성을 비활성화하고 게이트웨이 배포를 완전히 수동으로 관리합니다(서비스, 역할, RoleBinding 포함).