Skip to content

运行镜像 ​

运行镜像就是 Agent 工作的那个容器。每一轮的沙箱都从它启动,跑在 gVisor 下,没有网络,所以仓库构建和测试要用的东西,必须已经在镜像里或者仓库里。

默认镜像 ​

基础Debian bookworm,Python 3.12
Node.js22,带 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 里容器构建通过,不能代替这一步。