SuperAPI AI 工具集

release

部署与运维

查看项目

更新于 10-15 22:15

技能介绍

用途:编排 OpenEnv 仓库内的部署工具,并记录 openenv 命名空间的规范化流程,把环境发布到 Hugging Face Spaces、同步集合与规范引用。

前置条件:hf CLI 已认证(hf auth login 或设置 HF_TOKEN);已安装本地构建依赖,使 scripts/prepare_hf_deployment.sh 能构建 Docker 上下文;可访问 scripts/manage_hf_collection.py。

主要流程:scripts/prepare_hf_deployment.sh 默认部署 envs/ 下所有可部署环境,可用 --env <name> 指定子集。脚本解析所需 OpenEnv ref,重写 openenv-core 依赖为 git+https://github.com/huggingface/OpenEnv.git@<resolved-ref>,构建暂存树并改写 Dockerfile(BASE_IMAGE 默认 ghcr.io/huggingface/openenv-base:latest),生成带 Hub 元数据的 README,强制 openenv/openenv-<version> 标签,并用 hf repo create/hf upload 推送。私有部署使用 <env>-0.2.2 命名与 --private。

验证:私有 Space 需通过已认证的 hf.space 域验证,可用 scripts/verify_private_spaces.py --hf-namespace openenv --suffix -0.2.2。仅凭 /health 不足;HTTP 环境至少需通过已认证的 POST /reset,必要时再做 POST /step。部分环境在 20 秒探测下会超时,应视为不确定并重试。规范 Space 可能暴露多个 READY 域,需逐一探测直至某个可用。

规范化与集合:仅当带后缀候选构建并通过健康检查时,规范引用才指向 main;失败则保持原引用并把依赖固定为 <0.2.2。成功后用 scripts/manage_hf_collection.py --version 0.2.2 --collection-namespace openenv --skip-global-collection --space-id <space> 加入版本化集合。注意仓库名与规范名不一致的情况(repl_env→openenv/repl,tbench2_env→openenv/tbench2,textarena 别名为 openenv/sudoku 或 openenv/wordle),不要凭目录名推断。

限制与提醒:发布脚本需在仓库根目录运行;私有 Space 匿名请求返回 404;出现旧 BUILD_ERROR 时可用 HfApi().restart_space(..., factory_reboot=True) 强制重建;发布后应记录通过/失败环境、归档测试后缀 Space 并保存运行时状态。以上为资料所载事实,未提供的收费、价格、平台等信息暂未提供。