一个流水线视图要回答的问题其实很简单:现在还有什么在跑、在等、被卡住。在 glab ci view 里,一次重试就可能让这个答案变得不完整。重试本身显示得没错,但列表里排在它后面的一个无关条目会消失。下游流水线触发器在 GitLab 里仍然存在,终端视图却没有任何提示。

打开网易新闻 查看精彩图片

这是一个渲染层面的缺陷。修复不改变哪些 CI 任务会运行,也不改变下游流水线何时启动,它改变的是 CLI 在构建视图时保留哪些条目。

复现只需要三个条目。CLI 先收集流水线任务,再在构建显示列表之前追加下游流水线触发器。回归测试里的输入顺序如下,其中下游条目代表一个触发器:

  • ID 1,阶段 test,名称 unit,原始尝试
  • ID 2,阶段 test,名称 unit,重试
  • ID 3,阶段 deploy,名称 downstream,独立条目

预期显示是 unit 的第 2 次尝试,然后是 downstream(ID 3)。旧代码只返回了 unit 的第 2 次尝试。这也是这个缺陷容易被忽略的原因:如果只检查哪次重试胜出,去重逻辑看起来是对的。

那一行去了哪里

旧的辅助函数做了两件事。它记录每个任务键对应的最后一个条目,然后用第一个重复出现的键来决定分配多少个输出槽位。它假设重复项标志着“只剩重试”的尾部从这里开始。在这个例子里,第二个条目重复了 test/unit,于是输出只得到一个槽位。辅助函数把这个槽位填成第 2 次尝试。它已经看到了下游条目,却始终没给它分配槽位。

这个假设对一份排列整齐的输入也许成立,但调用方再追加另一串条目之后就不成立了。第一个重复项只能告诉你某个任务此前出现过,它对下一个条目一无所知。

保留位置,替换尝试

提出的修复方案是:每个不同的(阶段,名称)组合在首次出现时获得一个输出索引,之后每次出现都更新该索引上的任务。循环走完整个切片,因此无论中间重复多少次,新的键仍然能拿到新槽位。

  • 输入 test/unit 第 1 条:在索引 0 追加,结果为 [unit #1]
  • 输入 test/unit 第 2 条:替换索引 0,结果为 [unit #2]
  • 输入 deploy/downstream:在索引 1 追加,结果为 [unit #2, downstream #3]

用 Go 结构体作为映射键,还能让两个字段保持独立。旧的拼接方式会让("ab","c")和("a","bc")都变成 abc。结构体键不需要分隔符或转义规则就能区分它们。这次扫描只走一遍,每个不同键对应一个映射条目,保留首次出现的顺序,并显示每个任务最后提供的尝试。这与决定流水线阶段的配置顺序是两回事。

同一个测试,修前失败修后通过

为了隔离改动,聚焦测试先在旧辅助函数上运行,只加入新测试,然后再带上补丁运行一次:

go test -count=1 -run '^Test_latestJobsKeepsJobsAfterRetry$' ./internal/commands/ci/view

GitLab 合并请求里包含补丁和回归测试。完整的 ci view 包测试和 MR 流水线都通过了。该 MR 仍处于打开状态,所以这是一个提议中的修复。

如果自己的显示代码会合并重复事件,可以在测试里把无关条目紧跟在第一个重复项之后,然后同时断言精确的输出顺序和胜出的尝试。这种变体能抓住那些“列表以重试结尾”时被掩盖的截断缺陷。