按 deploy/ci-cd.md 方案把除推送触发之外的东西都准备好: - customization/check.sh <base-url>: 把 preview.sh check 里的"定制生效"断言抽成 任意实例可跑的脚本(首页/页脚/meta/官网链接/登录页两张卡/无通行密钥方框/ 无「工单」/无 example.com), 另加生产才有的 OIDC 入口 307 断言(404 = 认证源没注册上)。 实测对生产 17/17 通过。 - deploy/scripts/auto-deploy.sh: build.py -> compose up -d -> verify.sh + check.sh, 失败自动回滚到 deploy/.state/last-deployed; flock 串行; 结束时把 clone 所有权还给 ymy(job 容器里是 root); 内网验证强制不走代理。 - deploy/runner/{compose.yaml,config.yaml,.env.example}: act_runner v0.6.1 跑在容器里 (不需要 root), network: host + 同路径挂载部署克隆 + 宿主 docker CLI/compose 插件, capacity 1 保证部署串行。 - .gitea/workflows/deploy.yml: push main + workflow_dispatch, [skip deploy] 跳过, concurrency 串行, 只做"同步到 github.sha + 调 auto-deploy.sh"。 - .gitignore: deploy/.state/、deploy/runner/{.env,data/}。 依据见 deploy/ci-cd.md(含全部实测证据与待确认项)。
之前测的是错的: 我把 --noproxy '*' 和 -x 一起传给 curl, 等于把要测的代理关掉了, 再叠加当时的一过性网络抖动, 得出了"宿主与容器都上不了外网"的错误结论。重测(2026-09-13): - 宿主: 国内直连 200, 境外经 127.0.0.1:7890 代理 200; - 容器: 直连 dl.gitea.com 200 / api.github.com 200 / codeload 301 (仅 github.com 主站直连会超时), 即容器本来就有网, 不需要代理; - docker daemon 已配代理(/etc/systemd/system/docker.service.d/http-proxy.conf), 镜像拉取正常: gitea/act_runner:latest 拉到 arm64 v0.6.1(69.3MB), docker.gitea.com/runner-images:ubuntu-22.04 等 job 镜像 manifest 均可取; - 用 act_runner 镜像自带的 generate-config 确认了两个关键能力: label 支持 ":host"(宿主模式), container.network 支持 "host"。 据此重写 deploy/ci-cd.md: - 主方案改为标准做法: runner 用 gitea/act_runner 容器 + compose 管理, job 跑在容器里(network: host, 同路径挂载部署克隆与 docker.sock), 全程不需要 root(ymy 在 docker 组); 宿主二进制 + host 模式降为备选 B - 去掉了"离线"带来的一堆绕路(一次性下载二进制、不能写 uses: 等); 不写 uses: 仍保留, 但理由改成"本项目不需要 + 避开 github.com 主站直连超时", 并给出需要时的 github_mirror / 代理两条路 - 待确认项从 6 条缩到 3 条实质问题(fork PR 审批、job 镜像工具、workflow 语法支持面) 同时修正 compose/README/.env.example 里"容器上不了外网"的措辞: 默认不用代理的真正理由是"容器直连就通、且宿主 7890 只监听回环容器不可达", 而不是"外网不通"。显式空值挡 compose 自动注入的结论不变。
只写方案, 不落地(workflow 以代码块形式放在文档里, 避免没有 runner 时 push 触发一直挂在"等待 runner")。 要点(都基于本机实测 + 1.27.3 源码): - runner 必须是"宿主上的 act_runner 二进制 + host 模式": 离线环境下容器模式 既拉不到 job 镜像, 镜像里也没有 python3/git/docker CLI; host 模式下 job 直接 以 ymy 在宿主执行, 路径/工具全现成 - 工作流不写 uses:: DEFAULT_ACTIONS_URL 默认指向 github.com, 离线拿不到 actions/checkout; 同步代码用 run: 里的 git - 免凭据: 从 /srv/gitea/git/repositories/course-team/tjhlp-gitea.git 直接 fetch (实测 git -c safe.directory 对本机 git 无效, 必须写进配置文件) - 部署逻辑放 deploy/scripts/auto-deploy.sh(可版本化/可手工跑), workflow 只做 "同步到 github.sha + 调脚本"; build.py 失败不碰容器, 验证失败自动回滚 - 落地步骤分 4 阶段: 下载 runner(需一次外网) -> 部署克隆 -> sudo 装 systemd 单元并注册(仓库级 runner, API 已确认存在) -> 先 workflow_dispatch 手动跑通 再打开 push 触发 + main 分支保护 - 明确写出 host 模式的安全含义(等价 root)、待落地确认项(host 标签语法/fork PR 审批等)与备选方案(cron 轮询) deploy/README.md 快速索引加一行指向该文档。