wangjia
034a585e3b
ci-pangolin / Lint — shellcheck (pull_request) Successful in 5s
ci-pangolin / OpenAPI Sync Check (pull_request) Successful in 17s
ci-pangolin / Redline Scan — 脱敏 (UI 文案) (pull_request) Successful in 6s
ci-pangolin / Flutter — analyze + test (pull_request) Successful in 39s
ci-pangolin / Portable SQL — 可移植性 (mysql/sqlite) (pull_request) Successful in 5s
ci-pangolin / Codegen Drift — token 生成物未漂移 (pull_request) Successful in 5s
ci-pangolin / Go — build + test (pull_request) Successful in 2m5s
ci-pangolin / E2E Smoke — L4 进程级端到端 (pull_request) Successful in 2m13s
ci-pangolin / Golden — 视觉回归 (components + auth) (pull_request) Successful in 31s
记录 pangolin CI 的 self-hosted runner:决定保留 1 个(mac-pangolin-2,项目级、 mac host 模式、label nas、复用 jiu 的 relay 13000),含 config、为何 host+mac、 relay 原因、已删 orphan(mac-pangolin id5)的清理命令、持久化(launchd)TODO。 登记进 docs/index.html。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
3.3 KiB
3.3 KiB
Pangolin CI Runner 记录
gitea Actions self-hosted runner 设置记录。CI 工作流见
.gitea/workflows/ci.yml(9 个 job)。
决定:用 1 个 runner
| 项 | 值 |
|---|---|
| 名称 | mac-pangolin-2(gitea id 6) |
| 级别 | 项目级(绑 wangjia/pangolin,只服务本仓库) |
| 机器 | mac 本机(/Users/wangjia/bin/act_runner v0.6.1) |
| 执行模式 | host(非容器) |
| label | nas(即 runs-on: nas) |
| 连接 | 经 jiu 的 TCP relay 127.0.0.1:13000 → NAS gitea 192.168.3.200:3000 |
为什么是 host 模式 + mac
- ci.yml 的 9 个 job 全是 docker-in-docker(每个 job 内部
docker run …拉 golang/flutter/redis 等镜像)。container 模式(像 jiu 的ubuntu-latest:docker://catthehacker)在非特权容器里跑不了 DinD,所以必须 host 模式。 - mac 的 Docker Desktop 能跑 Linux 容器,host 模式下
docker run <linux-image>可用。 - 理想归宿其实是 NAS(Linux)host runner(给 NAS 现有 runner 加
nas:hostlabel),mac 只是当前落点。
为什么要 relay(13000)
mac 上的 Shadowrocket 网络扩展会拦截 act_runner 这个 Go 二进制的流量,直连 NAS gitea 失败。jiu 已有一个常驻 python TCP relay(~/bin/tcp_relay.py,127.0.0.1:13000 → 192.168.3.200:3000),act_runner 连本地 relay 绕过。pangolin runner 复用这个 relay。
配置文件:~/.act_runner_pangolin2_config.yaml
log:
level: info
runner:
file: /Users/wangjia/.act_runner_pangolin2 # 注册凭证(.runner),勿入 git
capacity: 1
timeout: 3h
labels:
- "nas:host"
cache:
enabled: true
host:
workdir_parent: /Users/wangjia/.cache/act-pangolin2
当前运行方式(临时,非持久)
export PATH="/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
/Users/wangjia/bin/act_runner daemon --config /Users/wangjia/.act_runner_pangolin2_config.yaml
⚠️ 当前是后台进程,mac 重启就没了。要持久化见下「持久化 TODO」。
已删除:mac-pangolin(第一次注册的,id 5)
第一次注册的 runner(label nas,config ~/.act_runner_pangolin_config.yaml)。job 调试时已从 gitea 删除注册(API DELETE,204)。本机残留待清:
# orphan daemon 进程(拿不到任务、空转报 "unregistered runner",无害但占进程)
pkill -f 'act_runner_pangolin_config.yaml' # 只匹配 orphan,不碰 -2 和 jiu
# orphan 文件
rm -f ~/.act_runner_pangolin ~/.act_runner_pangolin_config.yaml
rm -rf ~/.cache/act-pangolin
持久化 TODO(让 runner 开机自启、不随 session/重启消失)
仿 jiu 的 com.jiu.act-runner(launchd + relay-aware start script):
- 写 start 脚本(确保 relay 13000 在 → 起 daemon),仿
~/bin/act_runner_start.sh。 - 写
~/Library/LaunchAgents/com.pangolin.act-runner.plist(RunAtLoad + KeepAlive)。 launchctl load ~/Library/LaunchAgents/com.pangolin.act-runner.plist。- 加载前先停掉当前临时 daemon:
pkill -f act_runner_pangolin2_config.yaml。
或者换路线:在 NAS 上给现有 runner 加
nas:hostlabel + 重启,把 pangolin CI 迁到 NAS(Linux,更稳),mac 这个就可退役。
验证
- gitea → 仓库 Settings → Actions → Runners 应只见 mac-pangolin-2(online)。
- 向
main开 PR 触发 9 个 job;首次全绿见 run #298(commit65bd7c3)。