ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Helm v3 与 v4 该选哪个:main 与 dev-v3 分支职责、支持期限和回移规则怎么判断?

Helm v3 与 v4 该选哪个:main 与 dev-v3 分支职责、支持期限和回移规则怎么判断? Helm v3 与 v4 该选哪个main 与 dev-v3 分支职责、支持期限和回移规则怎么判断【免费下载链接】helmThe Kubernetes Package Manager项目地址: https://gitcode.com/GitHub_Trending/hel/helm如果你正在用 Helm 管理 Kubernetes 上的应用现在会面对一个具体选择继续用 Helm v3还是切到 Helm v4如果你要给项目提 patch还需要搞清楚改动应该落在哪个分支、什么情况下会回移到 v3。Helm 仓库文档README.md、CONTRIBUTING.md、AGENTS.md已经给出了明确的分支职责、支持期限和回移规则这篇文章把它们整理成一条可以直接照做的判断路径先确认当前 checkout 属于哪个版本线再按支持期限和新功能需求做选择最后用helm version验证装的是哪个主版本。先确认main 与 dev-v3 各自承载什么三个文档对分支职责的表述一致可以先建立这张对照分支承载版本接受什么改动文档依据mainHelm v4当前稳定版本current stable releasev4 的新功能开发、bug 修复、安全修复README.md Helm v4 is the current stable release, developed on themainbranch.dev-v3Helm v3处于 support mode 支持模式仅 bug 修复和安全修复no longer accepting new features不再接受新功能README.md Helm v3 is in support mode on thedev-v3branch…receives only bug and security fixes.CONTRIBUTING.md Helm v3 (and thedev-v3branch) is no longer accepting new features.AGENTS.md 补充了完整的分支模型说明发布分支从何而来开发分支mainHelm v4、dev-v3Helm v3从 main 回移安全修复和 bug 修复发布分支release-v3.X对应 v3.X 各版本release-v4.X对应 v4.X 各版本minor 发布分支从main切出通过 patch 版本维护关键修复。也就是说日常开发只发生在maindev-v3是一个只进修复、不进功能的维护分支。支持期限两个日期分别管什么README.md 和 CONTRIBUTING.md 给出了同一个支持期限且区分了两类修复的截止点2026 年 7 月 8 日v3 的 bug 修复包括对新版 Kubernetes 的适配截止。README 的表述是 bug fixes until July 8th 2026CONTRIBUTING 的表述是 bug fixes and updates for new Kubernetes releases until July 8th 2026。2026 年 11 月 11 日v3 的安全修复security fixes / security enhancements截止。判断要点v3 并不是到 2026 年 11 月就完全停止维护——bug 修复在 7 月 8 日之后就停了11 月 11 日之后连安全修复也不再有。文档没有说明日期之后的安排所以做版本决策时只能把这两个日期当作 v3 可获得修复的硬性上限。怎么判断选 v3 还是 v4按上面两条事实可以排出一个清晰的判断顺序需要任何新功能或新特性 → 只能选 v4。dev-v3明确不再接受新功能CONTRIBUTING.md任何只存在于main上的能力v3 永远不会得到。只用现有功能、无新功能诉求 → 可以留在 v3但要核对日期。如果当前时间已经超过 2026 年 7 月 8 日v3 将不再获得 bug 修复超过 2026 年 11 月 11 日安全修复也停止。此时继续留在 v3 意味着自担风险应规划迁移到 v4。兼容性预期。CONTRIBUTING.md 对 3.0 到 4.0 之间的版本给出了向后兼容的明确承诺可以作为留在 v3 线内升级的安全边界命令行命令、flag、参数必须向后兼容文件格式如 Chart.yaml必须向后兼容在旧版 Helm 3 上能工作的 chart必须在新版 Helm 3 上继续工作例外Kubernetes 自身发生了变化或 chart 原本是靠某个 bug 才能工作的chart 仓库功能必须向后兼容pkg/目录内的 Go 库必须保持向后兼容cmd/和internal/内的代码可以在版本之间随意变更无需预告。唯一的例外是安全漏洞修复允许做最小的不兼容改动AGENTS.md An exception to the above is where incompatible changes are needed to fix a security vulnerability。注意这条承诺覆盖的是 v3 主版本之内3.0 → 4.0 之间各 3.x 版本的兼容性文档没有给出 v3 与 v4 之间的兼容性矩阵涉及跨大版本的迁移不要在本文之外自行套用。用版本号和模块路径核对当前属于哪条版本线判断我手上到底是 v3 还是 v4有两个文档中出现的核对方式核对已安装的客户端两个安装脚本 scripts/get-helm-3 和 scripts/get-helm-4 内部都用同一条命令比对已装版本可以直接借用helm version --template{{ .Version }}输出带v3前缀就是 v3 线v4前缀就是 v4 线脚本中该命令用于和 release tag 比较。核对源码 checkout 属于哪条线本仓库 go.mod 第一行是module helm.sh/helm/v4说明当前 checkout即main分支属于 v4 版本线。如果你 clone 到的是dev-v3分支对应的模块声明会落在 v3 线上可以用同样方式查看 go.mod 第一行确认。区分两个下载渠道如果你用官方脚本安装注意两个脚本请求的最新版接口不同——scripts/get-helm-3从https://get.helm.sh/helm3-latest-version取 v3 的最新 tagscripts/get-helm-4从https://get.helm.sh/helm4-latest-version取 v4 的最新 tag不指定版本时各装各线的 latest。两个脚本都支持--version如--version v3.0.0或--version v4.0.0固定具体版本。脚本默认以 root 安装到/usr/local/bin可用--no-sudo跳过 sudo这里只用于核对渠道具体安装以 README.md 的 Install 章节为准。回移规则给项目提 patch 时的分支选择CONTRIBUTING.md 和 AGENTS.md 给出的回移规则一致贡献者视角的判断规则如下一切 bug 和安全修复先在 Helm v4main上修好然后再回移到 Helm v3dev-v3。CONTRIBUTING.md 原文Bugs should first be fixed on Helm v4 and then backported to Helm v3.dev-v3不再接受新功能——你的 feature PR 只能面向main。回移的触发是where applicableAGENTS.md 的表述是 Bug and security fixes are also backported todev-v3where applicable.即回移以该修复适用于 v3 为前提由维护者判断。标签机制PR 需要被 cherry-pick 进维护分支一般是 bugfix 分支时打needs pick标签完成 cherry-pick 后改为picked标签见 CONTRIBUTING.md 的 PR Specific 标签表。反向操作不被接受把只存在于 v3 的修复升级到 v4或者往dev-v3提新功能 PR都不符合文档描述的流程。验证与边界完成判断后落到两个可核对的结果上helm version --template{{ .Version }}的主版本号3 或 4与你的决策一致决策依据的两个日期bug 修复至 2026 年 7 月 8 日、安全修复至 2026 年 11 月 11 日以 README.md 为准两个文档表述一致无冲突。文档明确的边界支持期限只覆盖 v3v3 与 v4 之间是否存在兼容性差异、如何迁移本仓库文档未给出说明这部分不应由本文代为结论。确定版本线之后的安装方式二进制下载、Homebrew、Chocolatey、Winget、Scoop、Snap、Flox、Mise 等见 README.md 的 Install 章节。【免费下载链接】helmThe Kubernetes Package Manager项目地址: https://gitcode.com/GitHub_Trending/hel/helm创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表