Commit Graph
19 Commits
Author SHA256 Message Date
admin 7ff17f8b2a fix(ci): 收窄 runner 的宿主能力 —— 由 deploy job 自己申报挂载
deploy / deploy (push) Successful in 4s
原来 runner 用 container.options 把 docker.sock / 部署克隆 / 裸库 / docker CLI
全局挂给【每个】job。这个 runner 上的任何 workflow(以后加的 PR 检查、测试)都因此
白拿 docker = root 等价能力。

改成:
  * container.docker_host: "-"  → 不再自动把 socket 挂进 job 容器
  * 删掉全局 container.options 挂载
  * 五项挂载(socket/部署克隆/裸库/docker CLI/compose 插件)由 deploy job 在 workflow
    的 container.volumes 里自己申报
  * 五项仍列在 container.valid_volumes 白名单里(不在表里的申报会被静默丢弃)

效果: 不申报的 job 默认是裸容器(实测看不到 /home/ymy/deploy 与 /srv/gitea)。

验证边界(诚实记录):
  * Gitea 侧确认会把整个 job 的 YAML(含 container:)作为任务载荷发给 runner
    —— services/actions/run.go 里 payload, _ := v.Marshal()
  * act 侧确认会采纳 job 申报的 volumes —— act_runner exec 实测
  * 但 `act_runner exec` 有自己的 --container-daemon-socket 默认值、也不读配置里的
    valid_volumes/docker_host, 所以这两项只能靠一次真实运行确认; 失败模式是
    "第一步 cd 就报错、线上不受影响"
2026-09-22 20:12:57 +08:00
admin 99547005bd fix(ci): cd into the deploy clone before running auto-deploy.sh
deploy / deploy (push) Successful in 4s
The workflow has no actions/checkout, so the default workdir is empty and
'./deploy/scripts/auto-deploy.sh' was not found (exit 127).
2026-09-21 23:49:35 +08:00
admin 438c0f4e01 fix(ci): mount the bare repo for the deploy clone's local remote
deploy / deploy (push) Failing after 7s
The deploy clone fetches from /srv/gitea/git/repositories/... which the job
container cannot see, so 'git fetch' failed with exit 128. Mount it read-only
and whitelist it.
2026-09-21 23:47:45 +08:00
admin c5fdbe16d6 fix(ci): whitelist deploy bind mounts in runner valid_volumes
deploy / deploy (push) Failing after 2s
act_runner drops any volume not listed in container.valid_volumes, so the
options --volume flags for the deploy clone and docker CLI were ignored and
the job failed at 'cd /home/ymy/deploy/tjhlp-gitea'.
2026-09-21 23:45:53 +08:00
admin 77b9e72388 fix(oauth2): request the email scope from the OIDC provider
deploy / deploy (push) Failing after 2s
Gitea maps the standard email claim during auto-registration, but the
provider only returns email when the email scope is requested. Adding it
here (the IdP also now allows the email scope for the tjhlp-gitea client)
fixes 'OAuth2 提供商返回缺失的字段: email'.
2026-09-21 23:14:51 +08:00
admin 73ce8162aa feat(ci): 落地 main 自动部署的可复用件(runner 配置/部署脚本/定制断言/工作流)
deploy / deploy (push) Skipped
按 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(含全部实测证据与待确认项)。
2026-09-13 22:09:32 +08:00
admin ea3ad2bb31 docs: 修正 CI/CD 方案的前提 —— 本机可完整访问互联网
之前测的是错的: 我把 --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 自动注入的结论不变。
2026-09-13 17:27:47 +08:00
admin a65970303f docs: 新增 CI/CD 方案(deploy/ci-cd.md): main 推送经 Gitea Actions 自动部署
只写方案, 不落地(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 快速索引加一行指向该文档。
2026-09-13 16:59:39 +08:00
admin b60e5e9f1e fix: 容器默认不用出站代理(实测确认不需要)
上一版把代理默认值设成了改造前宿主机上的 10.80.42.185:7890, 实测其实是多余的:

- 与功能相关的出站只有 OIDC, 目标是 10.80.42.185, 容器内直连 200;
- 容器里会访问外网的只有「检查更新」(纯提示)和个别学生仓库的 webhook
  (Heai/Test-Webhooks -> heai.ink, jkljkluiouio/hw02 -> debianapi.*),
  课程平台自身与课程仓库都不依赖;
- 宿主 7890 是 ssh 转发的开发用代理, ss -ltn 显示只监听 127.0.0.1/[::1],
  容器两条路都连不上(127.0.0.1:7890 是容器自己的回环, 10.80.42.185:7890
  curl -x 直接 Could not connect) —— 配上只会让每次出站先绕一圈再失败。

改成 ${GITEA_HTTP_PROXY:-} 这种空默认值: 仍然显式赋值以挡住 compose 的自动注入
(注入 127.0.0.1:7890 会让 OIDC discovery 失败、登录 404), 但容器里不再配代理。
将来有稳定且容器可达的代理时, 在 deploy/.env 里给 GITEA_HTTP_PROXY 即可。

实测: 重建后容器内 http_proxy 为空, OIDC 入口 307 -> /oidc/auth, healthz 200,
启动无 [E]; 预览 check 全过。
2026-09-13 16:40:01 +08:00
admin 25f1ec6cfc fix: 固定容器出站代理(修复 OIDC 登录 404); 并关闭通行密钥
1) 出站代理 —— 这次实际踩到的故障:
   docker compose 会把「运行 compose 的那个 shell」里的 http_proxy/https_proxy
   自动注入容器。登录 shell 里是 127.0.0.1:7890, 而 127.0.0.1 在容器里指向容器自己,
   于是 Gitea 启动时 OIDC discovery 失败:
     initOAuth2Sources() [E] Unable to register source: 高程统一身份认证 due to
     proxyconnect tcp: dial tcp 127.0.0.1:7890: connect: connection refused
   认证源注册不上 -> 登录页按钮照旧显示(数据来自数据库), 但点下去
   /QA/user/oauth2/... 返回 404, 统一身份认证完全无法登录。
   现在两处 compose 都显式给出这四个变量(默认 = 改造前宿主机上的代理设置,
   NO_PROXY 含 10.80.42.185 让 OIDC 直连), 显式赋值可挡住自动注入;
   .env.example 说明如何覆盖/置空, README 记为新陷阱 6(含一行验证命令)。

2) 通行密钥: [service] ENABLE_PASSKEY_AUTHENTICATION=false(两处 compose)。
   登录页此前那个"空方框"就是它: 上游该区块只有 tw-hidden 元素, 浏览器不支持
   条件中介时 CSS 隐藏一切, 只剩一个带边框的 segment。关掉后连区块都不再输出。

实测: 生产 up -d 后 OIDC 入口 307 -> https://cpp.tongji.sh/oidc/auth?client_id=tjhlp-gitea...
(修复前是 404), 登录页 200 且两张卡片正常, healthz 200。
2026-09-13 16:31:40 +08:00
admin e489d19cb6 feat: 登录页改为「统一身份认证」优先 + 独立的「管理员登录」卡片
整文件覆盖 templates/user/auth/signin.tmpl(基线已进 upstream/):

- 第一张卡: 站名 + 说明文字 + 认证源按钮。按钮部分仍复用上游的
  {{template "user/auth/external_auth_methods" .}}, 所以换/加认证源不用改模板
- 第二张卡: 「管理员登录」, 正文写明此入口仅管理员与助教使用(本地账号),
  同学们请走统一身份认证 —— 避免同学拿学号去试用户名/密码
- 不再渲染 passkey 区块; 表单字段/验证码/忘记密码/记住设备/注册入口保持上游逻辑,
  仅去掉 autofocus(避免聚焦到次要卡片), 实测登录与报错提示均正常

配套:
- preview.sh check 增加登录页断言(有管理员卡片、无通行密钥方框), 现 15 项全过
- README 新增 3.4 登录页(含「预览里临时加认证源」的做法)、目录树与已验证清单
2026-09-11 17:28:34 +08:00
admin 68fb567cb3 feat: Issue 模板引导链接改指课程官网, 平台地址改由 public_url 注入
- 两个 config.yaml 的 contact_links 从 example.com 换成真实入口:
  官网《学会提问》/ 课程官网 / 平台提问速查, 让答疑平台与官网互相导流
- 模板支持 {{BASE_URL}}/{{ORG}}/{{REPO}} 占位符, 推送时替换,
  换学期建新组织不用改模板; 未配置时保留占位符并告警而不是推坏链接
- scripts: 新增 gitea.public_url(对外地址, 与 CLI 用的 url 区分),
  utils.web_base_url()/render_template_placeholders() 及单元测试
2026-09-11 17:07:11 +08:00
admin 44b174d319 feat: 部署接入定制覆盖层, 并补去 Gitea 化的元信息与页脚配置
- compose.yaml: 三个只读挂载到 /data/gitea/{templates,public,options};
  官方镜像 GITEA_CUSTOM=/data/gitea, 挂 /data/gitea/custom 是无效的
- compose.yaml: [ui.meta] 作者/描述/关键词与 SHOW_FOOTER_POWERED_BY/VERSION,
  环境变量里段名的点要编码成 _0X2E_(GITEA__ui_0X2E_meta__DESCRIPTION)
- .env.example: 新增 GITEA_CUSTOM_DIR(指向 customization/custom)
- README: 新增已知陷阱 3(定制文件权限导致 [F] 拒绝启动, 含体检/修复命令),
  并在升级流程里加入定制基线的同步与校验步骤
2026-09-11 17:07:11 +08:00
admin 7d19e2729c feat: 新增 Gitea 定制机制(首页/中文语言/去 Gitea 化)与本地预览
不改 Go 代码、不 fork, 只用官方 CustomPath 覆盖层 + app.ini/env 配置:

- custom/templates: 整文件覆盖 home.tmpl(落地页换成答疑平台介绍)与
  base/head_navbar.tmpl(docs.gitea.com -> 站内提问指南、新增课程官网入口)
- custom/public/assets/tjhlp/ask-guide.html: 站内提问指南静态页
- overrides/ + build.py: 由上游快照确定性生成整份 locale_zh-CN.json
  (工单 -> Issue 等 133 处), 带占位符校验; 缺失键会退回英文, 必须整份覆盖
- build.py 同时负责规范 custom/ 权限: 容器内 Gitea 以 git(982) 运行,
  文件若为 600 只读挂载也会 permission denied 并拒绝启动(生产踩过)
- upstream/<版本>/ + fetch-upstream.sh: 上游基线, 供升级时 diff 与重生成
- preview/: 独立 compose + preview.sh(up/check/reload/admin/reset),
  与生产隔离(独立端口 2081/数据目录/sqlite), 用同一镜像版本验证效果
- website-linkage.md: 官网(VitePress)侧的联动改动提案
2026-09-11 17:07:05 +08:00
admin 79256c5be0 feat: 新增 Docker Compose 部署方案, 移除未验证的 ansible 草案
原 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 登录源注册正常。
2026-09-11 16:00:15 +08:00
admin 66c254e0ff refactor: 移除 SMTP 相关代码,简化用户创建流程,更新文档 2026-04-13 12:27:14 +08:00
admin 919c561629 fix: 移除调试代码 2026-04-13 00:47:13 +08:00
admin 7c141ac9fd fix: 修复 settings.toml 中配置被 .secret.toml 整节覆盖的问题 2026-04-13 00:46:19 +08:00
admin 7592af1c3a initial commit 2026-04-12 23:24:13 +08:00