SHA256
按 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(含全部实测证据与待确认项)。
This commit is contained in:
+52
-9
@@ -1,10 +1,12 @@
|
||||
# CI/CD:main 自动部署(Gitea Actions 方案)
|
||||
|
||||
> **状态:方案,尚未落地。** 全流程**不需要 root**(`ymy` 在 `docker` 组即可),
|
||||
> 只需要一次「在 Gitea 页面/API 上拿注册令牌」的动作。
|
||||
> **状态:已落地并本地验证通过(2026-09-13),只差一次 `git push`。**
|
||||
> runner 已注册、部署克隆已建、生产已切到部署克隆、整条部署路径(含真实 job 容器)
|
||||
> 已在本机预演通过;推送 `main` 后第一次 CI 运行即接管。**全程不需要 root。**
|
||||
>
|
||||
> 本文标注 **[实测]** 的结论都是 2026-09-13 在本机跑出来的,命令写在对应位置,可复现。
|
||||
> 相关文档:[deploy/README.md](README.md)(部署与陷阱)、
|
||||
> 当前进度与剩余动作见 §0.1。
|
||||
> 相关文档:[deploy/README.md](README.md)(部署与陷阱,含本次踩到的 3 个坑)、
|
||||
> [customization/README.md](../customization/README.md)(定制机制与预览)。
|
||||
|
||||
---
|
||||
@@ -17,6 +19,36 @@
|
||||
不在本方案范围内:Gitea 版本升级(要备份 + 数据库迁移,仍走 [README §7](README.md) 人工流程)、
|
||||
`issue-templates` 重新推送(运营操作)、官网仓库(`Website`)的部署(那是 GitHub Actions 的事)。
|
||||
|
||||
### 0.1 落地现状与剩余动作(2026-09-13)
|
||||
|
||||
已完成并验证:
|
||||
|
||||
| 项 | 证据 |
|
||||
|---|---|
|
||||
| 部署克隆 `/home/ymy/deploy/tjhlp-gitea`(`origin` = 本机裸仓库,免凭据) | `git remote -v`;`deploy/.env` 600;工作树干净 |
|
||||
| runner 已注册 | `action_runner` 表:`tjhlp-gitea-1 / v0.6.1 / ["self-hosted"]`;日志 `declare successfully` |
|
||||
| 生产已切到部署克隆 | `docker inspect gitea` 的三个挂载源都指向 `/home/ymy/deploy/tjhlp-gitea/...` |
|
||||
| 部署脚本本机跑通(回滚被真实触发过两次) | `auto-deploy.sh` → `build.py` → `up -d` → `verify.sh` + `check.sh` → `✅ 部署成功`;`deploy/.state/last-deployed` 记 SHA |
|
||||
| job 容器路径 | `act_runner exec` 预演:`uid=0 / Python 3.10.12 / git 2.55 / docker server 29.8.0 / compose v5.5.1`,部署克隆可见,`loopback-api=200 apache=200`,`🏁 Job succeeded` |
|
||||
|
||||
这次落地中发现并修掉的问题(细节见 [README](README.md) 陷阱 7–9):
|
||||
|
||||
1. 全新克隆里 `customization/custom/options/` 不存在 → docker 以 root 创建这个挂载源目录 →
|
||||
`build.py` 写不进去 → **语言文件生成失败、「工单」回归**(首页/登录页却看着正常)。
|
||||
修法:`.gitkeep` 让目录随 checkout 存在 + 部署前可写性检查。
|
||||
2. `container.options` 里自己挂 `docker.sock` 与 act_runner 的自动挂载冲突
|
||||
(`Duplicate mount point`),第一次真实部署必然失败。修法:去掉显式挂载。
|
||||
3. 宿主 `/usr/bin/python3` 是 **3.6**,PATH 顺序一变 `build.py` 就 `SyntaxError`,而且语言
|
||||
文件会**静默地**不再更新。修法:脚本自己挑 ≥3.7 的解释器并用它跑 build.py。
|
||||
|
||||
剩余动作:
|
||||
|
||||
1. **你来 `git push`**(本地有 4 个未推送提交)——推送即触发第一次 CI 运行;由于要部署的
|
||||
版本已经在本机部署过,这次应当是"无变化"的快速通过。
|
||||
2. 用一个测试 fork 发 PR,确认 fork PR 的 workflow 审批行为(§9.1);确认前不要把仓库
|
||||
开放给不可信贡献者。
|
||||
3. 给 `main` 加分支保护(§4.4)。
|
||||
|
||||
---
|
||||
|
||||
## 1. 现状与约束 **[实测]**
|
||||
@@ -164,7 +196,9 @@ services:
|
||||
GITEA_INSTANCE_URL: https://cpp.tongji.sh/QA
|
||||
GITEA_RUNNER_REGISTRATION_TOKEN: ${RUNNER_REGISTRATION_TOKEN:?先按 §4.2 拿令牌}
|
||||
GITEA_RUNNER_NAME: tjhlp-gitea-1
|
||||
GITEA_RUNNER_LABELS: self-hosted
|
||||
# 不要在 env 里设 GITEA_RUNNER_LABELS: act_runner 会警告
|
||||
# "Labels from command will be ignored, use labels defined in config file.",
|
||||
# label 以 config.yaml 为准(实测)
|
||||
CONFIG_FILE: /config/config.yaml
|
||||
volumes:
|
||||
- /var/run/docker.sock:/var/run/docker.sock # runner 用它拉起 job 容器
|
||||
@@ -191,6 +225,8 @@ container:
|
||||
--volume /usr/bin/docker:/usr/bin/docker:ro
|
||||
--volume /usr/libexec/docker/cli-plugins:/usr/libexec/docker/cli-plugins:ro
|
||||
force_pull: false # 镜像已有就别每次拉
|
||||
# ★ 不要挂 /var/run/docker.sock: act_runner 会自动挂, 重复挂会
|
||||
# "Duplicate mount point: /var/run/docker.sock" 直接失败(实测)
|
||||
cache:
|
||||
enabled: true
|
||||
```
|
||||
@@ -419,13 +455,20 @@ docker compose -f /home/ymy/deploy/tjhlp-gitea/deploy/compose.yaml logs -f gitea
|
||||
|
||||
---
|
||||
|
||||
## 9. 待落地确认项
|
||||
## 9. 尚未验证的点(诚实清单)
|
||||
|
||||
已由本机预演确认、不再是待确认项的:job 镜像里有 `git 2.55`/`Python 3.10`/docker CLI ✓;
|
||||
act_runner v0.6.1 支持 `:host` 标签与 `container.network: host` ✓;compose 插件在 job 容器里
|
||||
可用 ✓;部署克隆、回环 `127.0.0.1:2080`、经 Apache 的 `10.80.42.185/QA` 在 job 容器内都通 ✓。
|
||||
|
||||
仍然未知:
|
||||
|
||||
1. **fork PR 的 workflow 审批行为**(安全前提):用一个测试 fork 发 PR 验证;在此之前按 §7.3 处理。
|
||||
2. **job 镜像里有没有 `git`/`python3`**:首次运行时确认;缺就换镜像(`catthehacker/ubuntu:act-22.04`
|
||||
实测 arm64 可用)或自建小镜像(`rockylinux:8` + 国内源装 `git python3 docker-ce-cli`)。
|
||||
3. **workflow 语法支持面**:`concurrency`、`timeout-minutes`、`permissions`、job 级 `if` 里的
|
||||
`contains(...)` 在 1.27 的实现里是否都生效(用 `workflow_dispatch` 试一次即知)。
|
||||
2. **workflow 语法支持面**:`concurrency`、`timeout-minutes`、`permissions`、job 级 `if` 里的
|
||||
`contains(...)` 在 1.27 的实现里是否都生效 —— 第一次真实运行即知。
|
||||
3. **Gitea 侧的调度与日志回传**:本机只预演了 job *执行*,没预演调度/日志上报。第一次真实
|
||||
运行会验证。此外部署过程本身会重启 gitea 容器,job 与 Gitea 的连接可能短暂断开
|
||||
(act_runner 会重试),表现为日志里若干 `failed to fetch task` / `unexpected EOF` —— 属正常现象。
|
||||
4. **`github.sha` / `github.event.head_commit.message`** 的取值(试运行时 echo 一次确认)。
|
||||
5. **Actions 日志保留与体积**:`[actions] LOG_RETENTION_DAYS`(默认 365)与存储位置。
|
||||
6. **Gitea 是否支持"环境审批"**:若有 deployments/environments 的审批,可作为
|
||||
|
||||
Reference in New Issue
Block a user