SHA256
forked from course-team/tjhlp-gitea
feat(ci): 落地 main 自动部署的可复用件(runner 配置/部署脚本/定制断言/工作流)
按 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:
@@ -178,6 +178,41 @@
|
||||
> 'http://127.0.0.1:2080/user/oauth2/%E9%AB%98%E7%A8%8B%E7%BB%9F%E4%B8%80%E8%BA%AB%E4%BB%BD%E8%AE%A4%E8%AF%81'
|
||||
> # 期望: 307 + Location: https://cpp.tongji.sh/oidc/auth?... (404 = 认证源没注册上)
|
||||
> ```
|
||||
>
|
||||
> **⚠️ 7. 全新克隆 + compose: docker 会以 root 创建不存在的挂载源目录。**
|
||||
> `compose.yaml` 把 `customization/custom/{options,public,templates}` 逐个挂进容器。
|
||||
> 其中 `options/` 里只有生成出来的 `locale_zh-CN.json`, 而它是 gitignore 的 —— 于是
|
||||
> 全新克隆里这个目录不存在, **docker 会以 root 创建它**, 之后普通用户跑
|
||||
> `customization/build.py` 就写不进去:
|
||||
> ```
|
||||
> PermissionError: [Errno 13] Permission denied: .../custom/options/locale
|
||||
> ```
|
||||
> 后果不是报错那么明显: 语言文件生成失败 → 中文界面退回上游文案(「工单」又回来了),
|
||||
> 而首页/登录页看起来一切正常。2026-09-13 第一次把生产切到部署克隆(CI 用的那份)时踩到。
|
||||
>
|
||||
> 现在有两道防线: ①仓库里 `customization/custom/options/.gitkeep` 让目录随 checkout 就存在
|
||||
> 且属于当前用户; ②`deploy/scripts/auto-deploy.sh` 在部署前检查三个目录存在且**可写**,
|
||||
> 不满足就明确报错。若已经中招:
|
||||
> ```bash
|
||||
> sudo rm -rf customization/custom/options # 空的 root 目录, 删掉即可
|
||||
> ```
|
||||
>
|
||||
> **⚠️ 8. act_runner 的 job 容器不要自己挂 `docker.sock`。**
|
||||
> act_runner 会把 docker daemon socket **自动**挂进 job 容器(`container.docker_host` 的默认
|
||||
> 行为); 再在 `deploy/runner/config.yaml` 的 `container.options` 里挂一次, 第一次真实部署
|
||||
> 就会以这个错误告终:
|
||||
> ```
|
||||
> failed to create container: 'Duplicate mount point: /var/run/docker.sock'
|
||||
> ```
|
||||
> 2026-09-13 用 `act_runner exec` 预演 job 时提前发现。`container.options` 里只保留
|
||||
> 部署克隆(同路径)、宿主 docker CLI、compose 插件这三项。
|
||||
>
|
||||
> **⚠️ 9. 宿主 `/usr/bin/python3` 是 3.6, 别让它排到 PATH 前面。**
|
||||
> `customization/build.py` 用了 `from __future__ import annotations`, 需要 ≥3.7。
|
||||
> 宿主上正确的解释器是 `~/.local/bin/python3`(3.14), 但 `/usr/bin/python3` 是 Rocky 8 的
|
||||
> 3.6 —— 只要 PATH 被改成 `/usr/bin` 优先, 就会看到
|
||||
> `SyntaxError: future feature annotations is not defined`, 而且**语言文件静默地不再更新**。
|
||||
> `auto-deploy.sh` 现在自己挑一个 ≥3.7 的解释器(并用它跑 build.py), 不依赖 PATH 顺序。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user