25.5. 升级 Cluster Operator

流程

1. 记录对现有 Cluster Operator 资源所做的任何配置更改（在 /install/cluster-operator 目录中）。任何更改都会被 Cluster Operator 的新版本 覆盖。
2. 更新您的自定义资源，以反映 Apache Kafka 版本 2.7 的 Streams 支持的配置选项。

3. 更新 Cluster Operator。

   1. 根据 Cluster Operator 运行的命名空间，为新的 Cluster Operator 版本修改安装文件。

      在 Linux 中，使用：

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

      对于 MacOS，使用：

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

   2. 如果您在现有 Cluster Operator Deployment 中修改了一个或多个环境变量，请编辑 install/cluster-operator/060-Deployment-strimzi-cluster-operator.yaml 文件以使用这些环境变量。

4. 当您有更新的配置时，将其与其余安装资源一起部署：

   oc replace -f install/cluster-operator

   等待滚动更新完成。

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}'

   镜像标签显示 Apache Kafka 版本的新 Streams，后跟 Kafka 版本：

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

   您还可以从 Kafka 资源的状态检查升级是否已成功完成。

1. 升级到 Apache Kafka 1.7 的流。
2. 从 Streams for Apache Kafka 软件下载页面，从 Streams for Apache Kafka 1.8 下载 Red Hat Streams for Apache Kafka API Conversion Tool。

3. 将自定义资源和 CRD 转换为 v1beta2。

   如需更多信息，请参阅 Apache Kafka 1.7 升级文档的流。

4. 在 OperatorHub 中，删除 Apache Kafka Operator Streams 的 Streams 版本 1.7。

5. 如果存在，删除 Apache Kafka Operator 的 Streams 版本 2.7。

   如果不存在，请转到下一步。

   如果 Apache Kafka Operator 的 Streams 的批准策略被设置为 Automatic，则集群中可能已存在 Operator 版本 2.7。如果您在发行版本 前没有 将自定义资源和 CRD 转换为 v1beta2 API 版本，Operator 管理的自定义资源和 CRD 将使用旧的 API 版本。因此，2.7 Operator 处于 Pending 状态。在这种情况下，您需要删除 Apache Kafka Operator 的 Streams 版本 2.7 以及版本 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 开始监控集群并执行滚动更新。您可能会注意到在此过程中，集群性能可能会临时降低。