K3s v1.37.1+k3s1 版本更新与修复要点

技术要点

K3s v1.37.1+k3s1 版本的核心变更是将 Kubernetes 升级至 v1.37.1。此次更新主要围绕一系列问题修复和依赖组件升级展开，具体变更条目如下：

1. 功能修复与改进：修复了从压缩的 etcd 快照进行恢复的问题；解决了 --flannel-cni-conf 配置无法到达嵌入式 flannel 的问题；修复了 deploy controller 在 mtime 被固定到 epoch 时不重新应用 manifests 的问题。
2. 架构与构建支持：在 riscv64 架构的构建中启用了 seccomp 支持。
3. 测试与开发工具：改用 ginkgo CLI 来运行测试。
4. 依赖组件版本升级：
   • 将 k3s-io/api bump 至 v0.2.0。
   • 将 k3s-io/apis 再次 bump。
   • 将 etcd 升级至 v3.7.1-k3s3，以支持非阻塞日志。
   • 将 kine 升级至 v0.17.1。
   • 将 helm-controller 进行 bump。
   • 将 k3s-io/kubernetes 和 Go 相关引用进行 bump。
   • 将 cadvisor 升级至 v0.60.5-k3s1。
5. 服务与网络：Servicelb 支持多个 lbpools。
6. 资源与性能：修复了 minio.Object 在读取后未关闭的问题。
7. 配置与诊断：当 stdout 不是终端时，check-config 命令会抑制颜色输出。
8. 安全增强：拒绝匿名访问 supervisor router（包括 spegel、pprof、metrics 端点）；改进了 CA 哈希验证。

此外，本次发布还明确了嵌入式组件的版本信息，包括：Kubernetes v1.37.1、Kine v0.17.1、SQLite 3.53.4、Etcd v3.7.1-k3s3、Containerd v2.3.4-k3s1、Runc v1.4.2、Flannel v0.28.4、Metrics-server v0.9.0、Traefik v3.7.13、CoreDNS v1.14.7、Helm-controller v0.17.9、Local-path-provisioner v0.0.37。

原理与背景

此次版本更新的主要动机是跟进上游 Kubernetes 的稳定版本，并解决在 K3s 特定集成场景中发现的问题。

Kubernetes 版本从 v1.37.0 升级至 v1.37.1，通常包含上游社区修复的 bug 和安全补丁，这有助于 K3s 用户获得更稳定、更安全的基础环境。K3s 作为轻量级 Kubernetes 发行版，其嵌入式组件（如 etcd、kine、flannel 等）的版本同步更新，确保了内部依赖的协调性和兼容性。

针对具体问题的修复，其设计动机清晰。例如，修复“从压缩 etcd 快照恢复”的问题，直接关系到集群数据备份与恢复功能的可靠性，是运维安全的关键保障。在 riscv64 构建中启用 seccomp，扩展了 K3s 对新兴硬件架构的支持，提升了部署的灵活性。拒绝匿名访问 supervisor router 上的敏感端点（如 metrics、pprof），是出于安全考量，防止未授权的用户获取系统性能数据或进行调试操作，这符合最小权限原则。改进 CA 哈希验证则增强了证书验证过程的健壮性，有助于防范潜在的中间人攻击或证书伪造问题。

依赖组件的 bump（如 etcd、kine、cadvisor 等）通常是为了获取这些组件自身的性能优化、bug 修复或新功能，从而间接提升 K3s 集群的整体表现和稳定性。

落地建议

对于计划升级至 K3s v1.37.1+k3s1 的用户或运维工程师，可以参考以下通用做法：

1. 升级前评估与备份：在升级生产环境集群前，务必仔细阅读本次发布的完整说明，评估所有变更项（尤其是安全相关和核心功能修复）对你现有工作负载的影响。对重要集群状态和数据（如 etcd 数据）进行完整备份。
2. 测试环境验证：建议在非生产环境中先行升级，验证应用兼容性、网络插件（如 flannel）配置、服务负载均衡（servicelb）等功能是否正常工作。
3. 关注安全配置：由于本次更新加强了 supervisor router 的安全访问控制，需检查相关服务配置，确保必要的监控或调试访问通过授权方式进行，避免服务中断。
4. 逐步升级策略：对于大规模集群，可采用分批升级的策略，先升级控制平面节点，再逐步升级工作节点，以最小化服务影响。
5. 查阅官方文档：升级过程中遇到的具体配置问题，应参考 K3s 官方文档中关于版本升级和组件配置的指南，进行相应的配置调整。