按 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(含全部实测证据与待确认项)。
原 ansible/ 方案从未在任何环境验证过, 且与本机实际状态严重不符(硬编码 amd64 二进制、会覆盖生产 /etc/gitea/app.ini、会启动 firewalld 切断其它 服务、建的库名与现网不一致); 加上宿主机 Rocky 8 的系统 Python 无法升级, 新版 ansible 也跑不起来。改为 Docker Compose。 新增 deploy/: - compose.yaml 版本锁定; Gitea 只发布 127.0.0.1:2080(Apache 反代无需 改动), PostgreSQL 不发布端口; 配置全部由 GITEA__section__KEY 环境变量注入; 数据用 bind mount - db/Dockerfile 官方 postgres 只生成 en_US.UTF-8, 这里补 zh_CN.UTF-8, 与现有集群 collation 保持一致 - scripts/ backup.sh(pg_dump + 数据 tar + SHA256SUMS)、 restore.sh(默认 dry-run, 校验后还原, 拒收宿主布局备份)、 verify.sh(容器健康 + 回环 API + 经 Apache 反代) 文档 deploy/README.md 以 部署/备份/恢复/升级 四条流程为主线, 并记录本机 踩过的四个陷阱: PG18 挂载点、s6 chown 守卫、APP_NAME 只能走裸变量、 HTTP 代理导致的假 502。 一次性迁移脚本(install-docker / configure-docker-proxy / preflight / migrate-from-binary)已清理, 相应步骤内联进文档。 实测: 源 116 表 → 目标 116 表, /api/healthz 200, 经 Apache /QA 200, 站点名与 OIDC 登录源注册正常。