Skip to content

Latest commit

 

History

History
35 lines (26 loc) · 1.5 KB

compatibility.md

File metadata and controls

35 lines (26 loc) · 1.5 KB

版本兼容、迁移与弃用

支持矩阵

组件 开发版支持范围
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 兼容;次版本可增加可选字段和端点;主版本才允许有迁移指南的破坏性变更。

升级

  1. 阅读目标标签的 release notes 和迁移说明。
  2. 备份 MySQL、ContentStore、.env/secret store 和 GitHub App 配置。
  3. 在副本上运行 docker compose config、契约校验和恢复演练。
  4. 先升级应用镜像;Flyway 只向前执行。
  5. 验证健康、Ingestion、Trace Query、队列和评测 worker,再恢复流量。

回滚

保留上一版本镜像、文档和数据库备份。若新版本只包含向后兼容迁移,可回滚应用镜像;若 migration 改变数据语义,停止写入并从升级前备份恢复,不能手工删除 Flyway 记录。ContentStore 与数据库必须恢复到 同一时间点。

弃用

公共 API、Schema 和 SDK 弃用至少提前一个次版本标记,并给出替代项、迁移示例和计划删除版本。 安全原因需要紧急移除时,发布安全公告、缓解方式和显式兼容例外。指南中的破坏性变化必须保留上一发布版 文档链接。