从TBMQ CE升级至TBMQ PE（v2.2.0）
NOTE:
These steps are applicable for 2.2.0 TBMQ CE version. In order to upgrade to TBMQ PE 2.2.0 you need to upgrade to 2.2.0 TBMQ CE first. Notice the Bitnami Images information.
说明：TBMQ PE v2.2.0中的第三方组件更新
We’d like to inform you about several third-party component updates introduced in TBMQ Professional Edition (PE) v2.2.0 compared to the Community Edition (CE). 这些更改提升了性能与稳定性，并使TBMQ与官方支持的开源技术保持一致。
更新遵循此处所述的现代化规划： Bitnami Image Migration.
变更说明
| Component | TBMQ CE v2.2.0 | TBMQ PE v2.2.0 | 变更说明与原因 |
|---|---|---|---|
| PostgreSQL | postgres:16 |
postgres:17 |
升级至更新主版本，提升性能、可靠性与资源效率。现有数据卷保持完全兼容。 |
| Kafka | bitnamilegacy/kafka:3.7.0 |
apache/kafka:4.0.0 |
根据从Bitnami迁移至官方开源镜像的计划更新。引入新卷并映射至Apache Kafka镜像所需路径。 |
| Redis → Valkey | bitnamilegacy/redis:7.2.5 |
valkey/valkey:8.0 |
根据从Bitnami迁移至开源镜像的计划更新。Redis由Valkey（Redis7的社区驱动分支）替代。引入新卷 tbmq-valkey-data 并映射至Valkey镜像使用的数据目录。 |
重要说明
从TBMQ CE 2.2.0升级至TBMQ PE 2.2.0会引入多项组件变更，迁移前后需注意。
开始升级前，强烈建议对现有环境进行完整备份。
包括 PostgreSQL数据库（例如使用 pg_dump），以及计划迁移的 Kafka 和 Redis 数据卷。
备份可确保在升级过程中出现配置或兼容性问题时安全恢复环境。
PostgreSQL版本从 16升级至17，提升性能、可靠性与资源效率。
虽然现有数据卷保持兼容，但仍需执行正确的数据库版本升级（例如使用 pg_upgrade），以确保数据完整性与新版本的完全兼容。
Kafka和Redis已从Bitnami镜像迁移至官方开源镜像——分别为 Apache Kafka 和 Valkey。 该迁移是远离Bitnami镜像的长期现代化规划的一部分。 伴随此次变更，Kafka从3.7.0升级至4.0.0，提升性能、扩展性与消息处理效率。 新镜像使用不同的内部数据目录和卷映射，因此无法直接复用现有Bitnami卷。 您需要手动迁移Kafka和Redis数据，或从新的空卷开始。
⚠️ 注意：使用新卷将清除Kafka和Redis中当前存储的所有数据，包括客户端会话状态、未送达与保留消息及其他持久化代理数据。
标准升级脚本仅负责更新PostgreSQL数据库模式，不包含Kafka或Valkey的数据迁移逻辑。
NOTE: You may contact us if you require additional guidance for the migration. While we do not provide direct or fully managed migration assistance, we can offer general recommendations and insights to help facilitate a smoother upgrade experience.
请通过页面顶部的选择卡片进入相应文档以继续升级步骤。
下一步
-
快速入门指南 - 本指南提供 TBMQ 的快速概览。
-
安全指南 - 学习如何为 MQTT 客户端启用认证与授权。
-
配置指南 - 了解 TBMQ 配置文件和参数。
-
MQTT 客户端类型指南 - 了解 TBMQ 客户端类型。
-
与 ThingsBoard 集成 - 了解如何将 TBMQ 与 ThingsBoard 集成。