top of page

大扫除:我们终于把 GitHub 的缓存用对了 🧹

作家相片: Marcel Dütscher
Marcel Dütscher
7月27日
讀畢需時 4 分鐘

在上一篇技术文章里,我们测量了构建和检查流水线到底花了什么:不是钱,而是等待时间和存储空间。那篇文章的结尾是“清理工作已经计划好,但还没完成”。结果比预想的快:从今天中午起,它已经进入主分支了。下面是数字。


先看结果。我们仓库的缓存用量,从 63 个条目共 5.32 GB,降到了 13 个条目共 2.46 GB。以前每个拉取请求都要跑的 C# 安全分析,现在在那里只需要 4 秒,而不是 4 分半,同时仍然检查所有会发布出去的内容。这一切都没有去掉任何一项保护你的检查。


简单说:缓存是干什么的?每次构建都从一台全新的空机器开始。为了不每次都从零开始,它可以存下一些中间结果,下次直接下载,而不用重新生成。每个仓库有 10 GB 的额度。满了以后,GitHub 会清掉最久没用的东西。而这正是我们的问题:空间被占满了,只是被错误的东西占着。


错误一:缓存键里没有平台。Unity 构建时会生成一个巨大的中间文件夹。有四个构建要用它:Windows、Linux、macOS、WebGL,每个都需要自己的那份。Windows 构建是唯一一个缓存键里没有平台标记的。所以它匹配到了第一个能找到的条目,恰好是 WebGL 的:下载了 1.7 GB,Unity 又正确地认出“这个不属于这里”,然后从头重新导入。日志里是:导入花了 257 秒,而不是 85 秒。现在缓存键是 Library-Windows-,这个怪事就结束了。


错误二:根本没人保存过它。这个发现更让人脸红。四个构建都很认真地尝试恢复这个中间文件夹,但没有任何一个工作流写入过它。唯一存在的那个条目来自一个要手动启动的工具。也就是说,项目里最重要的缓存是靠偶然维持的。🙈 现在它是有意写入的了。


省空间的决定:只有关键路径才算数。最显而易见的做法是把四个平台全部缓存。但看一下真实发布的耗时就知道那有多荒谬:四个构建同时开始,Windows 11 分钟后完成,Linux 和 macOS 是 13.7 分钟,WebGL 则是 31.6 分钟。只要 WebGL 还在跑,其他的反正都在等。所以只有它的缓存能缩短等待;另外三个会占掉我们 10 GB 额度里大约 4.5 GB,却一分钟都省不了,准确说是零。所以我们只缓存一个。


错误三:Docker 吃掉了剩下的。构建服务器镜像时,以前每一个中间层都会被存成缓存,大约是 24 个条目共 3.27 GB,占了整个额度的 64%,而且每次推送都会刷新。这股洪流稳定地把那个唯一重要的 Unity 缓存挤了出去。现在只存最终阶段,我们的四个镜像也各自有了自己的命名空间,以前它们共用一个,不停地互相挤掉对方。3.27 GB 变成了大约 150 MB。


安全分析:在关键的地方检查。CodeQL 是 GitHub 用来发现安全漏洞的工具,它是我们第二大的时间消耗:八天里共 230 分钟,几乎全是 C# 部分,因为它为了分析要重建整个项目,而且每个拉取请求都要来一遍。现在它在合并进主分支时完整运行,另外每周运行一次;拉取请求只做快速检查。改完后的实测:拉取请求里 4 秒,主分支上依然是不变的 4 分多钟。所以每一行真正会送到你手里的代码依然被检查,只是不会检查三遍了。


积少成多的小事。.NET 包现在会被缓存,但只在有人要等待的路径上。用于外来处理器架构的模拟器只有在我们真的为它构建时才会设置。一条在刚启动的机器上无事可做、却让每次构建多花最多 1.4 分钟的清理命令,被删掉了。发布构建的中间文件现在 7 天后清除,而不是 90 天,之前已经堆了 703 个,共 7.4 GB。


我们刻意没有做的事。我们自己分析里的两个提案,在测量之后被放弃了,而不是被包装成更新日志里的漂亮一行。把测试拆到两个并行任务里,只会省下四秒(一部分要 2:54,另一部分 4 秒),还会改掉一个必需检查的名字,让每个拉取请求永远卡在“等待中”。在发布前跳过大型测试关卡也什么都省不了,因为它早在 WebGL 还在构建时就跑完了。一个什么都没赢到、却拆掉了安全网的优化,不叫优化。


然后真的挖出了一个漏洞。在这次清理的过程中,每个拉取请求突然都超时了:有一个测试用了 212 秒,而允许的只有 120 秒。同一次运行里第二慢的是 10.5 秒。原因是我们服务器里的一条错误路径,对一个损坏的 HTTP 请求只是直接掐断,而不是干净地关闭。在 Linux 上,系统只会在每两分钟一次的清扫里回收这种连接,而关机一直在耐心等待它。在 Windows 上从没出现过,所以它只在构建服务器上咬过我们。现在服务器会用一个诚实的错误码回应这种情况,并自己关闭连接:测试用了二十来秒就结束了,真实的玩家碰到这种小状况时,也会得到一个看得懂的错误,而不是被切断的连接。一个持续集成大扫除日找出一个线上漏洞,这是美好的一天。🐛


这一切对你没有任何直接的改变,没有新方块,也没有新动物。它只是缩短了“写完代码”和“你能安装”之间的路。它也证明了和上次同一句话:先测量,再动手。🚀

最新文章

查看全部
35 代世界生成——你的旧世界依然好好的 🌍

2026年11月13日 从九月初到现在,我们的世界生成器已经新增了 35 代。每一代都带来新东西:八种新的行星类型、冰川和环礁、一个城市世界、果树、有毒的世界、气态巨行星、平静的水面、Jafar 的小行星 KuBa-W、Schuppenhund,还有最近随 2026.11.9 版本加入的被掩埋的 G.D.S. 遗迹。可是,你八月就开始玩的那个世界,看起来仍然和第一天一模一样,一个方块都没变。这是怎

 
 
Justus 的笔记本电脑就是我们的标尺 💻

2026年11月7日 我们的策略里有一个问题,每个新想法都必须通过:它在浏览器标签页里还能运行吗?对我们来说,性能不是最后才做的收尾工作。它是游戏的一项功能,和其他功能一样重要。我们衡量它的标尺不在办公室里,而在家里:Justus 的笔记本电脑。里面是一颗 Intel i5-8250U 和一块 Radeon 530,也就是2017年的处理器和入门级显卡。孩子们玩游戏用的正是这样的设备:家里的旧笔记

 
 
一天1,752篇文章:我们的开发日志是怎么学会十二种新语言的 🌍

2026年11月7日 8月,我们的游戏在一周内学会了十四种语言。开发日志却落后了很久。如果你用法语或日语打开网站,博客页面只会告诉你这种语言还没有文章。每篇文章上方的语言切换器提供了全部十四种语言,但其中十二种通向的是错误页面。🙈 从10月3日起,这个问题没有了。 数字。当时博客里有146篇文章,每篇都有德语和英语版本。一天之内,十二种语言加入了进来:法语、西班牙语、意大利语、葡萄牙语、荷兰语、

 
 

留言


這篇文章不開放留言。請連絡網站負責人了解更多。
bottom of page