用途:撰写或修正 Chefer 的 appcipe.yml「食谱」,用一个或多个 Docker/OCI 映像与执行参数,经 chefer build 打包成单一可执行档,执行时不需装 Docker 或容器引擎。流程为 docker build/pull 后 docker save 取 image tar,写 appcipe.yml,再 chefer build appcipe.yml --out dist。
主要能力:顶层字段含必填 version(固定 "0.1")、name 及 app_version、old_names、data_dir、crash、network、console、services。服务层支持 image(tar/registry ref/Dockerfile 三种 source)、cmd、workdir、env、persist_path、ports、mounts、interface_mode、depends_on、healthcheck、gpu。网络默认 bridge,服务间用 127.0.0.1:<port>;只有列入 ports 的埠才对 host 暴露,internal 无对外网络,shared 才共享 host 网络。gpu 为 opt-in,可在原生 Linux 与 Windows WSL2 做 passthrough。
使用方式:改完必须执行 cargo run -p chefer-cli -- check <appcipe.yml> 验证,会列出全部错误。权威规则见 crates/appcipe-spec/src/validate.rs,契约见 docs/DESIGN.md §3/§6,范例见 examples/appcipe.yml 与 examples/demo/。
限制:registry ref 须钉版(tag 或 @sha256),latest 或未带 tag 会被拒绝;私有 registry 认证暂未支援,可用 docker pull 加 docker save 走 tar。format 用连字號 docker-archive/oci-archive。healthcheck 启动目前串行化。gpu 卡索引硬隔离仅原生 NVIDIA 有效。部分官方映像 entrypoint 会 chown/gosu,在无委派环境可能启动失败。资料未提供收费、价格等资讯。