modelhub-engine-bi150-compat/docs/upload-runbook.md

建仓、打 Tag、选用引擎（人工）

本仓没有自动提交命令。CI 构建镜像、在凭据齐全时推送，并把镜像注册到 image-verify。注册只是让适配页能看到这个引擎，不等于代领或代提交适配任务。

积分：待平台核实。

1. 在 Gitea 建仓

1. 在模盒的 Gitea 上新建仓库，名称建议 modelhub-engine-bi150-compat。
2. 把本目录推上去。不要提交 .env、密钥或 Token。
3. 确认默认分支上有 Dockerfile、.gitea/workflows/build.yml 和 .gitea/workflows/task_info.env。

2. 打 Tag

CI 在 v* 标签上触发，例如 v0.1.0。

git tag v0.1.0
git push origin v0.1.0

标签名会成为镜像标签。

3. 看 CI

流水线顺序：Clone → Load task info → Validate Image Verify Metadata → Build image → Push → Notify Image Verify。

1. 打开该 Tag 的 Actions / 流水线。
2. Load task info 应打印 FRAMEWORK=vllm_bi150_r2r4 和 GPU_TYPE=Iluvatar_bi-150。
3. Validate Image Verify Metadata 在构建前 GET adminApi/image-verify/validate，校验 gpuType 与 taskType。缺 FIXED_TOKEN 这步直接失败。
4. Build image 执行 docker build。基线镜像拉取失败时，日志会停在构建步骤；无卡不能代替真机验证。
5. Push 需要 DOCKER_REGISTRY、DOCKER_USERNAME、DOCKER_PASSWORD。缺任意一项就打印 build-only 并成功结束，不推送。
6. Notify Image Verify 只在推送成功后 POST adminApi/image-verify，把 framework、gpuType、imageUrl、taskType、createBy、repoUrl、tag 注册上去。build-only 时跳过，因为没有真实 imageUrl。
7. FIXED_TOKEN 与 Harbor 密码都由 Runner 注入，不写进仓库，也不在日志里打印。打新 Tag 前先确认旧 Harbor 密码已轮换。

旧 Tag 不会自动补注册。v0.1.0 没有 Notify 步骤，必须打新 Tag 重跑。

4. 在模盒选用引擎

1. 用浏览器登录模盒。
2. 在适配任务的引擎下拉里确认能看到 vllm_bi150_r2r4，且开发者 / createBy 是 VC_noSugar（或页面等价展示）。如果看到的是别人的名字，说明 FRAMEWORK 又撞名了。
3. 等镜像审核通过。审核状态由人在页面上确认。
4. 在适配任务里选用该引擎。本仓不代为创建或提交任务。可用 Qwen/Qwen2.5-0.5B-Instruct（Qwen2ForCausalLM，在 R4 白名单内）只做下拉可见性抽检。
5. 把审核通过时间、镜像 tag、imageUrl、以及首次被选用的适配任务 ID 写入 docs/evidence.md。积分栏保持「待平台核实」。

字段以登录后的控制台为准。