发布日期: 2026-01-14
版本号: v4.0.5

Helm v4.0.5 是一个补丁版本，建议用户升级以获得最佳体验。该版本修复了多个问题，包括修复了使用 –keep-history 参数卸载时未能正确保留发布历史记录、在升级失败并删除清单后回滚出错、确保CLI插件名称不与现有Helm命令冲突、修复了使用特定钩子删除策略时 helm test –logs 命令失败、纠正了空依赖列表被错误识别、修复了监视库未仅监视与对象关联的命名空间的问题、解决了下载器插件环境变量的回归问题、修复了 helm upgrade –install 命令未传递 –server-side 标志的问题，并为SDK用户暴露了KUBECONFIG环境变量。用户可以从官方渠道下载适用于MacOS、Linux和Windows各架构的二进制文件进行安装或升级。未来的次要版本4.1.0和3.20.0计划于2026年1月21日发布，补丁版本4.1.1和3.20.1计划于2026年3月11日发布。完整的变更列表已随发布公告提供。

更新内容 （中文）

Helm v4.0.5 是一个补丁版本。建议用户升级以获得最佳体验。

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

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

主要变更

  • 修复了 helm uninstall --keep-history 未正确保留之前部署版本的问题 #12556
  • 修复了升级失败后清单被移除时导致的回滚错误 #13437
  • 修复了 CLI 插件名称与现有 Helm 命令冲突时的检查逻辑
  • 修复了 helm test --logs 在钩子删除策略为 hook-failed 或 hook-succeed 时失败的问题 #9098
  • 修复了空依赖列表被错误识别为存在依赖的问题
  • 修复了 watch 库仅监视对象关联命名空间的问题
  • 修复了下载器插件环境变量的回归问题 #31612
  • 修复了 helm upgrade --install 未正确处理 --server-side 标志的问题 #31627
  • 对于 SDK 用户：将 KUBECONFIG 暴露到环境变量

安装与升级

下载 Helm v4.0.5。常见平台二进制文件位于：

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

快速入门指南可帮助您快速上手。如需升级说明或详细安装说明，请查阅安装指南。您也可以在任何 bash 系统上使用安装脚本进行安装。

后续计划

  • 4.1.0 和 3.20.0 是下一个次版本，将于 2026 年 1 月 21 日发布
  • 4.1.1 和 3.20.1 是下一个补丁版本，将于 2026 年 3 月 11 日发布

变更日志

  • fix(upgrade): 在使用 upgrade –install 时传递 –server-side 标志到 install 1b6053d48b51673c5581973f5ae7e104f627fcf5 (Evans Mungai)
  • fix(cli): 处理 EnvSettings.Namespace() 中的 nil 配置 1e3ee1d2ba5a421165fe053a41aa4071cf69ed62 (Zadkiel AHARONIAN)
  • fix(getter): 传递设置环境变量 31bd995ce201e295ff2f87e11fdf13bf55fdffd2 (Zadkiel AHARONIAN)
  • test(statuswait): 修复 Copilot 代码审查建议的测试中的协程问题 41a6b364a1433dabcefca945619b55a43046f6ce (Mohsen Mottaghi)
  • test(statuswait): 添加 Copilot 代码审查建议的更多测试 2a2e6f722a95a9c312d9f4133e98a67ceaaa5054 (Mohsen Mottaghi)
  • test(statuswait): 添加状态等待相关测试 3818c02f81cdaf2a0eb9e0082d1f89f2cff9df08 (Mohsen Mottaghi)
  • fix: 使用命名空间作用域监听以避免集群范围 LIST 权限 66cab24bb95f68448a83304c6d3297ec45c8fdb7 (Mohsen Mottaghi)
  • 使用长度检查替代 nil 比较检查 MetaDependencies abf2007685501002a5051ded95de9090b5c530f3 (Calvin Bui)
  • 处理私有 executeShutdownFunc 的 golint 警告 4b3de18628896dc2924643e4a32ab4b9228eb922 (Benoit Tigeot)
  • 代码审查 321277002a2513d841cc81480dff37985f28e41a (Benoit Tigeot)
  • 修复代码风格问题 417aae9c01a79c01f3de8c2a08079fddada6078e (Benoit Tigeot)
  • 更新 pkg/action/hooks.go 6c838b4a18fa345cce5a22367522058d3d2ebcc2 (Michelle Fernandez Bieber)
  • 添加 nil 关闭检查 c5d87f2f7da0f3d90bd69d71daa70ada29c9d5b9 (Michelle Fernandez Bieber)
  • 清理空行 53175b76c784a75610c66c36a17787fc463a242d (Michelle Fernandez Bieber)
  • 更新注释并确保关闭函数的 defer 如之前一样返回错误，而不是可能的关闭错误 d2df1ab59e235c2a2edf27bbfdc72ccc09b3af2c (Michelle Fernandez Bieber)
  • 添加在日志检索后执行的关闭钩子 5b223de7c809fe026f1fff03d1fa684187bdfcbe (Michelle Fernandez Bieber)
  • 修复 TestCliPluginExitCode e845b68fe3ea0c91f429b384e3b78f3f853ae208 (tison)
  • 检查插件名称未被使用 30bfd57c5f677b12ea88a32b5e66735967570e4e (tison)
  • 修复缺失资源时的回滚问题 0fd2c418b0146c1ea6182c7f7c7676a345554156 (Feruzjon Muyassarov)
  • fix: 将 KUBECONFIG 环境变量值分配给 env.Kubeconfig b456e274652c84316d5bfcf06d6a8b648e3cc23b (LinPr)
  • fix(rollback): 使用 errors.Is 替代字符串比较 e2021f8818d2cf20c118d91fdba8fba5c472c3bb (Hidde Beydals)
  • fix(uninstall): 废弃已部署版本 af7c15303ace3c506c5c790c41186a09df1c8a54 (Hidde Beydals)

更新内容 （原始）

Helm v4.0.5 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

  • Fixed bug where helm uninstall with –keep-history did not suspend previous deployed releases #12556
  • Fixed rollback error when a manifest is removed in a failed upgrade #13437
  • Fixed check to ensure CLI plugin does not load with the same name as an existing Helm command
  • Fixed helm test –logs failure with hook-delete-policy “hook-failed” or “hook-succeed” #9098
  • Fixed a bug where empty dependency lists were incorrectly treated as present
  • Fixed a bug where the watch library did not only watch namespaces associated with the objects
  • Fixed regression in downloader plugins environment variables #31612
  • Fixed bug where –server-side flag is not respected with helm upgrade –install #31627
  • For SDK users: exposed KUBECONFIG to env

Installation and Upgrading

Download Helm v4.0.5. 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.1.0 and 3.20.0 is the next minor releases and will be on January 21, 2026
  • 4.1.1 and 3.20.1 are the next patch releases and will be on March 11, 2026

Changelog

  • fix(upgrade): pass –server-side flag to install when using upgrade –install 1b6053d48b51673c5581973f5ae7e104f627fcf5 (Evans Mungai)
  • fix(cli): handle nil config in EnvSettings.Namespace() 1e3ee1d2ba5a421165fe053a41aa4071cf69ed62 (Zadkiel AHARONIAN)
  • fix(getter): pass settings environment variables 31bd995ce201e295ff2f87e11fdf13bf55fdffd2 (Zadkiel AHARONIAN)
  • test(statuswait): fix Copilot code review suggestion for goroutine in tests 41a6b364a1433dabcefca945619b55a43046f6ce (Mohsen Mottaghi)
  • test(statuswait): add more tests suggested by Copilot code review 2a2e6f722a95a9c312d9f4133e98a67ceaaa5054 (Mohsen Mottaghi)
  • test(statuswait): add some tests for statuswait 3818c02f81cdaf2a0eb9e0082d1f89f2cff9df08 (Mohsen Mottaghi)
  • fix: use namespace-scoped watching to avoid cluster-wide LIST permissions 66cab24bb95f68448a83304c6d3297ec45c8fdb7 (Mohsen Mottaghi)
  • Use length check for MetaDependencies instead of nil comparison abf2007685501002a5051ded95de9090b5c530f3 (Calvin Bui)
  • Deal with golint warning with private executeShutdownFunc 4b3de18628896dc2924643e4a32ab4b9228eb922 (Benoit Tigeot)
  • Code review 321277002a2513d841cc81480dff37985f28e41a (Benoit Tigeot)
  • Fix linting issue 417aae9c01a79c01f3de8c2a08079fddada6078e (Benoit Tigeot)
  • Update pkg/action/hooks.go 6c838b4a18fa345cce5a22367522058d3d2ebcc2 (Michelle Fernandez Bieber)
  • added check for nil shutdown c5d87f2f7da0f3d90bd69d71daa70ada29c9d5b9 (Michelle Fernandez Bieber)
  • cleaned up empty line 53175b76c784a75610c66c36a17787fc463a242d (Michelle Fernandez Bieber)
  • updated comment and made defer of shutdown function return errors as before and not the possible shutdown error d2df1ab59e235c2a2edf27bbfdc72ccc09b3af2c (Michelle Fernandez Bieber)
  • added shutdown hook that is executed after the logs have been retrieved 5b223de7c809fe026f1fff03d1fa684187bdfcbe (Michelle Fernandez Bieber)
  • Fix TestCliPluginExitCode e845b68fe3ea0c91f429b384e3b78f3f853ae208 (tison)
  • Check plugin name is not used 30bfd57c5f677b12ea88a32b5e66735967570e4e (tison)
  • Fix rollback for missing resources 0fd2c418b0146c1ea6182c7f7c7676a345554156 (Feruzjon Muyassarov)
  • fix: assign KUBECONFIG environment variable value to env.Kubeconfig b456e274652c84316d5bfcf06d6a8b648e3cc23b (LinPr)
  • fix(rollback): errors.Is instead of string comp e2021f8818d2cf20c118d91fdba8fba5c472c3bb (Hidde Beydals)
  • fix(uninstall): supersede deployed releases af7c15303ace3c506c5c790c41186a09df1c8a54 (Hidde Beydals)

下载链接