运行镜像
运行镜像就是 Agent 工作的那个容器。每一轮的沙箱都从它启动,跑在 gVisor 下,没有网络,所以仓库构建和测试要用的东西,必须已经在镜像里或者仓库里。
默认镜像
| 基础 | Debian bookworm,Python 3.12 |
| Node.js | 22,带 npm 和 npx |
| Python 工具 | uv,以及 Yi Code 自身依赖的包,包括 pytest |
| 其他工具 | git、bash、tmux |
| Agent 用户 | agent,uid 1000,不是 root |
| 平台 | Linux amd64 |
镜像里没有 Go、Rust、Java、Gradle 工具链,也没有 make。需要这些的仓库会得到「未验证」,原因是「执行环境缺少所需工具链。」见验证。
每个沙箱有 2 个 CPU 和 4 GiB 内存。
用哪个镜像
部署管理员用 YI_RUNTIME_IMAGE 指定镜像,按 digest 固定。每一轮都会记下它开始时用的镜像。
- 云服务:镜像由我们维护,组织不能更换。
- 私有部署:安装时会把
YI_RUNTIME_IMAGE设成离线包自带的镜像。你们也可以自己构建,比如装上你们的语言工具链,预装测试需要的依赖。
自定义镜像必须重新验收
自定义镜像改变了沙箱里运行的东西。任何执行池用它之前,都要在真实的执行主机上通过和我们一样的检查:
- 在 gVisor(
runsc)下,原生的工具通道可以正常使用终端和文件编辑。 - Agent 以 uid 1000 运行,改不了受保护的 Git 基线和原始测试。
- 沙箱访问不到公网、云 metadata 服务,也访问不到主机上监听的端口。
- 验证和导出正常,沙箱事后被删除。
主机通过这些检查之后,执行池才会启用。CI 里容器构建通过,不能代替这一步。