SHA256
forked from course-team/tjhlp-gitea
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:
+31
-6
@@ -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。
|
||||
|
||||
Reference in New Issue
Block a user