我写了个假的 Gitlab Runner，可以运行自己的测试和编译自己，在每个星期四运行 job 还会有特殊效果（狗头）

[nanmu42]

Github 仓库

https://github.com/nanmu42/tart

摘要

蛋挞是一个教学目的，非官方的 Gitlab Runner ，通过简明地实现 Gitlab Runner 功能的一个子集，展示 Gitlab Runner 的设计和实现方法。

举个例子，蛋挞可以运行自己的 CI job ，运行自己的测试和编译自己。

特色：

• 折腾；
• 使用Firecracker和/dev/kvm，让每个 job 在一个两秒内启动的虚拟机中运行，我目前没在公开资料里查到这么做的；
• 代码量少，大概 2000 行实现了 Gitlab Runner 的核心功能：job 的获取、执行、环境隔离、日志和结果的上报；
• 在每个星期四运行 job 会有特殊效果。

只实现了核心功能，产物上传、service 这些功能是不支持的。换句话说，不要用于生产环境（真的会有人这么做吗）。

使用方法

蛋挞需要在可以访问/dev/kvm的 Linux 环境下运行：

sudo setfacl -m u:${USER}:rw /dev/kvm

1. 从 release 页面下载蛋挞和 Firecracker 的二进制，并将它们置于$PATH
2. 从 release 页面下载 RootFS 和 Linux 内核，把它们放到工作文件夹，比如~/tart
3. 为 tart 创建的虚拟机预先配置网络，请参考rootfs/setup-tuntap.sh
4. cd 到工作文件夹
5. 注册 tart 为你项目的 Gitlab Runner：tart register --endpoint https://gitlab.example.com --token your_token_here > tart.toml
6. 启动 tart：tart run
7. 在 Gitlab 上触发 CI ，为了确保 job 会调度到 tart 上，你可能得禁用项目的 shared runner
8. 观看 tart 工作（或者爆炸）

编译方式

make

产物在bin文件夹中。

虚拟机的 RootFS 和 Linux 内核编译请参考rootfs文件夹。

为啥叫蛋挞？

我喜欢吃蛋挞。

许可证

MIT

请自由享受和贡献开源。

第三方项目许可证请参阅THIRD_PARTY_LICENSES.md.

logo 的照片来自于 Ashley Byrd on Unsplash ，Gopher 在gopherize.me生成。

[nanmu42]

自己打破一下零回复惨案…

[metrue]

我个人还蛮喜欢这样的项目的，GitHub 官方有一个 action 的 Runner https://github.com/actions/runner 不清楚是不是可以参考看看。

[nanmu42]

@metrue 感谢提供信息，我去看看。: D

[lazyrm]

周四肯德基呀？

[israinbow]

tart/runner/crazy_thursday.go

肯德基赞助了多少钱，我麦当劳给你双倍呃

[nanmu42]

@israinbow 哈哈哈哈，底裤都被你脱了。

[yin1999]

OP 有实现虚拟机的文档啥的不，想学习一下这块的内容，之前有想过用容器去实现

[nanmu42]

@yin1999 如果是和 Firecracker 相关的，可以参考这里上手：

https://github.com/nanmu42/tart/tree/master/rootfs

我打算在近期写一篇上面内容的扩展版本。

如果是“怎么实现虚拟机”，我就不是很清楚了。

[reorx]

卧槽，贼有意思的项目。可以脱离 GitLab 独立运行吗，比如提供自己的 API 供其他服务调用

[hawei]

6

[nanmu42]

@reorx 理论上可以，不过那样就不是 CI 啦，而是…虚拟机管理器？！