fix(ci): 收窄 runner 的宿主能力 —— 由 deploy job 自己申报挂载

原来 runner 用 container.options 把 docker.sock / 部署克隆 / 裸库 / docker CLI
全局挂给【每个】job。这个 runner 上的任何 workflow(以后加的 PR 检查、测试)都因此
白拿 docker = root 等价能力。

改成:
  * container.docker_host: "-"  → 不再自动把 socket 挂进 job 容器
  * 删掉全局 container.options 挂载
  * 五项挂载(socket/部署克隆/裸库/docker CLI/compose 插件)由 deploy job 在 workflow
    的 container.volumes 里自己申报
  * 五项仍列在 container.valid_volumes 白名单里(不在表里的申报会被静默丢弃)

效果: 不申报的 job 默认是裸容器(实测看不到 /home/ymy/deploy 与 /srv/gitea)。

验证边界(诚实记录):
  * Gitea 侧确认会把整个 job 的 YAML(含 container:)作为任务载荷发给 runner
    —— services/actions/run.go 里 payload, _ := v.Marshal()
  * act 侧确认会采纳 job 申报的 volumes —— act_runner exec 实测
  * 但 `act_runner exec` 有自己的 --container-daemon-socket 默认值、也不读配置里的
    valid_volumes/docker_host, 所以这两项只能靠一次真实运行确认; 失败模式是
    "第一步 cd 就报错、线上不受影响"
This commit is contained in:
2026-09-22 20:12:57 +08:00
parent 99547005bd
commit 7ff17f8b2a
4 changed files with 210 additions and 96 deletions
+31 -6
View File
@@ -197,15 +197,40 @@
> sudo rm -rf customization/custom/options # 空的 root 目录, 删掉即可
> ```
>
> **⚠️ 8. act_runner 的 job 容器不要自己挂 `docker.sock`。**
> act_runner 会把 docker daemon socket **自动**挂进 job 容器(`container.docker_host` 的默认
> 行为); 再在 `deploy/runner/config.yaml` 的 `container.options` 里挂一次, 第一次真实部署
> 就会以这个错误告终:
> **⚠️ 8. `docker.sock` 怎么挂:`docker_host: "-"` 与"job 自己申报"是配套的一对。**
> 默认行为是 act_runner 把 docker daemon socket **自动**挂进 job 容器 —— 等于这个 runner 上的
> **每个** job 都白拿 docker(= root 等价)。现在把这份能力收窄成"要用 docker 的 job 自己申报":
> ```yaml
> # deploy/runner/config.yaml —— runner 侧: 不自动挂, 并给申报加白名单
> container:
> docker_host: "-" # 自动找 daemon, 但不挂进 job 容器
> valid_volumes: [...] # job 申报的挂载必须在这个表里
> ```
> ```yaml
> # .gitea/workflows/deploy.yml —— job 侧: 只给需要它的那个 job
> container:
> volumes:
> - /var/run/docker.sock:/var/run/docker.sock
> ```
> ⚠️ **两者必须成对**: 只写 `volumes` 而没有 `docker_host: "-"`, 就会和自动挂载撞成
> ```
> failed to create container: 'Duplicate mount point: /var/run/docker.sock'
> ```
> 2026-09-13 用 `act_runner exec` 预演 job 时提前发现。`container.options` 里只保留
> 部署克隆(同路径)、宿主 docker CLI、compose 插件这三项。
> (2026-09-13 用 `act_runner exec` 预演时第一次踩到。注意 `exec` 有自己的
> `--container-daemon-socket` 默认值、**不读**配置里的 `docker_host`, 所以用 exec 预演时
> 这个错会一直出现 —— 它验证不了这一项。)
>
> **⚠️ 10. `valid_volumes` 会静默丢掉挂载。**
> job 申报的 `container.volumes`(以及全局 `options` 里的 `--volume`)都必须出现在
> `container.valid_volumes` 里, 否则 act_runner 只打一行
> `... is not a valid volume, will be ignored` 就把它丢掉, **job 照常往下跑** —— 现象是容器里
> 少了个目录, 而不是报错。2026-09-21 就因此让部署 job 的
> `cd /home/ymy/deploy/tjhlp-gitea` 失败。排查两行命令:
> ```bash
> docker exec gitea-runner sed -n '/valid_volumes/,+6p' /config/config.yaml
> docker inspect $(docker ps -q --filter name=GITEA-ACTIONS) \
> --format '{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"\n"}}{{end}}'
> ```
>
> **⚠️ 9. 宿主 `/usr/bin/python3` 是 3.6, 别让它排到 PATH 前面。**
> `customization/build.py` 用了 `from __future__ import annotations`, 需要 ≥3.7。