Files
Yoko cf0f437d97 优化宿主环境并发调度,增加生命周期诊断和容器日志 (#1560)
* 分离环境操作与巡检并增加宿主生命周期诊断命令

* 支持按宿主配置操作和巡检并发并默认使用十个操作名额

* 缩短环境调度锁持有时间并限制任务执行时长

* 支持按环境将 runtime 标准输出和错误写入容器日志
2026-11-19 18:23:23 +08:00
..

monkeyai-engine

云端执行环境的宿主管理程序。安装/升级由统一 installer 执行;engine 负责签名预检上报,以及本地 Docker/gVisor 生命周期驱动、普通目录持久存储与资源限制。已接入后台调度、客户端创建接口和 standalone 编排,真实工作负载统一留待人工验收。安装和发行见安装说明,本地操作入口和实现边界见环境执行层。

构建与检查

需要 Go 1.27:

make check
make build
make linux

bin/monkeyai-engine 使用当前平台,make linux 生成 Linux AMD64 和 ARM64 二进制。ARM64 用于原生开发验证,不代表 AMD64 生产基线已经验收。

宿主预检

sudo ./bin/monkeyai-engine doctor \
  --architecture amd64 \
  --data-dir /var/lib/monkeyai-engine \
  --docker-socket /var/run/docker.sock

输出单个 JSON 报告,检查 Linux、架构、cgroup v2 控制器、Docker API、runsc runtime、nftables、IPv4 转发、Unix socket、数据目录,不检查文件系统项目配额。

预检只读取状态,不创建目录、不安装软件、不格式化磁盘、不改变配额,不连接后台。每个外部程序有超时和输出上限;总期限 45 秒。

退出码:

  • 0:检查的前置条件满足。
  • 1:前置条件未满足或检查失败,具体结果见 JSON。
  • 2:参数错误。

prerequisites_met 只表示前置条件,workload_verified 当前始终为 false。控制器存在不等于额度已落实到沙箱。节点实际执行能力还需验证资源创建、网络策略、持久化、gVisor 进程限制以及真实 runtime。

数据目录要求是已经准备好的、非符号链接的受限目录。持久数据使用普通目录,不实施容量或 inode 配额,也不要求 XFS/ext4 配额或独立镜像。CPU、内存、进程数及临时 tmpfs 限制继续生效,详见安装说明。

预设校验

./bin/monkeyai-engine validate-preset --file /path/to/preset.json

预设协议版本 version=1,revision 表示管理员发布的不可变修订。字段如下:

字段 要求
id、revision、name 预设标识、正整数修订和显示名称
image 完整仓库路径及固定 @sha256: 摘要
architecture、driver amd64/arm64,首期只接受 gvisor
network_policy 宿主管理维护的策略标识,不允许传入任意规则
runtime、task_engine 包含 path/version/sha256,路径在只读发行目录 /opt/monkeyai/ 内
resources 下列所有数值必须显式提供,不使用隐式无限额默认值

资源字段为 cpu_millis、memory_bytes、workspace_bytes、home_bytes、runtime_bytes、volume_inodes、temporary_bytes、sandbox_tasks。其中持久目录容量与 inode 字段仅兼容旧预设,可省略,不作为磁盘限额;临时目录预算包含在环境总内存内。

拒绝重复 JSON 字段、大小写别名、未知字段、尾随 JSON、浮动镜像、无校验和发行包、隔离降级、路径穿越、负数、超范围资源和无界任务数。文件上限 64 KiB。

静态校验不拉取镜像、不校验发行包的实际字节,也不检查网络策略是否已安装。image_verified 和 workload_verified 在结果中明确为 false;实际启动前必须由驱动完成对应验证,不能凭静态校验成功接收用户任务。

本地生命周期协调器

internal/lifecycle 已接入命令入口与宿主目标同步,提供驱动边界 Prepare/Create/Start/Stop/Inspect/Remove。状态采用原子 JSON 文件保存;同代次规格冲突和旧代次会被拒绝,启动失败代次不会自动重启。启动、停止和删除依赖驱动查询确认;停止只清理实例资源,持久卷由独立存储层管理,停止和实例删除均保留数据。

单元测试通过内存驱动验证生命周期及创建后检查点写入失败的恢复。已接入跨进程锁、调度代次、取消旧目标、完整持久卷、签名宿主协议与网络协调。running 只指驱动观测,不表示 runtime 或中转可连接。

已提供 Docker/gVisor 驱动;真实 Linux 宿主的镜像摘要、cgroup、网络隔离和持久目录权限仍需统一验收。公网配置见 网络说明。

状态与后续

本分支的实施状态见云环境实施记录,安装器历史见安装实施计划。apps/runtime 保持不修改,已通过现有 standalone CLI 接入登录、状态读取和启动,详见 运行时编排。

宿主运维可运行 monkeyai-engine cache inspect/cache gc 核对镜像缓存,配置和回收边界见 缓存治理。沙箱固定 512 个任务(含线程),与宿主 host_tasks 资源分开。