• 如果您打算从 v2.2 版本升级到 v2.3.7，请务必查看中的重要更新和重大改动的说明。

下面的版本为当前的最新版和稳定版：

您可以通过如何选择版本的文档，了解更多关于不同版本和标签的区别。

功能和优化

  • 监控增强：
    • 支持配置 livenessProbe []：能够配置监控组件中的工作负载的 livenessProve 选项。
  • 支持一种新的 DNS 插件 nodelocal DNS [#25811]

我们提供了一种启停 Rancher 中实验性功能模块的能力。在这个版本里，您可以通过 UI 来控制“功能开关”。详情请查阅的文档。

自 v2.3.6 以来修复的主要问题

  • Rancher UI 中禁止编辑 EKS 中的某些字段，因为这些字段在 AWS 控制台上就是不可编辑的 []
  • 阿里云主机驱动支持设置按流量付费和按带宽付费 [#15847]
  • 修复了导入集群的节点无法添加标签的问题 []
  • 修复了监控在某些情况下 Pod CPU 和内存使用量翻倍的问题 [#26594]
  • 修复无法更换 EKS 集群使用的 AWS API 密钥的问题 []
  • 修复了在 AWS 控制台修改 EKS 集群后，导致无法在 Rancher 中升级 EKS 集群版本的问题 [#24171]
  • 修复了通过 API 升级项目级别应用商店中的应用时，需要传入 projectId 的问题 []

在 v2.3.0+的版本里，离线安装将不在需要手动同步 system charts 的源代码仓库了。具体操作请参阅有关安装 Rancher 时，如何使用内嵌的 system charts。

  • NGINX ingress controller 0.25.0 版本仅支持有 SSE4.2 指令集的 CPU []

  • Windows 集群限制 - 由于其他上游依赖的原因，Windows 集群有一些已知的限制：

    • Windows 集群的日志功能仅在 Flannel Host Gateway (L2bridge)模式下可以使用。该问题将在 k8s 1.18 版本中修复。[#20510]

  • 安全加固限制 - 如果您按照 Rancher 的安全加固手册进行了配置，那么您将会遇到一些已知的问题。

    • Rancher UI 中的 kubectl 将无法工作 []
    • 流水线将无法工作 [#22844]

  • 如果您是从 v2.2 升级上来的环境，在向已有节点模版中添加的 Taints 后，并使用这个节点模版来扩容 Worker 节点，那么这些新的 Worker 节点可能无法正常工作。您必须在对管理节点或 etcd 节点进行扩缩容后，或是对集群进行编辑后，这些带有 Taints 的新 Worker 节点才能正常工作。因为只有在集群 Reconcile 被触发后，系统组件才会自动添加 Tolerations []

  • 在升级 Rancher 版本后，集群告警组件或集群日志组件有可能会卡在状态。临时解决方案可以在这个 issue 中找到。[#21480]

  • 如果您的 Rancher Server 所在的集群配置了 OpenStack cloud provider 并设置了 LoadBalancer，并且这个 Rancher Server 所在的集群是在 v2.2.3 或者更早的版本创建的，那么直接升级到 Rancher v2.2.4 或之后的版本将会失败。您可以在这个 issue 的评论中找到这种情况下的迁移方法 []

  • 由于更新了 Fluentd Kubernetes metadata 插件的原因，Rancher 日志采集的格式发送了变化。json 格式的日志将不能被处理，所以在采集到的日志里将无法把 json 格式日志合并作为顶层键。我们在这个 issue 中，通过另外一种方式，重新提供了这个能力 [#23646]

版本信息

  • rancher/rancher:v2.3.7
  • rancher/rancher-agent:v2.3.7

:::important 重要 在回滚的时候，您将会被回滚到升级之前的状态。任何在升级后进行的改动将无法被保留。 :::

Rancher 支持和回滚操作。在修改 Rancher 版本时，请先确认您要升级到或者回滚到的 Rancher 版本。

请注意，在升级到 v2.3.0 或者以上版本时，第一次修改通过 Rancher v2.3.0 之前版本部署的 RKE 集群时，由于要向系统组件中加入 Tolerations，该集群全部的系统组件将会自动重启。请事先规划好。

如果您的 Rancher HA 在使用 低于 v0.9.1 的 cert-manager，并且是自签名证书，由于 cert-manager 最新的变化，您需要升级 cert-manager 的版本。具体操作请参阅有关的文档。

Assets