#升级

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. 备份：所有关键数据和配置都必须有最近的备份可用。

#支持的升级路径

下表概述了经过测试的版本组合及其各自依赖关系：

#升级策略

#小版本升级

• 方式：支持从任何小版本直接升级到同一大版本中的较新发布版本（例如，4.0.x → 4.1.0）。
• 优势：这种方式可将运维风险降至最低，并促进版本之间的平滑迁移。

#补丁版本升级

• 兼容性：补丁版本在同一小版本系列内完全兼容。
• 示例：在同一小版本系列内升级（例如，x.y.0 → x.y.1）可应用最新的 bug 修复和安全补丁。

#大版本升级

• 要求：在跨大版本升级时（例如，4.1.0 → 5.0.0），请直接升级到目标大版本中最新可用的发布版本。
• 操作步骤：按照以下升级步骤先升级 operator，然后按照 实例升级指南 升级各个实例。
• 注意事项：大版本升级可能需要修改配置，并对功能兼容性进行全面审查。

#升级步骤

1. 从 AlaudaCloud 下载目标版本的 Alauda Cache Service for Redis OSS 插件到一台能够访问您的 ACP 集群的节点上。
2. 使用 violet 包管理工具将插件上架到目标集群。有关详细说明，请参阅 上架软件包 文档。
3. 升级会遵循 Subscription 中配置的策略：

   • Automatic Upgrade：插件在上架后自动升级。

   • Manual Upgrade：

     CLI

     Web Console

     # Check for available upgrades
     $ kubectl -n redis-system get subscriptions.operators.coreos.com redis-operator -o go-template='{{ printf "Installed: %s\n  Current: %s" .status.installedCSV .status.currentCSV }}'
     
     # If an upgrade is available, find the corresponding InstallPlan for the Subscription
     $ kubectl -n redis-system get subscriptions.operators.coreos.com redis-operator -o jsonpath='{.status.installplan.name}'
     
     # Approve the InstallPlan to proceed with the upgrade
     $ kubectl -n redis-system patch --type='json' -p='[{"op":"replace","path":"/spec/approved","value":true}]'

     • 登录 Web Console 并切换到 Administrator 视图。
     • 导航到 Marketplace > OperatorHub > Alauda Cache Service for Redis OSS detail page。
     • 在 New Version Detected 通知中点击 Confirm 链接，然后在随后的对话框中点击 Confirm 按钮以批准更新。
     • 如果未出现 New Version Detected 通知，则表示没有可用升级。

     有关升级该插件的更详细说明，请参阅 operator 文档。

4. 若要升级 Redis 实例本身，请参阅 实例升级指南。