1.11.2. 升级注意事项

maistra.io/ 标签或注解不应用于用户创建的自定义资源，因为它表示资源由 Red Hat OpenShift Service Mesh Operator 生成并应该由 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 分布式 tracing 平台)
logging.openshift.io/ (Red Hat Elasticsearch)

在升级前，检查用户为标签或注解创建自定义资源，以指示用户管理的 Operator。从您不想由 Operator 管理的自定义资源中删除标签或注解。

当升级到版本 2.0 时，Operator 只删除与 SMCP 相同的命名空间中使用这些标签的资源。

当升级到 2.1 版本时，Operator 会删除所有命名空间中使用这些标签的资源。

已知的可能影响升级的问题包括：

Red Hat OpenShift Service Mesh 不支持使用 EnvoyFilter 配置，除非明确记录。这是因为与底层 Envoy API 耦合紧密，这意味着无法维护向后兼容性。如果您使用 Envoy Filters，且 Istio 生成的配置已因为升级 ServiceMeshControlPlane 的最后一个版本而改变，则可能会中断您可能已经实现的任何 EnvoyFilter。
OSSM-1505 ServiceMeshExtension 无法用于 OpenShift Container Platform 版本 4.11。因为 ServiceMeshExtension 在 Red Hat OpenShift Service Mesh 2.2 中已弃用，所以这个已知问题不会被修复，且您必须将扩展迁移到 WasmPluging
OSSM-1396 如果一个网关资源包含 spec.externalIPs 设置，而不是在 ServiceMeshControlPlane 更新时重新创建，则该网关会被删除且永远不会重新创建。

OSSM-1052 在 Service Mesh control plane 中为 ingressgateway 配置 Service ExternalIP 时，不会创建该服务。SMCP 的 schema 缺少该服务的参数。
临时解决方案：禁用 SMCP spec 中的网关创建，手动管理网关部署（包括 Service、Role 和 RoleBinding）。