# AutoDL GPU Runner Controller

该仓库只管理算力，不包含 Evidence Extractor 研究代码。控制流程运行在阿里云的常驻
`ces-control:host` Gitea Runner 上，并通过 AutoDL Pro API 创建和关闭 GPU 实例。

## 边界

- 本仓库：AutoDL Pro 生命周期、模型传输、GPU Runner 注册和产物回收。
- 阿里云：常驻控制 Runner、SigLIP2 权重以及训练产物的持久存储。
- AutoDL：临时 GPU 执行节点。
- 研究仓库：训练代码、配置和 Gitea Actions workflow 的唯一来源。

## Repository Secrets

在本仓库 `Settings → Actions → Secrets` 配置：

- `AUTODL_API_TOKEN`：AutoDL 控制台的开发者 Token。
- `TRAINING_RUNNER_REGISTRATION_TOKEN`：研究仓库 `Create new Runner` 页面显示的
  Registration Token。

Secret 只注入阿里云控制任务，不落盘、不打印。AutoDL SSH 私钥保存在阿里云
`/root/.config/ces-controller/autodl_ed25519`，不进入 Gitea。

## 首次启动

阿里云需要先作为本仓库的常驻 Runner 注册一次，且只使用标签：

```text
ces-control:host
```

该 bootstrap 使用的是“本控制器仓库”的 Runner Registration Token，不是 Secret 中用于
AutoDL GPU Runner 的 `TRAINING_RUNNER_REGISTRATION_TOKEN`。

Runner online 后，第一次 push 只执行 `Controller CI`，不会创建实例或产生 AutoDL 费用。

## 管理 workflow

从 Actions 手动运行 `Manage AutoDL GPU runner`：

- `discover`：列出可供 API 使用的私有镜像，不产生 GPU 费用；
- `provision`：创建 PRO6000、传输模型并注册 GPU Runner；必须填写镜像 UUID，并把确认值
  填为 `CREATE`；
- `status`：查询实例和 Runner 进程状态；
- `shutdown`：回收训练产物并关闭实例，不释放系统盘。

`provision` 在创建实例前会检查 SigLIP2 的两个权重分片是否完整、AutoDL SSH 私钥权限是否为
`0600`，并预下载及校验 `gitea-runner`。任何配置失败都会尝试关闭刚创建的实例，避免继续计费。

控制器固定使用官方 `gitea-runner 3.5.0` Linux AMD64 二进制及其 SHA-256，下载和校验均在
创建付费实例之前完成。

AutoDL GPU Runner 注册为 host runner，并提供：

```text
ubuntu-latest:host
ces-ci:host
gpu:host
```