8.2. AMQ Streams 自定义资源升级
在将 AMQ Streams 升级到 1.8 之前,您必须确保自定义资源使用 API 版本 v1beta2。您可以在升级到 AMQ Streams 1.7 后随时执行此操作,但升级必须在升级到 AMQ Streams 1.8 或更新版本前完成。
在升级 Cluster Operator 前,必须将 自定义资源升级到 v1beta2,以便 Cluster Operator 可以了解资源。
将自定义资源升级到 v1beta2 准备 AMQ Streams 以迁移到 OpenShift CRD v1,OpenShift v 1.22 需要该 v1。
CLI 升级到自定义资源
AMQ Streams 提供了 API 转换工具 及其发行工件。
您可以从 AMQ Streams 下载网站下载 其 ZIP 或 TAR.GZ。要使用 工具,请将其解压缩并使用 bin 目录中的脚本。
在 CLI 中,您可以使用该工具以以下两种方式之一将自定义资源格式转换为 v1beta2 :
转换自定义资源后,您必须将 v1beta2 设置为 CRD 中的存储 API 版本:
手动升级到自定义资源
您可以手动更新每个自定义资源以使用 v1beta2,而不是使用 API 转换工具将自定义资源更新为 v1beta2 :
更新 Kafka 自定义资源,包括其他组件的配置:
更新应用到您的部署的其他资源:
- 第 8.2.12 节 “将 Kafka Connect 资源升级到 v1beta2”
- 第 8.2.13 节 “将 Kafka Connect S2I 资源升级到 v1beta2”
- 第 8.2.14 节 “将 Kafka MirrorMaker 资源升级到 v1beta2”
- 第 8.2.15 节 “将 Kafka MirrorMaker 2.0 资源升级到 v1beta2”
- 第 8.2.16 节 “将 Kafka Bridge 资源升级到 v1beta2”
- 第 8.2.17 节 “将 Kafka 用户资源升级到 v1beta2”
- 第 8.2.18 节 “将 Kafka 主题资源升级到 v1beta2”
- 第 8.2.19 节 “将 Kafka Connector 资源升级到 v1beta2”
- 第 8.2.20 节 “将 Kafka 重新平衡资源升级到 v1beta2”
手动步骤显示对每个自定义资源所做的更改。在进行这些更改后,您必须使用 API 转换工具来升级 CRD。
8.2.1. API 版本控制 复制链接链接已复制到粘贴板!
自定义资源通过 CRD 添加到 OpenShift 中的 API 进行编辑和控制。换言之,CRD 扩展 Kubernetes API 以允许创建自定义资源。CRD 本身是 OpenShift 中的资源。它们安装在 OpenShift 集群中,用于定义自定义资源的 API 版本。每个自定义资源 API 版本都可以为该版本定义自己的 schema。OpenShift 客户端(包括 AMQ Streams Operators)使用 URL 路径(API 路径)访问 KubernetesAPI 服务器提供的自定义资源,其中包括 API 版本。
v1beta2 的引入更新自定义资源的 schema。v1alpha1 和 v1beta1 版本已被删除。
v1alpha1 API 版本不再用于以下 AMQ Streams 自定义资源:
-
kafka -
KafkaConnect -
KafkaConnectS2I -
KafkaConnector -
KafkaMirrorMaker -
KafkaMirrorMaker2 -
KafkaTopic -
KafkaUser -
KafkaBridge -
KafkaRebalance
v1beta1 API 版本不再用于以下 AMQ Streams 自定义资源:
-
kafka -
KafkaConnect -
KafkaConnectS2I -
KafkaMirrorMaker -
KafkaTopic -
KafkaUser