# 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