| 组件 | 开发版支持范围 |
|---|---|
| Java | 21 |
| Spring Boot | 3.5.x |
| Spring AI | 1.1.0–1.1.7,CI 覆盖边界 |
| MySQL | 8.0+;Compose 固定 8.4 LTS patch |
| Node.js / pnpm | Node 22 / pnpm 11.9 |
| Docker Compose | Docker 26+ / Compose v2 |
main 是开发版,不承诺与未发布提交二进制兼容。发布后使用语义化版本:补丁版本保持 API/Schema
兼容;次版本可增加可选字段和端点;主版本才允许有迁移指南的破坏性变更。
- 阅读目标标签的 release notes 和迁移说明。
- 备份 MySQL、ContentStore、
.env/secret store 和 GitHub App 配置。 - 在副本上运行
docker compose config、契约校验和恢复演练。 - 先升级应用镜像;Flyway 只向前执行。
- 验证健康、Ingestion、Trace Query、队列和评测 worker,再恢复流量。
保留上一版本镜像、文档和数据库备份。若新版本只包含向后兼容迁移,可回滚应用镜像;若 migration 改变数据语义,停止写入并从升级前备份恢复,不能手工删除 Flyway 记录。ContentStore 与数据库必须恢复到 同一时间点。
公共 API、Schema 和 SDK 弃用至少提前一个次版本标记,并给出替代项、迁移示例和计划删除版本。 安全原因需要紧急移除时,发布安全公告、缓解方式和显式兼容例外。指南中的破坏性变化必须保留上一发布版 文档链接。