23.4. 升级 Cluster Operator

1. 升级到 AMQ Streams 1.7。
2. 从 AMQ Streams 软件下载页下载 AMQ Streams 1.8 提供的 Red Hat AMQ Streams API Conversion Tool。

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

   如需更多信息，请参阅 AMQ Streams 1.7 升级文档。

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

5. 如果也存在，删除 AMQ Streams Operator 的版本 2.6。

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

   如果 AMQ Streams Operator 的批准策略被设置为 Automatic，则集群中可能已存在 operator 版本 2.6。如果您在发行版本 前没有 将自定义资源和 CRD 转换为 v1beta2 API 版本，Operator 管理的自定义资源和 CRD 将使用旧的 API 版本。因此，2.6 Operator 处于 Pending 状态。在这种情况下，您需要删除 AMQ Streams Operator 和版本 1.7 的 2.6 版本。

   如果同时删除这两个 Operator，协调将暂停，直到安装了新的 Operator 版本。立即遵循后续步骤，对自定义资源的任何更改都不会延迟。

6. 在 OperatorHub 中，执行以下操作之一：

   • 升级到 AMQ Streams Operator 的 1.8 版本（默认禁用 ControlPlaneListener 功能门）。
   • 在禁用了 ControlPlaneListener 功能门的情况下，升级到 AMQ Streams Operator 的 2.0 或 2.2 版本（其中 ControlPlaneListener 功能门被默认启用）。

7. 立即升级到 AMQ Streams Operator 版本 2.6。

   安装的 2.6 operator 会开始监控集群并执行滚动更新。您可能会注意到在此过程中，集群性能可能会临时降低。

流程

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

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 Deployment 中修改了一个或多个环境变量，请编辑 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

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

   registry.redhat.io/amq-streams/strimzi-kafka-36-rhel8:2.6.0

   Copy to Clipboard Toggle word wrap

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