#升级

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 并切换到管理员视图。
     • 前往 Marketplace > OperatorHub > Alauda Cache Service for Redis OSS 详情页。
     • 在 检测到新版本 通知中单击 确认 链接，然后在随后显示的对话框中单击 确认 按钮，以批准更新。
     • 如果未显示 检测到新版本 通知，则表示没有可用的升级。

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

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