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
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
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