24.2. 降级 Kafka
Kafka 版本降级由 Cluster Operator 执行。
24.2.1. 降级的 Kafka 版本兼容性 复制链接链接已复制到粘贴板!
Kafka 降级取决于兼容的当前和目标 Kafka 版本,以及记录消息的状态。
如果以前的一个版本不支持在集群中已使用过的任何 inter.broker.protocol.version
设置,或者消息已被添加到使用较新的 log.message.format.version
的消息日志中时,则无法恢复到这个以前的 Kafka 版本。
inter.broker.protocol.version
决定用于代理存储的持久性元数据的 schema,如写入 __consumer_offsets
的消息的 schema。如果您降级到一个 Kafka 版本,它不知道之前在集群中使用的 inter.broker.protocol.version
,则代理将遇到它无法理解的数据。
如果目标降级版本 Kafka 具有:
-
与当前版本 相同的
log.message.format.version
,Cluster Operator 通过执行单个代理滚动重启来降级。 一个不同的
log.message.format.version
,只有运行的集群始终有log.message.format.version
设置为降级版本使用的版本时,才可以下载。这通常只有在更改log.message.format.version
前中止升级过程时才会出现这种情况。在这种情况下,降级需要:- 如果两个版本的 interbroker 协议不同,则代理的两个滚动重启
- 单个滚动重启(如果相同)
如果新版本已使用之前版本 不支持的 log.message.format.version
,则无法降级,包括在使用 log.message.format.version
的默认值时。例如,此资源可以降级到 Kafka 版本 3.5.0,因为 log.message.format.version
没有改变:
如果 log.message.format.version
设置为 "3.6"
或没有值,则无法降级,因此该参数会为 3.6 的 3.6.0 代理使用默认值。
从 Kafka 3.0.0,当 inter.broker.protocol.version
设置为 3.0
或更高版本时,log.message.format.version
选项会被忽略,且不需要设置。
24.2.2. 降级 Kafka 代理和客户端应用程序 复制链接链接已复制到粘贴板!
将 AMQ Streams Kafka 集群降级到 Kafka 的较低版本,如从 3.6.0 降级到 3.5.0。
先决条件
- Cluster Operator 已启动并在运行。
在降级 AMQ Streams Kafka 集群前,请检查以下
Kafka
资源:- 重要信息: Kafka 版本的兼容性。
-
Kafka.spec.kafka.config
不包含被降级的 Kafka 版本不支持的选项。 Kafka.spec.kafka.config
有一个log.message.format.version
和inter.broker.protocol.version
,被 Kafka 版本降级为。从 Kafka 3.0.0,当
inter.broker.protocol.version
设置为3.0
或更高版本时,log.message.format.version
选项会被忽略,且不需要设置。
流程
更新 Kafka 集群配置。
oc edit kafka KAFKA-CONFIGURATION-FILE
oc edit kafka KAFKA-CONFIGURATION-FILE
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 更改
Kafka.spec.kafka.version
以指定之前的版本。例如,如果从 Kafka 3.6.0 降级为 3.5.0 :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意log.message.format.version
和inter.broker.protocol.version
的值必须是字符串,以防止它们被解释为浮点号。如果 Kafka 版本的镜像与 Cluster Operator 的
STRIMZI_KAFKA_IMAGES
中定义的镜像不同,请更新Kafka.spec.kafka.image
。保存并退出编辑器,然后等待滚动更新完成。
检查日志中的更新,或通过监视 pod 状态转换:
oc logs -f CLUSTER-OPERATOR-POD-NAME | grep -E "Kafka version downgrade from [0-9.]+ to [0-9.]+, phase ([0-9]+) of \1 completed"
oc logs -f CLUSTER-OPERATOR-POD-NAME | grep -E "Kafka version downgrade from [0-9.]+ to [0-9.]+, phase ([0-9]+) of \1 completed"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc get pod -w
oc get pod -w
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 检查 Cluster Operator 日志中的
INFO
级别信息:Reconciliation #NUM(watch) Kafka(NAMESPACE/NAME): Kafka version downgrade from FROM-VERSION to TO-VERSION, phase 1 of 1 completed
Reconciliation #NUM(watch) Kafka(NAMESPACE/NAME): Kafka version downgrade from FROM-VERSION to TO-VERSION, phase 1 of 1 completed
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 降级所有客户端应用程序(使用者)以使用之前的客户端二进制文件版本。
Kafka 集群和客户端现在使用以前的 Kafka 版本。
如果您要恢复到 1.7 更早的 AMQ Streams 版本,它使用 ZooKeeper 来存储主题元数据,请从 Kafka 集群中删除内部主题存储主题。
oc run kafka-admin -ti --image=registry.redhat.io/amq-streams/kafka-36-rhel8:2.6.0 --rm=true --restart=Never -- ./bin/kafka-topics.sh --bootstrap-server localhost:9092 --topic __strimzi-topic-operator-kstreams-topic-store-changelog --delete && ./bin/kafka-topics.sh --bootstrap-server localhost:9092 --topic __strimzi_store_topic --delete
oc run kafka-admin -ti --image=registry.redhat.io/amq-streams/kafka-36-rhel8:2.6.0 --rm=true --restart=Never -- ./bin/kafka-topics.sh --bootstrap-server localhost:9092 --topic __strimzi-topic-operator-kstreams-topic-store-changelog --delete && ./bin/kafka-topics.sh --bootstrap-server localhost:9092 --topic __strimzi_store_topic --delete
Copy to Clipboard Copied! Toggle word wrap Toggle overflow