SHA256
forked from course-team/tjhlp-gitea
原来 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 就报错、线上不受影响"
53 lines
3.0 KiB
YAML
53 lines
3.0 KiB
YAML
# act_runner 配置 —— 关键项都有注释, 依据是 act_runner v0.6.1 自带的 generate-config 输出。
|
|
log:
|
|
level: info
|
|
|
|
runner:
|
|
file: /data/.runner # 与 compose.yaml 的 ./data 挂载对应; 注册后保存在这里
|
|
capacity: 1 # 部署必须串行: 一次只跑一个 job
|
|
timeout: 30m
|
|
labels:
|
|
# job 跑在容器里(network: host), 镜像用 Gitea 官方 runner 镜像(实测 arm64 可用)。
|
|
# 换成 catthehacker/ubuntu:act-22.04 也可以; 记得同步 compose.yaml 的 GITEA_RUNNER_LABELS。
|
|
- "self-hosted:docker://docker.gitea.com/runner-images:ubuntu-22.04"
|
|
|
|
container:
|
|
# host: job 容器与宿主共用网络 —— verify.sh 里对 127.0.0.1:2080 的检查才有效,
|
|
# 10.80.42.185 也不需要额外放行。
|
|
# ⚠️ 这是 runner 级设置, 所以这个 runner 上的【每个】job 都共享宿主网络 —— 还没能
|
|
# 收窄的一轴(见 ci-cd.md §7 残留项)。
|
|
network: host
|
|
# ★ 不把宿主 docker socket 自动挂进 job 容器(默认行为是自动挂 = 每个 job 都能拿到
|
|
# root 等价能力)。改成"要用 docker 的 job 自己申报", 并受下面的白名单约束。
|
|
docker_host: "-"
|
|
# ★ job 允许申报的挂载白名单(gobwas/glob 匹配【挂载源路径】; [] = 一个都不许, ['**'] = 全放)。
|
|
# 注意: 全局 options 里的 --volume 也过这道白名单 —— 不在表里的会被
|
|
# "[xxx] is not a valid volume, will be ignored" 直接丢弃。2026-09-21 就因为这个
|
|
# (当时 options 有挂载但白名单是默认空表)让 job 容器里看不到 /home/ymy/deploy,
|
|
# 第一步 `cd /home/ymy/deploy/tjhlp-gitea` 就失败。
|
|
#
|
|
# 表里的四项分别对应:
|
|
# /home/ymy/deploy job 里的工作目录(deploy job 申报, 可写)
|
|
# /srv/gitea 部署克隆的 origin 是这里面的本地裸库; 不挂进去
|
|
# `git fetch` 会报 "does not appear to be a git repository"
|
|
# (2026-09-21 实际踩到), 只读
|
|
# /var/run/docker.sock 部署要 `docker compose up -d`, 只给申报它的 job
|
|
# /usr/bin/docker 等 docker CLI + compose 插件, 不依赖 job 镜像里带没带
|
|
valid_volumes:
|
|
- /home/ymy/deploy
|
|
- /srv/gitea
|
|
- /var/run/docker.sock
|
|
- /usr/bin/docker
|
|
- /usr/libexec/docker/cli-plugins
|
|
# ★ 这里【故意不写】全局 options 挂载: 需要宿主路径/socket 的只有 deploy 这一个 job,
|
|
# 由它在 .gitea/workflows/deploy.yml 的 container.volumes 里自己申报(见 ci-cd.md §5.1)。
|
|
# 挂在这里等于这个 runner 上的每个 job(比如将来加的 PR 检查/测试)都白拿 socket = root。
|
|
# 另外 act_runner 会自动挂 docker.sock, 再在 options 里挂一次会以
|
|
# "Duplicate mount point: /var/run/docker.sock" 直接失败(2026-09-13 预演时实测),
|
|
# 所以 docker_host: "-" 与 job 自己申报是配套的一对改动。
|
|
force_pull: false # 镜像本地已有就不再拉
|
|
|
|
cache:
|
|
enabled: true
|
|
dir: /data/cache
|