Appearance
版本政策
本页结论:所有 Broker 镜像与客户端依赖一律 tag + digest 双锁定,禁止浮动标签;升级走独立流程并刷新快照。
锁定规则
- 不使用
latest、edge、nightly等浮动标签。 .env.versions同时记录镜像 Tag 与多架构 index Digest:
dotenv
RABBITMQ_IMAGE=rabbitmq:4.1.4-management@sha256:<digest>- Compose 文件只写
image: ${RABBITMQ_IMAGE},由 lab.js 以--env-file .env.versions注入。 - Digest 必须用
docker buildx imagetools inspect <image>:<tag>实测获取并记录,禁止凭记忆抄写。 - Java 客户端版本锁在
demos/pom.xml的dependencyManagement中。
当前锁定版本
| 组件 | 版本 | 核对日期 | 说明 |
|---|---|---|---|
| RabbitMQ 镜像 | rabbitmq:4.1.4-management | 2026-08-19 | 官方仍支持的 4.1.x 线,management 插件提供 UI 与 HTTP API(checkedAt: 2026-08-19,来源见官方资料基线) |
| amqp-client | 5.34.0 | 2026-08-19 | RabbitMQ 官方 Java 客户端 |
| Kafka 镜像 | apache/kafka:4.3.1 | 2026-08-19 | 官方 KRaft 镜像,单进程 broker+controller(checkedAt: 2026-08-19,来源见官方资料基线) |
| kafka-clients | 4.3.1 | 2026-08-19 | 与 Broker 同版本线 |
| RocketMQ 镜像 | apache/rocketmq:5.5.0 | 2026-08-19 | 官方镜像,namesrv/broker/proxy 三服务编排(checkedAt: 2026-08-19,来源见官方资料基线) |
| rocketmq-client-java | 5.2.0 | 2026-08-19 | 5.x gRPC 客户端,经 proxy 8081 接入 |
| Pulsar 镜像 | apachepulsar/pulsar:4.2.4 | 2026-08-19 | standalone 单容器(broker + BookKeeper + 元数据内嵌)(checkedAt: 2026-08-19,来源见官方资料基线) |
| pulsar-client | 4.2.2 | 2026-08-19 | 与 Broker 同 4.2.x 版本线 |
| JDK(字节码目标) | 21 | 2026-08-19 | maven.compiler.release=21;本地可用更高版本 JDK 编译 |
升级流程
- 在独立分支更新
.env.versions的 tag 与 digest(实测获取)。 - 更新客户端依赖版本并确认编译与单测通过。
npm run collect-outputs -- <product>刷新全部快照。- 审查快照语义变化(断言数值、日志形态),再修改文档结论。
- “当前最新”“默认值”等时效性表述必须更新核对日期。
审查节奏
- 每季度检查官方支持版本;发生安全问题时立即检查。
- 过时内容优先标记
VersionBadge/核对日期,而不是静默删除结论。