AgentENV模板完全指南aenv pull与aenv build两种方式实战对比快速搭建AI Agent运行环境【免费下载链接】AgentENVAgentENV (AENV) is a distributed platform for running agent environments at scale.项目地址: https://gitcode.com/gh_mirrors/age/AgentENVAgentENV (AENV)是一个用于大规模运行 AI Agent 环境的分布式沙箱平台而**模板Template**是它的核心概念一次构建、处处复用用一条命令就能拉起配置完全一致的沙箱实例。创建模板有两条路径——aenv pull直接导入现成的 OCI 镜像aenv build则用 Dockerfile 现场构建。本文带你用两种实战方式快速上手并通过对比表格帮你做出正确选择 什么是 AgentENV 模板模板是启动沙箱的可复用起点。它的生命周期非常直观OCI 镜像→aenv pull→ 就绪的模板Dockerfile→aenv build→ 就绪的模板就绪的模板 →aenv start→ 运行中的沙箱模板是 API 与用户体验层底层则是一层持久的快照Snapshot每次模板构建发布一个已提交的快照模板 ID 或别名解析到该快照由模板创建沙箱时即从该快照恢复。详见官方文档 concepts/templates/index.md。方式一aenv pull —— 一行命令导入现成镜像如果你已经有一个可用的 Docker/OCI 镜像比如ubuntu:24.04或某个 Python 运行时镜像aenv pull是最快的选择aenv pull ubuntu:24.04 aenv pull ubuntu:24.04 --name my-base核心特性参数说明--name name指定易记的模板名默认取镜像仓库名--cpu/--memory设置模板的 vCPU 数与内存MiB--start-cmd cmd在快照捕获前运行的启动命令--ready-cmd cmd每 2 秒轮询一次的就绪检查命令--probe port等待localhost:port可建立 TCP 连接与--ready-cmd互斥-d, --detach提交后立即返回不等待构建完成--timeout secs限制 CLI 等待构建的时长几个实用技巧命名习惯不指定--name时AgentENV 会自动取镜像名去掉 tag 后的仓库段作为模板名任何接受模板 ID 的地方都可以直接用这个名字。就绪探测如果镜像里有需要自启动的服务用--start-cmd启动它、再配--probe 8000之类端口探测就能确保服务就绪后才快照。异步构建加上--detach后立即返回稍后用aenv template watch跟踪进度。命令实现位于 pull.rs它向服务端提交CreateTemplateV3请求并携带from_image字段触发构建。方式二aenv build —— 用 Dockerfile 从零构建没有现成镜像aenv build会在一个临时 microVM 内部用 BuildKit 构建 Dockerfile然后把结果转换为 OverlayBD 格式并捕获为模板。亮点是CLI 所在机器上完全不需要 Docker 和 staging 镜像仓库构建在隔离的微虚拟机里完成 aenv build . --name my-app # 指定自定义 Dockerfile aenv build . -f deploy/docker/Dockerfile.agentenv --name aenv核心特性参数说明--name name必填模板名称-f, --file pathDockerfile 路径默认context/Dockerfile--build-arg KEYVALUE构建参数可重复--secret specBuildKit 原生 secret 挂载例如idtoken,src./token--no-cache不使用缓存指令重建--start-cmd/--ready-cmd覆盖镜像的ENTRYPOINT/CMD与HEALTHCHECK--progress auto\|plain\|tty构建进度显示格式--timeout secs构建截止时间默认 3600 秒构建与就绪判定规则值得注意COPY/ADD从 context 目录解析与 Dockerfile 位置无关支持多阶段构建、.dockerignore、cache mounts 等标准语法。默认用镜像的ENTRYPOINT/CMD作为启动、Dockerfile 里的HEALTHCHECK作为就绪检查用--start-cmd --ready-cmd true可以完全跳过应用启动只做裸镜像捕获。每节点最多允许max_concurrent_builds个受管构建容量不足时返回 HTTP 429稍后重试即可。服务端配置示例见 internals/buildkit-template-builds.md。CLI 侧实现位于 build.rs。aenv pull 与 aenv build 实战对比对比维度aenv pullaenv build输入已发布的 OCI 镜像引用本地 context 目录 Dockerfile构建方式服务端直接导入镜像临时 microVM 内 BuildKit 构建 OverlayBD 转换依赖无本地依赖CLI 机器无需 Docker构建参数/secret❌ 不支持✅--build-arg、--secret缓存控制不涉及✅ BuildKit 持久化构建缓存启动命令来源需显式--start-cmd自动读取ENTRYPOINT/CMD就绪检查来源--ready-cmd/--probe自动读取HEALTHCHECK默认超时无超时3600 秒适用场景现成镜像、快速起步、CI 中复用自定义依赖、多阶段构建、需要 secret 的场景一句话总结有现成镜像用pull最快要定制环境、装依赖、跑编译步骤就用build。监控与管理模板跟踪构建进度aenv pull默认会等待模板就绪若用--detach提交可随时用模板名或 ID 观察aenv template watch my-templatewatch会实时打印四种状态waiting排队中、building构建中、ready成功、error失败并给出原因。按Ctrl-C只是停止本地观察远端构建会继续执行。状态轮询逻辑见 template.rs。日常管理三板斧aenv template list # 别名: aenv template ls aenv template list --output json aenv template delete my-ubuntu # 别名: aenv template rmlist会展示每个模板的 ID、名称、构建状态、CPU、内存、磁盘大小与最近更新时间。更多管理细节构建历史、别名解析见 managing.md。如何选择场景速查要快官方/第三方镜像 →aenv pull一行命令拿到可用模板要定制需要装私有依赖、编译、注入 secret →aenv build⏱️构建耗时两者都建议--detach提交后用aenv template watch跟踪注意pull保留源镜像配置build的运行时配置来自最终 Dockerfile 阶段ENV/WORKDIR/USER等指令会直接影响每个沙箱默认的资源规格vCPU、内存来自服务端配置 default.toml 的[machine]段可按需通过--cpu/--memory覆盖。延伸阅读模板概念总览docs/src/concepts/templates/index.md创建模板完整参数表docs/src/concepts/templates/creating.mdBuildKit 构建内部机制缓存、发布、恢复docs/src/internals/buildkit-template-builds.mdCLI 命令速查docs/src/getting-started/aenv-cli/templates.md快照机制docs/src/concepts/snapshots/index.md掌握aenv pull和aenv build之后你已经可以覆盖绝大多数 Agent 环境构建场景——从快速验证到生产级自定义模板一条命令起步秒级拉起沙箱。【免费下载链接】AgentENVAgentENV (AENV) is a distributed platform for running agent environments at scale.项目地址: https://gitcode.com/gh_mirrors/age/AgentENV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考