#升级

本文档提供了 Alauda Cache Service for Redis OSS 的升级技术指导，包括版本兼容性、升级路径及操作步骤。

#版本兼容性原则

Alauda Cache Service for Redis OSS 遵循语义化版本控制，兼容性保证如下：

• 补丁版本（x.y.z）在同一小版本内完全向前和向后兼容
• 小版本（x.y.z）在同一大版本内保持 API 和功能兼容
• 大版本（x.y.z）可能引入破坏性变更，需遵循特定升级操作步骤

#升级前提条件

在启动任何升级操作前，请确认以下条件：

1. 版本兼容性：当前版本必须在支持的升级路径范围内
2. 组件健康状态：所有 Redis 实例均处于 Ready 状态
3. 资源可用性：集群具备充足的 CPU、内存和存储资源
4. 备份：确保关键数据和配置已完成最近的备份

#支持的升级路径

下表列出了经过测试的版本组合及其依赖关系：

Alauda Cache Service for Redis OSS 版本	Redis Server 版本	ACP 版本	Kubernetes 版本
v4.1.0	5.0.14, 6.0.20, 7.2.10	v4.1.0	1.29, 1.30, 1.31, 1.32
v4.0.x	5.0.14, 6.0.20, 7.2.x	v4.0.x	1.28, 1.29, 1.30, 1.31

#升级策略

#小版本升级

• 方式：任意小版本均可升级至更新的小版本（例如 4.0.x → 4.2.x）
• 优势：降低风险，确保版本间平滑过渡

#补丁版本升级

• 兼容性：同一小版本系列内完全兼容
• 示例：从 4.1.0 升级至 4.1.1，用于修复漏洞和安全补丁

#大版本升级

• 要求：必须先升级至目标大版本的最早可用小版本
• 操作步骤：请参照特定大版本升级文档执行详细步骤
• 注意事项：可能需要配置变更及功能兼容性评估

#升级执行

Alauda Cache Service for Redis OSS 支持两种升级执行模式：

• 自动：系统自动检测并应用可用的新版本
• 手动：需管理员明确批准后启动升级操作步骤

#操作注意事项

• 停机时间：规划升级期间的最小服务中断
• 回滚：确保回滚操作步骤已理解并经过测试
• 监控：升级过程中密切监控系统指标和日志
• 验证：升级后对所有关键功能进行验证