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