本节包含有关如何将 Rancher Server 升级到较新版本的信息。无论 Rancher Server 是否安装在内网环境中,升级步骤取决于您是在使用单节点 Rancher 还是在使用高可用 Rancher。请从以下选项中选择:

已知的升级问题

下表列出了升级 Rancher 时要考虑的一些最值得注意的问题。可以在GitHubRancher 论坛的发行说明中找到有关每个 Rancher 版本的已知问题的更完整列表。

升级场景问题
升级到 v2.3.0+从 v2.0,v2.1 或 v2.2 版本升级到 v2.3.0 或者以上版本时,第一次修改通过 Rancher v2.3.0 之前版本部署的 RKE 集群时,由于要向系统组件中加入 Tolerations,该集群全部的系统组件将会自动重启。
升级到 v2.2.xRancher 引入了System Charts代码库,其中包含监控,日志,告警和全局 DNS 等功能所需的所有应用商店应用。为了能够在离线环境中使用这些功能,您将需要在本地镜像system-charts代码库,并将 Rancher 配置为使用该代码库。请按照说明配置 Rancher System Charts
从 v2.0.13 或更早版本升级如果您集群的证书已过期,则需要执行其他步骤来轮换证书。
从 v2.0.7 或更早版本升级Rancher 引入了 System 项目,这是一个自动创建的项目,用于存放 Kubernetes 需要操作的重要命名空间。在升级到 v2.0.7+ 的过程中,Rancher 希望从所有项目中移出这些命名空间。在开始升级之前,请检查这些系统命名空间,确保它们不在任何项目中,从而防止集群网络问题

警告

Rancher 不支持升级到rancher-alpha 库中的任何版本,或从rancher-alpha 库中的任何版本升级到其他版本。

通过 RKE Add-on 安装

重要提示:RKE Add-on 安装方式仅支持到 Rancher v2.0.8 版本

请使用 Rancher helm chart 来安装 Rancher 高可用。有关详细信息,请参见高可用安装 - 安装概述

如果您当前正在使用 RKE Add-on 安装方法,请参阅从 RKE Add-on 安装迁移了解有关如何迁移到使用 helm chart 安装 Rancher 高可用。