k3s v1.37.1-rc1+k3s1 版本发布说明

技术要点

本次发布的k3s版本为v1.37.1-rc1+k3s1，发布时间为2026-09-24T01:46:13.000Z。该版本是针对release-1.37分支的backports（向后移植）版本，主要包含以下几项关键变更：

1. helm-controller组件升级：对helm-controller组件进行了版本 bump（升级）。
2. kubernetes及Go依赖更新：更新了k3s-io/kubernetes仓库的引用以及相关的Go语言依赖版本。
3. cadvisor组件升级：将cadvisor组件升级至v0.60.5-k3s1版本。

这些变更通过对应的Pull Request（#14631, #14684, #14695, #14698）合并到release-1.37分支中。

原理与背景

本次发布的核心是“backports”，即把后续开发或修复中的关键变更，移植回当前的release-1.37稳定分支。这种做法通常用于在保持主分支稳定性的同时，为已发布的稳定版本提供必要的修复或小幅功能增强。

具体变更项的背景如下：

• helm-controller升级：helm-controller是k3s中用于管理Helm Chart部署的核心组件。对其进行版本升级，通常是为了集成上游helm-controller的bug修复、性能优化或兼容性改进，从而提升k3s中Helm功能的稳定性和效率。
• kubernetes及Go依赖更新：k3s基于kubernetes构建，其核心依赖于k3s-io/kubernetes仓库。定期更新此依赖以及Go语言相关引用，是为了同步上游kubernetes项目的安全补丁、API变更或性能改进，确保k3s与上游生态保持同步，并受益于Go语言运行时的优化。
• cadvisor升级：cadvisor是k3s用于收集容器资源使用情况和性能指标的组件。将其升级至v0.60.5-k3s1版本，旨在获取cadvisor上游在指标采集准确性、资源消耗或新容器格式支持等方面的改进。

落地建议

对于使用k3s的用户或运维工程师，在考虑应用此版本更新时，可以参考以下通用做法：

1. 评估版本性质：v1.37.1-rc1+k3s1是一个候选Release（rc）版本。在将其用于生产环境前，应充分评估其稳定性。建议先在测试或预生产环境中进行部署和验证。
2. 关注依赖变更影响：本次更新涉及helm-controller、kubernetes核心依赖和cadvisor。如果你们的k3s集群 heavily relies on Helm进行应用管理，或依赖cadvisor进行监控，应重点关注这些组件升级后可能带来的行为变化或兼容性问题。
3. 遵循标准升级流程：在升级k3s集群时，应遵循官方推荐的升级步骤，通常包括备份重要数据、按顺序升级节点（如先升级server节点，再升级agent节点）以及验证集群状态和服务可用性。
4. 查阅完整变更日志：虽然本次摘要列出了主要变更，但完整的变更细节（Full Changelog）可能包含更多细微调整。在决定升级前，建议查阅完整的发布说明或变更日志，以全面了解本次更新的内容。
5. 测试兼容性：升级后，应测试集群中运行的关键应用和服务，确保它们在新的k3s版本上能够正常工作，特别是与Helm Chart部署和监控指标采集相关的功能。