16.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.4。

   如果不存在，请进入下一步。

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

   如果删除这两个 Operator，则协调将暂停，直到安装了新的 Operator 版本。立即按照以下步骤操作，以便对自定义资源的任何更改都不会延迟。

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

   • 升级到 AMQ Streams Operator 的 1.8 版本（默认禁用 ControlPlaneListener 功能门）。
   • 升级至 AMQ Streams Operator 的 2.0 或 2.2 版本（其中禁用了 ControlPlaneListener 功能门），并禁用了 ControlPlaneListener 功能门。

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

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

流程

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

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

   镜像标签显示新的 Operator 版本。例如：

   registry.redhat.io/amq-streams/strimzi-kafka-34-rhel8:2.4.0

   Copy to Clipboard Toggle word wrap