发布日期: 2026-03-12
版本号: v3.20.1

Helm v3.20.1是一个补丁版本，建议用户升级以获得最佳体验。社区欢迎通过Kubernetes Slack进行交流、参与公共开发者会议（每周四上午9:30太平洋时间）以及在ArtifactHub上测试和贡献图表。本次更新主要修复了两个问题：修复了当图表具有空映射或键无默认值时用户提供的nil值未被保留的缺陷，以及修复了带有标签和摘要的OCI引用因“无效字节”错误而失败的问题。用户可以从官方渠道下载适用于MacOS、Linux和Windows各架构的安装包，并使用GPG密钥验证签名。未来计划包括4.2.0和3.21.0版本将于2026年5月13日发布，4.1.4和3.20.2版本将于2026年4月8日发布。此次更新还包含多项依赖升级、测试改进和代码修复工作。

更新内容 （中文）

Helm v3.20.1 是一个补丁版本。建议用户进行升级以获得最佳体验。

社区持续壮大，我们期待您的加入！

  • 加入 Kubernetes Slack 讨论：
    • 用于提问和交流
    • 用于讨论 PR、代码和缺陷
  • 参与公开开发者会议：太平洋时间每周四 9:30，通过 Zoom 参与
  • 测试、调试和贡献 Chart：ArtifactHub/packages

主要变更

  • 回溯移植 #31644：修复了当 chart 包含空映射或某键无默认值时，用户提供的 nil 值未被保留的缺陷。
  • 回溯移植 #31601：修复了带标签+摘要的 OCI 引用出现 “invalid byte” 错误的缺陷。

安装与升级

下载 Helm v3.20.1。常用平台二进制文件如下：

此版本使用 208D D36E D5BB 3745 A167 43A4 C7C6 FBB5 B91C 1155 签名，可在 @scottrigby keybase 账户 找到。请使用附带的签名通过 gpg 验证此版本。

快速入门指南将帮助您开始使用。有关升级说明或详细安装注意事项，请查阅安装指南。您也可以使用安装脚本在任意支持 bash 的系统上安装。

后续计划

  • 4.2.0 和 3.21.0 将是下一个小版本，发布日期为 2026 年 5 月 13 日
  • 4.1.4 和 3.20.2 将是下一个补丁版本，发布日期为 2026 年 4 月 8 日

变更日志

  • chore(deps): 更新 k8s-io 组依赖共 7 项更新 a2369ca71c0ef633bf6e4fccd66d634eb379b371 (dependabot[bot])
  • 添加镜像索引测试 90e10564f7ae746a153f3a03006e7061a54ad490 (Pedro Tôrres)
  • 修复从 OCI 索引拉取 Chart 的问题 911f2e908ae40b01ca95b857e94b8894043f64fd (Pedro Tôrres)
  • 从 coalesce_test.go 移除重构变更 76dad33fb1a2b6451920429b4f5f2dd575ea71bb (Evans Mungai)
  • 修复导入 45c12f71407b6054a37d3e425d5293ee79a1ab37 (Evans Mungai)
  • 更新 pkg/chart/common/util/coalesce_test.go 26c6f19f967941dbe53bfb5e52d419b3b3e46075 (Evans Mungai)
  • 修复 lint 警告 09f5129d49a14c9336cea6f33adf5f52889915ef (Evans Mungai)
  • 在 chart 中保留 nil 值 417deb2b6b7504357b0f580b76f5eed1bb8a5270 (Evans Mungai)
  • fix(values): 当 chart 默认值为空映射时保留 nil 值 5417bfaa84871feae9c8171f192e2f9796475054 (Evans Mungai)

详见原始内容

更新内容 （原始）

Helm v3.20.1 is a patch release. Users are encouraged to upgrade for the best experience.

The community keeps growing, and we’d love to see you there!

  • Join the discussion in Kubernetes Slack:
    • for questions and just to hang out
    • for discussing PRs, code, and bugs
  • Hang out at the Public Developer Call: Thursday, 9:30 Pacific via Zoom
  • Test, debug, and contribute charts: ArtifactHub/packages

Notable Changes

  • Backport of #31644: Fixed a bug where user-provided nil value was not preserved when chart has an empty map or no default for a key
  • Backport of #31601: Fixed a bug where OCI references with tag+digest failed with “invalid byte” error

Installation and Upgrading

Download Helm v3.20.1. The common platform binaries are here:

This release was signed with 208D D36E D5BB 3745 A167 43A4 C7C6 FBB5 B91C 1155 and can be found at @scottrigby keybase account. Please use the attached signatures for verifying this release using gpg.

The Quickstart Guide will get you going from there. For upgrade instructions or detailed installation notes, check the install guide. You can also use a script to install on any system with bash.

What’s Next

  • 4.2.0 and 3.21.0 are the next minor releases and will be on May 13, 2026
  • 4.1.4 and 3.20.2 are the next patch releases and will be on April 8, 2026

Changelog

  • chore(deps): bump the k8s-io group with 7 updates a2369ca71c0ef633bf6e4fccd66d634eb379b371 (dependabot[bot])
  • add image index test 90e10564f7ae746a153f3a03006e7061a54ad490 (Pedro Tôrres)
  • fix pulling charts from OCI indices 911f2e908ae40b01ca95b857e94b8894043f64fd (Pedro Tôrres)
  • Remove refactorring changes from coalesce_test.go 76dad33fb1a2b6451920429b4f5f2dd575ea71bb (Evans Mungai)
  • Fix import 45c12f71407b6054a37d3e425d5293ee79a1ab37 (Evans Mungai)
  • Update pkg/chart/common/util/coalesce_test.go 26c6f19f967941dbe53bfb5e52d419b3b3e46075 (Evans Mungai)
  • Fix lint warning 09f5129d49a14c9336cea6f33adf5f52889915ef (Evans Mungai)
  • Preserve nil values in chart already 417deb2b6b7504357b0f580b76f5eed1bb8a5270 (Evans Mungai)
  • fix(values): preserve nil values when chart default is empty map 5417bfaa84871feae9c8171f192e2f9796475054 (Evans Mungai)

下载链接