AgentENV快照完全指南：如何实现沙箱毫秒级恢复与并行分叉

AgentENV快照完全指南如何实现沙箱毫秒级恢复与并行分叉【免费下载链接】AgentENVAgentENV (AENV) is a distributed platform for running agent environments at scale.项目地址: https://gitcode.com/gh_mirrors/age/AgentENVAgentENV简称 AENV是一个用于大规模运行 Agent 环境的分布式平台其核心能力之一就是沙箱快照把运行中沙箱的内存与文件系统状态在 100 毫秒内增量捕获之后既能毫秒级恢复出完全相同的环境也能从一个运行环境并行分叉出多个独立沙箱支撑大规模并行 Agent 工作流。本指南面向新手带你从零理解快照的原理、创建、恢复与分叉全流程。一、快照是什么给沙箱拍一张活照片 AgentENV 中的快照Snapshot是沙箱的可复用检查点。与普通备份不同它冻结的是活的运行状态VM 状态与内存正在运行的进程可以从捕获点继续执行而不是从头启动根文件系统及其后续所有修改附加磁盘与挂载卷的内容、挂载路径、大小和访问模式运行配置CPU、内存、磁盘规格以及环境变量、工作目录、用户、启动命令等上下文官方概念文档对这一点的描述见 snapshots/index.md。 一个类比模板Template本质上就是快照。模板构建会提交一个快照模板 ID 只是指向它的一个别名。关键性能数字根据项目文档 overview.md 的说明操作耗时基于快照启动或恢复环境 50 毫秒暂停pause环境 100 毫秒增量快照捕获含磁盘重写入场景 100 毫秒这背后是 AENV 的两个设计内存和文件系统变更采用增量捕获空闲环境可随时释放 CPU 和内存有新任务到来时再毫秒级复活让闲置环境几乎不花钱。二、快照保留了什么、没保留什么创建快照后你可以用两种方式复用方式说明适用场景aenv start 快照完整恢复文件系统、进程、内存、环境变量、资源配置全部继承需要原地续跑的任务导出为 OCI 镜像冷启动只保留根文件系统不保留内存与进程状态只想要干净的文件系统起点如果只需要捕获的根文件系统AgentENV 支持在创建快照时自动发布 OCI 镜像针对 OSS 后端 OverlayBD 原生镜像场景详见 snapshots/use.md。三、从运行中沙箱创建快照3 行命令搞定这是全文最关键的一步命令只有这么长文档snapshots/create.md# 基本用法捕获指定沙箱的当前状态 aenv snapshot create sandbox-id # 推荐附上一个易读的别名 aenv snapshot create sandbox-id --name my-checkpoint两个要点源沙箱不会被打断——捕获完成后它继续运行快照是旁路复制的状态别名可省略——不写--name时命令会返回生成的快照 ID之后用它同样有效创建之后用下面命令随时启动一个继承全部快照状态的新沙箱aenv start my-checkpoint # 或aenv start snapshot-id这会创建一个拥有全新 sandbox ID的独立沙箱。快照的日常管理aenv snapshot list # 列出所有快照 aenv snapshot list --sandbox-id id # 只看某沙箱产生的快照 aenv template delete snapshot-id # 删除快照快照与模板共用目录CLI 完整说明见 aenv-cli/snapshots.md。四、并行分叉一个沙箱变 N 个沙箱 分叉Fork是快照机制最杀手级的用法把一个运行中的沙箱克隆成多个独立子沙箱用于并行 Agent 工作流。工作机制文档sandboxes/working.md源沙箱短暂暂停捕获一份状态源沙箱随即恢复 Running所有子沙箱共享这同一份捕获状态但彼此完全独立——每个子沙箱可以成功或失败互不影响子沙箱继承源沙箱的文件系统、内存、网络策略、安全模式与 CPU/内存/磁盘配置分叉通过 API 一次最多创建100 个子沙箱curl -X POST \ -H X-API-Key: test-key \ -H Content-Type: application/json \ -d {count: 3, timeout: 600} \ http://127.0.0.1:8000/sandboxes/sandbox-id/fork请求中的count指要创建的数量默认 1timeout是子沙箱的存活时间默认继承源沙箱 TTL。响应数组会逐一给出每个子沙箱的sandboxID或失败原因。挂载卷如何跟随分叉与快照如果你担心数据卷会被分叉搅乱官方文档 sandbox-forks-and-snapshots.md 给出了明确答案全程无需手动操作分叉时每个exclusive独占卷自动做一次独立的写时复制COW分叉子沙箱改自己的副本互不干扰ro只读卷则继续共享同一个只读卷快照时所有挂载卷自动纳入快照记录层、大小、挂载路径和访问模式从快照启动时会按捕获内容创建新卷并挂到相同路径五、快照数据存在哪里三层存储模型理解持久化机制才能放心把生产任务交给快照。AENV 的快照数据经过三层文档persistence-artifact-inventory.md构建暂存区捕获进行中的临时工作空间不是最终记录已提交快照仓库真正的持久事实源保存目录、别名、snapshot.json、VM 状态等暴露给 API节点本地运行缓存启动前物化出可运行的image.json等派生文件可随时从已提交状态重建已提交的快照可持久化到S3 兼容对象存储或共享分布式文件系统即使节点故障数据也不会丢。用 P2P 加速节点间分发 多节点集群中新提交的快照可以在节点间互相借而不用都回源到对象存储。只需在配置文件中开启文档snapshots/p2p.md[p2p] enabled true [snapshot] p2p_enabled true注意P2P 只是可选的分发加速路径快照仓库始终是持久事实源。六、实战场景暂停-恢复让闲置环境近乎免费除了快照AENV 还提供与之配套的pause/resume能力二者常组合使用aenv pause sandbox-id # 保存状态并停止 microVM释放 CPU 与内存 aenv resume sandbox-id # 从保存点恢复进程从原处继续暂停时程序不运行、服务不处理请求但状态完整留在存储里之后aenv connect连接暂停的沙箱还会自动恢复它。典型用法构建好开发环境 →snapshot create存成检查点任务跑完pause释放资源新任务来了从快照秒级start出新沙箱或resume老沙箱需要并行实验时直接对运行中的沙箱fork出 N 份七、快速避坑清单 ✅问题答案快照会中断源沙箱吗不会捕获后源沙箱继续运行删除源沙箱会影响快照吗不会已创建快照独立存在卷快照同理删除源卷不影响已提交数据从快照启动的沙箱和源沙箱是同 ID 吗不是会分配全新的 sandbox ID分叉最多能分多少个单次请求最多 100 个子沙箱只想拿文件系统不要内存状态怎么办将快照 rootfs 导出为 OCI 镜像后aenv start --cold image冷启动总结AgentENV 的快照体系可以用三句话概括100 毫秒内增量捕获、50 毫秒内恢复、一次分叉最多 100 份并行沙箱。它把环境准备这一通常最耗时的环节变成了近乎零成本的操作——无论是并行强化学习训练、批量实验还是弹性伸缩快照与分叉都是你在大规模 Agent 平台上最重要的两个杠杆。建议阅读顺序快照概念总览 → 创建快照 → 沙箱分叉 → P2P 加速。【免费下载链接】AgentENVAgentENV (AENV) is a distributed platform for running agent environments at scale.项目地址: https://gitcode.com/gh_mirrors/age/AgentENV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考