Kuma项目Helm Chart发布过程中的版本丢失问题分析

问题背景

在Kuma项目的持续集成过程中，发现了一个关于Helm Chart发布的严重问题：当发布新版本的Helm Chart时，CI流程有时会意外地从charts仓库中删除已存在的版本。例如，在发布2.8.8版本时，意外删除了2.10.1版本的Chart记录。

问题现象

通过分析CI日志和提交记录，可以观察到以下关键现象：

1. 第一次运行发布流程时，成功添加了kuma-2.10.1.tgz的元数据到index.yaml
2. 第二次运行发布流程时，添加kuma-2.8.8.tgz的同时，却删除了之前添加的kuma-2.10.1.tgz的记录
3. Git提交历史显示第二次提交确实基于第一次提交，排除了并发冲突的可能性

根本原因

这个问题实际上是一个已知的chart-releaser工具(cr)的缺陷。具体原因如下：

1. CDN缓存问题：GitHub Pages使用了内容分发网络(CDN)，当cr工具从仓库获取index.yaml文件时，可能获取到的是CDN缓存的旧版本而非最新版本
2. 索引更新逻辑：cr工具基于获取到的index.yaml进行更新，如果获取到的是旧版本，就会用新版本覆盖掉其他版本记录
3. 版本兼容性：虽然这个问题在cr 1.4版本中已修复，但Kuma项目使用的是1.3版本

解决方案

要解决这个问题，可以考虑以下几种方法：

1. 升级cr工具版本：将chart-releaser升级到1.4或更高版本，该版本已修复CDN缓存导致的问题
2. 优化发布流程：确保在更新索引前获取最新的index.yaml文件，避免使用缓存版本
3. 添加版本验证：在发布完成后，验证index.yaml中是否包含所有预期的版本记录

经验总结

这个案例给我们提供了几个重要的经验教训：

1. 依赖工具版本管理：即使是小型工具依赖，也需要定期检查更新，及时修复已知问题
2. 发布流程健壮性：关键发布流程需要包含验证步骤，确保不会意外删除已有内容
3. 问题排查方法：通过分析CI日志和Git提交历史，可以有效地定位流程中的问题点

对于使用Helm Chart进行应用分发的项目来说，确保Chart仓库的稳定性和完整性至关重要。这个问题的解决将提升Kuma项目Helm Chart发布的可靠性，避免版本丢失给用户带来的困扰。