Compare commits

...
3 Commits
Author SHA256 Message Date
admin 9446850182 feat: Issue 发布者/回答者显示姓名, 而不是学号
deploy / deploy (push) Successful in 25s
Issue 页的作者名走 User.GetDisplayName(), 默认返回 login(学号),
看不到老师/助教认得的姓名。打开站点级开关 [ui] DEFAULT_SHOW_FULL_NAME
后改为显示 full_name, 未填姓名的用户回退学号。

配合 OIDC 侧把 full_name 覆盖成 display_name(学号-姓名), 即可同时
显示学号与姓名; 存量用户需重新登录才会刷新, 见 scripts/README.md。

- deploy/compose.yaml: GITEA__ui__DEFAULT_SHOW_FULL_NAME=true
- customization/preview/compose.yaml: 同步, 便于预览验证
- customization/README.md: 配置表 / 环境变量片段 / 已验证清单
- scripts/settings.toml: CLI 调 API 的地址改为宿主回环 127.0.0.1:2080
  (10.80.42.185:3000 未对外开放, 上层反代返回 502)

已在预览实例(Gitea 1.27.3)验证: 「由 X 创建」与正文/评论作者
均显示 full_name。
2026-09-25 19:04:24 +08:00
admin 8d5c8c6bae docs(deploy): 把「SSH 默认关闭」的说明对齐实测, 并补上启用步骤
起因是加公钥时页面提示"SSH 目前已禁用, 这些密钥仅用于提交签名验证"。查证后修正两处
过时/失效的说明:

- compose 里那行注释让读者去看 deploy/README.md「启用 SSH 克隆」—— 该小节并不存在
- README 兼容性表里 server.DISABLE_SSH 的理由写的是"实测 /home/git/.ssh 不存在"。
  实测(2026-09-23): 容器里 git 用户家目录是 /data/git, /data/git/.ssh/authorized_keys
  存在且由 Gitea 维护(形如 command="… gitea serv key-N"), 加过公钥的账号启用后即可用

新增「如需启用 SSH 克隆(可选, 默认关闭)」小节, 记下查证到的事实: 镜像自带 sshd(s6 服务
openssh, 容器内已在 0.0.0.0:22 监听, 只是没发布端口)、host key 在持久卷 /data/ssh、
sshd_config 只允许 git 用户公钥认证(PasswordAuthentication no / AllowUsers git /
PermitRootLogin no / 不转发)、宿主 22 被宿主自己的 sshd 占用; 以及要同时改的三处
(DISABLE_SSH / SSH_DOMAIN / SSH_PORT + 发布 2222:22)、验证命令和利弊。
2026-09-23 02:08:49 +08:00
admin 53116f7a23 fix(ci): 部署时必须重启 gitea —— 指纹要与上次成功部署比, 而不是 build.py 前后
deploy / deploy (push) Successful in 11s
事故经过(2026-09-22): 「提问指南」换地址那个提交推送后 CI 挂了, auto-deploy 回滚。
check.sh 报「没找到官网提问指南链接 / 仍有旧地址」—— 但脚本确实把部署克隆同步到了新
提交、语言文件也重新生成了。原来 deploy() 比较的是 build.py 运行【前后】的指纹: 那只能
发现语言文件被重新生成, 纯模板改动前后完全一样 → 从不重启 → 容器继续用启动时加载的旧
模板 → 断言失败 → 整个部署被判失败并回滚。也就是说: 任何只改模板的提交都必然挂 CI。

修法: 把指纹记在 deploy/.state/custom-hash 里, 与【上次成功部署】的指纹比较, 不同就
restart gitea(restart 而不是 up -d: compose 配置没变时 up -d 不重建容器)。rollback 路径
改成 deploy force 无条件重启 —— 失败的那次可能已经用新模板重启过容器, 回滚必须再重启
回去, 顺便也修好下面这个副作用。

顺带修一个 bind mount 的坑: 挂载【源目录】被「删掉再建」后容器里挂的还是旧 inode(空
目录)。这次事故里 public/ 下的文件被删光、git 顺手删掉空目录, 于是线上
/QA/assets/tjhlp/ask-guide.html 变成 404。已在预览上复现([B] 404 → restart 后 [C] 200),
restart 会重新解析挂载, 所以上面的修法同时把它修好。

验证(不碰生产的沙箱, 假 docker + 桩 verify/check):
  1 全新状态首次部署        → up -d + restart ✓
  2 什么都没改再部署        → 不重启 ✓
  3 只改一个模板文件        → 重启 ✓(这次的回归点)
  4 之后再来一次            → 不重启 ✓
  5 check 失败 → 回滚       → checkout PREV + 强制 restart ✓, 状态文件不被污染 ✓
另外 check.sh / preview.sh 的失败信息里加了「模板改动要重启才生效」的提示, 并把
ci-cd.md §5.2(脚本清单+为什么必须 restart)与 README §12 速查表同步更新。
2026-09-23 01:52:58 +08:00
10 changed files with 138 additions and 17 deletions
+5
View File
@@ -68,6 +68,7 @@ Gitea 把模板 / 语言 / 静态资源都编进了二进制,但读取时走 `as
| 首页指向 | `[server] LANDING_PAGE` | `GITEA__server__LANDING_PAGE` | | 首页指向 | `[server] LANDING_PAGE` | `GITEA__server__LANDING_PAGE` |
| meta 作者/描述/关键词 | `[ui.meta] AUTHOR/DESCRIPTION/KEYWORDS` | `GITEA__ui_0X2E_meta__DESCRIPTION` 等 | | meta 作者/描述/关键词 | `[ui.meta] AUTHOR/DESCRIPTION/KEYWORDS` | `GITEA__ui_0X2E_meta__DESCRIPTION` 等 |
| 页脚 Powered by / 版本号 | `[other] SHOW_FOOTER_POWERED_BY` / `SHOW_FOOTER_VERSION` | `GITEA__other__SHOW_FOOTER_POWERED_BY` | | 页脚 Powered by / 版本号 | `[other] SHOW_FOOTER_POWERED_BY` / `SHOW_FOOTER_VERSION` | `GITEA__other__SHOW_FOOTER_POWERED_BY` |
| Issue 显示姓名而非学号 | `[ui] DEFAULT_SHOW_FULL_NAME` | `GITEA__ui__DEFAULT_SHOW_FULL_NAME` |
| 自定义主题配色 | `[ui] THEMES` + `custom/public/assets/css/theme-*.css` | `GITEA__ui__THEMES` | | 自定义主题配色 | `[ui] THEMES` + `custom/public/assets/css/theme-*.css` | `GITEA__ui__THEMES` |
| 关闭通行密钥(WebAuthn) | `[service] ENABLE_PASSKEY_AUTHENTICATION` | `GITEA__service__ENABLE_PASSKEY_AUTHENTICATION` | | 关闭通行密钥(WebAuthn) | `[service] ENABLE_PASSKEY_AUTHENTICATION` | `GITEA__service__ENABLE_PASSKEY_AUTHENTICATION` |
| 关闭用户名/密码表单 | `[service] ENABLE_PASSWORD_SIGNIN_FORM` | `GITEA__service__ENABLE_PASSWORD_SIGNIN_FORM` | | 关闭用户名/密码表单 | `[service] ENABLE_PASSWORD_SIGNIN_FORM` | `GITEA__service__ENABLE_PASSWORD_SIGNIN_FORM` |
@@ -260,6 +261,8 @@ GITEA_CUSTOM_DIR=../customization/custom
GITEA__ui_0X2E_meta__KEYWORDS: 同济大学,高级语言程序设计,答疑,Issue GITEA__ui_0X2E_meta__KEYWORDS: 同济大学,高级语言程序设计,答疑,Issue
GITEA__other__SHOW_FOOTER_POWERED_BY: "false" GITEA__other__SHOW_FOOTER_POWERED_BY: "false"
GITEA__other__SHOW_FOOTER_VERSION: "false" GITEA__other__SHOW_FOOTER_VERSION: "false"
# Issue 发布者/评论者显示姓名(导入时 full_name=姓名, login=学号)
GITEA__ui__DEFAULT_SHOW_FULL_NAME: "true"
``` ```
设计取舍: 设计取舍:
@@ -365,6 +368,8 @@ cd deploy && ./scripts/backup.sh --quiesce && docker compose pull gitea && docke
- ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框 - ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框
- ✅ 首页(登录后)顶部出现学期答疑入口卡片: 只认 `tjhlp-<5 位数字>`、取最新学期、 - ✅ 首页(登录后)顶部出现学期答疑入口卡片: 只认 `tjhlp-<5 位数字>`、取最新学期、
无匹配则不显示(预览里用 3 个用户 × 4 个组织验证过) 无匹配则不显示(预览里用 3 个用户 × 4 个组织验证过)
- ✅ 打开 `[ui] DEFAULT_SHOW_FULL_NAME` 后, Issue 的「由 X 创建」与正文/评论作者
显示 `full_name`(姓名), 未填姓名的用户回退显示 login(学号)(预览实测)
尚未覆盖(需要时按同样套路加): 尚未覆盖(需要时按同样套路加):
+2 -1
View File
@@ -42,7 +42,8 @@ ok "首页可访问"
grep -q "先搜索,再提问" "${tmp}/home.html" && grep -q "先搜索,再提问" "${tmp}/home.html" &&
ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容" ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${tmp}/home.html" && grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${tmp}/home.html" &&
ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" || bad "没找到官网提问指南链接" ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" ||
bad "没找到官网提问指南链接(页面还是旧模板? 模板改动要重启 gitea 才生效)"
! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${tmp}/home.html" && ! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${tmp}/home.html" &&
ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案" ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案"
! grep -qi "powered by" "${tmp}/home.html" && ! grep -qi "powered by" "${tmp}/home.html" &&
+5
View File
@@ -84,6 +84,11 @@ services:
GITEA__other__SHOW_FOOTER_POWERED_BY: "false" GITEA__other__SHOW_FOOTER_POWERED_BY: "false"
GITEA__other__SHOW_FOOTER_VERSION: "false" GITEA__other__SHOW_FOOTER_VERSION: "false"
# --- 显示名称: 与生产一致, Issue 显示姓名而不是学号 ----------------
# 说明见 deploy/compose.yaml 同位置。这里给上才能让预览里验证
# 「发布者/回答者显示姓名」的效果。
GITEA__ui__DEFAULT_SHOW_FULL_NAME: "true"
GITEA__log__MODE: console GITEA__log__MODE: console
GITEA__log__LEVEL: ${GITEA_LOG_LEVEL:-info} GITEA__log__LEVEL: ${GITEA_LOG_LEVEL:-info}
+2 -1
View File
@@ -127,7 +127,8 @@ check)
grep -q "先搜索,再提问" "${html}" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容" grep -q "先搜索,再提问" "${html}" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${html}" && grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${html}" &&
ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" || bad "没找到官网提问指南链接" ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" ||
bad "没找到官网提问指南链接(页面还是旧模板? 模板改动要重启 gitea 才生效)"
! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${html}" && ! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${html}" &&
ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案" ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案"
! grep -qi "powered by" "${html}" && ok "页脚已无 Powered by Gitea" || bad "页脚仍有 Powered by" ! grep -qi "powered by" "${html}" && ok "页脚已无 Powered by Gitea" || bad "页脚仍有 Powered by"
+41 -1
View File
@@ -816,6 +816,8 @@ if SecretKey == "" {
| `docker build` 报 `lookup auth.docker.io ... i/o timeout` | §4.3 | 先 `docker pull` 基础镜像 | | `docker build` 报 `lookup auth.docker.io ... i/o timeout` | §4.3 | 先 `docker pull` 基础镜像 |
| `docker pull` 报 `i/o timeout` | §4.3 | 代理 drop-in 没生效, `systemctl show docker -p Environment` | | `docker pull` 报 `i/o timeout` | §4.3 | 代理 drop-in 没生效, `systemctl show docker -p Environment` |
| 容器 healthy 但站点 503 | `docker compose logs gitea` | 多为 `.env` 里 DB 密码与既有数据不一致 | | 容器 healthy 但站点 503 | `docker compose logs gitea` | 多为 `.env` 里 DB 密码与既有数据不一致 |
| CI 部署"成功"但页面还是旧模板 / 部署回滚 | `ci-cd.md` §5.2 | `custom/` 变了却没重启容器(或挂载源目录被换过 inode), 见该节说明 |
| `/QA/assets/...` 下自己放的静态文件 404 | — | 挂载的 `custom/public` 目录被删除重建过, `docker compose restart gitea` 重新挂载 |
--- ---
@@ -883,7 +885,7 @@ systemctl start gitea`(§9)。
| 配置 | 迁移前 | 现在 | 原因 | | 配置 | 迁移前 | 现在 | 原因 |
|---|---|---|---| |---|---|---|---|
| `log.MODE` | `file` | `console` | 日志进 stdout, 用 `docker compose logs` 收集 | | `log.MODE` | `file` | `console` | 日志进 stdout, 用 `docker compose logs` 收集 |
| `server.DISABLE_SSH` | `false` | `true` | 实测 `/home/git/.ssh` 不存在, SSH 从未使用; 避免暴露无法工作的克隆地址 | | `server.DISABLE_SSH` | `false` | `true` | 只提供 HTTP 克隆地址; 见下面的「如需启用 SSH 克隆」 |
| `server.DOMAIN` | `localhost` | 实际主机/IP | `localhost` 会生成错误的克隆地址; `ROOT_URL` 已显式指定, 此项属修正 | | `server.DOMAIN` | `localhost` | 实际主机/IP | `localhost` 会生成错误的克隆地址; `ROOT_URL` 已显式指定, 此项属修正 |
| `security.ALLOWED_HOST_LIST` | `[security]`(**正确**) | **保持 `[security]`** | 1.27 的规范位置就是 `[security]`; `[webhook]` 是 v28.0.0 将移除的 deprecated fallback | | `security.ALLOWED_HOST_LIST` | `[security]`(**正确**) | **保持 `[security]`** | 1.27 的规范位置就是 `[security]`; `[webhook]` 是 v28.0.0 将移除的 deprecated fallback |
| `server.HTTP_ADDR` | `0.0.0.0:2080` | 容器内 `0.0.0.0`, 宿主只发布 `127.0.0.1:2080` | 保持 Apache 反代路径不变, 同时消除直连暴露面 | | `server.HTTP_ADDR` | `0.0.0.0:2080` | 容器内 `0.0.0.0`, 宿主只发布 `127.0.0.1:2080` | 保持 Apache 反代路径不变, 同时消除直连暴露面 |
@@ -892,6 +894,44 @@ systemctl start gitea`(§9)。
其余配置(注册策略、OIDC 自动注册、admin 限制、pull-request/signing 默认值、 其余配置(注册策略、OIDC 自动注册、admin 限制、pull-request/signing 默认值、
`PASSWORD_HASH_ALGO=pbkdf2`、`OFFLINE_MODE`、webhook TLS 等)均按原值 1:1 保留。 `PASSWORD_HASH_ALGO=pbkdf2`、`OFFLINE_MODE`、webhook TLS 等)均按原值 1:1 保留。
#### 如需启用 SSH 克隆(可选, 默认关闭)
关闭后界面上所有克隆地址都是 HTTP, 加公钥时也会提示"SSH 目前已禁用, 这些密钥仅用于提交
签名验证"。实测现状(2026-09-23):
| 事实 | 值 |
|---|---|
| 镜像自带 sshd | **有**: s6 服务 `/etc/s6/openssh`, 容器内**已在 `0.0.0.0:22` 上监听**(只是没发布端口) |
| 发布到宿主 | 没有 —— `docker port gitea` 只有 `3000/tcp -> 127.0.0.1:2080`, 所以外部连不上 |
| git 用户家目录 | `/data/git`(不是旧版镜像的 `/home/git`) |
| 授权文件 | `/data/git/.ssh/authorized_keys`, **由 Gitea 维护**(形如 `command="… gitea serv key-N"`), 所以加过公钥的账号启用后立刻可用, 不用重加 |
| host key | `/data/ssh/ssh_host_{ed25519,rsa,ecdsa}_key`, 在 `/data` 持久卷里(迁移会一起走) |
| 认证策略 | `PasswordAuthentication no` / `AllowUsers git` / `PermitRootLogin no` / `AllowTcpForwarding,AllowAgentForwarding no` —— 只能公钥 |
| 宿主 22 | 被宿主自己的 OpenSSH 占着(`0.0.0.0:22`), 所以 Gitea 得换端口 |
要启用得同时改三处, 少一处就会出现 `ssh://git@localhost:22/...` 这种没用的克隆地址
(这正是当初关掉它的原因):
```yaml
GITEA__server__DISABLE_SSH: "false"
GITEA__server__SSH_DOMAIN: ${GITEA_DOMAIN} # 对外主机; 默认值是 localhost
GITEA__server__SSH_PORT: "2222" # 展示在克隆地址里的端口
ports:
- "0.0.0.0:2222:22" # 宿主 2222 -> 容器 sshd 的 22
```
然后 `docker compose up -d gitea`(端口变了要重建容器), 验证:
```bash
ssh -T -p 2222 [email protected] # 期望: Hi <用户名>! You've successfully authenticated, ...
```
**代价**: 绕过 Apache 多开一个对外的口子(当前 firewalld 未运行 = 校内可达)、多一个攻击面、
`SSH_DOMAIN`/`SSH_PORT` 必须和实际一致、非 22 端口对使用者不友好。**好处**: 免密推送(私钥
不出本机), 而当前平台是纯 HTTP —— HTTP 推送的账号密码/token 是 base64 明文过网。
只需要给自己和几个助教免密的话, 用 HTTP + Personal Access Token +
`git config --global credential.helper 'cache --timeout=604800'` 更省事, 不必动服务器。
**迁移中发现并处理的既有问题**: **迁移中发现并处理的既有问题**:
| # | 问题 | 证据 | 处理 | | # | 问题 | 证据 | 处理 |
+27 -2
View File
@@ -371,6 +371,7 @@ export no_proxy='*' NO_PROXY='*'
mkdir -p "$STATE_DIR" mkdir -p "$STATE_DIR"
TARGET=${1:-$(git -C "$REPO_DIR" rev-parse HEAD)} TARGET=${1:-$(git -C "$REPO_DIR" rev-parse HEAD)}
PREV=$(cat "$STATE_FILE" 2>/dev/null || true) PREV=$(cat "$STATE_FILE" 2>/dev/null || true)
HASH_FILE="${STATE_DIR}/custom-hash" # 上次成功部署时 custom/ 的指纹
exec 9>"${STATE_DIR}/lock" # workflow 的 concurrency 之外再加一道 exec 9>"${STATE_DIR}/lock" # workflow 的 concurrency 之外再加一道
flock -n 9 || { echo "[auto-deploy] 已有部署在跑, 退出"; exit 0; } flock -n 9 || { echo "[auto-deploy] 已有部署在跑, 退出"; exit 0; }
@@ -378,10 +379,20 @@ flock -n 9 || { echo "[auto-deploy] 已有部署在跑, 退出"; exit 0; }
echo "[auto-deploy] 目标 ${TARGET} (上次成功: ${PREV:-无})" echo "[auto-deploy] 目标 ${TARGET} (上次成功: ${PREV:-无})"
cd "$REPO_DIR" cd "$REPO_DIR"
deploy() { # customization/custom/ 的指纹: 模板、静态页、生成的语言文件都在里面, 都是启动时加载的
custom_hash() {
(cd customization/custom && find . -type f -exec sha256sum {} + | sort | sha256sum | cut -d' ' -f1)
}
deploy() { # deploy force = 无条件重启(回滚路径用)
python3 customization/build.py # 生成语言文件 + 规范 custom/ 权限(容器用户要能读) python3 customization/build.py # 生成语言文件 + 规范 custom/ 权限(容器用户要能读)
python3 customization/build.py --check # 生成物/权限校验, 不过就中止, 不碰容器 python3 customization/build.py --check # 生成物/权限校验, 不过就中止, 不碰容器
( cd deploy && docker compose up -d ) # 幂等: 只有配置/镜像变化时才重建 ( cd deploy && docker compose up -d ) # 幂等: 只有配置/镜像变化时才重建
# ★ 必须和【上次成功部署的指纹】比, 不能只比 build.py 前后 —— 后者只能发现语言
# 文件变化, 纯模板改动前后一模一样, 于是永远不重启、容器继续用旧模板(详见下方说明)
if [[ -n "${1:-}" || $(custom_hash) != "$(cat "$HASH_FILE" 2>/dev/null)" ]]; then
( cd deploy && docker compose restart gitea )
fi
} }
verify() { verify() {
@@ -393,12 +404,13 @@ rollback() {
[[ -z "${PREV}" ]] && { echo "[auto-deploy] 无历史版本可回退, 保持现状"; return 0; } [[ -z "${PREV}" ]] && { echo "[auto-deploy] 无历史版本可回退, 保持现状"; return 0; }
echo "[auto-deploy] 回滚到 ${PREV}" echo "[auto-deploy] 回滚到 ${PREV}"
git checkout --detach "$PREV" git checkout --detach "$PREV"
deploy || true deploy force || true # 强制重启: 失败那次可能已用新模板重启过容器
verify || true verify || true
} }
if deploy && verify; then if deploy && verify; then
echo "$TARGET" > "$STATE_FILE" echo "$TARGET" > "$STATE_FILE"
custom_hash > "$HASH_FILE" # 记下这次成功部署的指纹, 供下次比较
echo "[auto-deploy] ✅ 部署成功 ${TARGET}" echo "[auto-deploy] ✅ 部署成功 ${TARGET}"
else else
echo "[auto-deploy] ❌ 部署或验证失败, 开始回滚" echo "[auto-deploy] ❌ 部署或验证失败, 开始回滚"
@@ -407,6 +419,19 @@ else
fi fi
``` ```
> **为什么非要 `restart`(2026-09-22 踩到的坑)**:模板与语言文件是 Gitea **启动时**加载的,
> 而 `docker compose up -d` 在 compose 配置没变时**不会重建容器**。最早的实现比较的是
> `build.py` 运行前后的指纹——那只会在语言文件被重新生成时才变;**纯模板改动**(改文案、
> 换链接)前后完全一样,于是从不重启,容器继续用旧模板,`check.sh` 断言失败 → 整个部署
> 被判失败并回滚(「提问指南」换地址那个提交就是这样被回滚的)。改成把指纹记在
> `.state/custom-hash` 里、与**上次成功部署**比较后,模板改动会触发重启。
>
> `restart` 还顺带修一个 bind mount 的坑:挂载**源目录**被「删掉再建」(例如某个提交把
> `custom/public/` 下的文件删光了,git 顺手删掉空目录)后,容器里挂的仍是**旧 inode**,
> 看到的是一个空目录——只有重新 start 才会解析到新目录。同一次事故里线上的
> `/QA/assets/tjhlp/ask-guide.html` 就是这么变成 404 的(已在预览上复现并验证 restart 能修)。
> CI 若只更新了文档/脚本(`custom/` 没动),指纹相同则不重启,省掉一次无谓的停机。
落库前的两个小动作:`.gitignore` 加 `deploy/.state/`、`deploy/runner/data/`、 落库前的两个小动作:`.gitignore` 加 `deploy/.state/`、`deploy/runner/data/`、
`deploy/runner/.env`;给 `auto-deploy.sh` 加可执行位(`git` 只记可执行位)。 `deploy/runner/.env`;给 `auto-deploy.sh` 加可执行位(`git` 只记可执行位)。
+13 -2
View File
@@ -92,6 +92,14 @@ services:
GITEA__other__SHOW_FOOTER_POWERED_BY: "false" GITEA__other__SHOW_FOOTER_POWERED_BY: "false"
GITEA__other__SHOW_FOOTER_VERSION: "false" GITEA__other__SHOW_FOOTER_VERSION: "false"
# --- 显示名称: Issue 发布者/评论者显示姓名, 而不是学号 ---------------
# 导入用户时 full_name = 真实姓名、login = 学号(见 scripts/.../users.py);
# Gitea 默认只显示 login, 打开这个开关后 Issue 的「由 X 创建」、正文/评论作者
# 以及其它用 GetDisplayName() 的地方都改为显示 full_name, 没填姓名的回退学号。
# 证据: models/user/user.go 的 GetDisplayName(); templates/shared/user/authorlink.tmpl。
# 这是站点级设置, 没有按用户的开关。改完需重建容器(up -d)才生效。
GITEA__ui__DEFAULT_SHOW_FULL_NAME: "true"
# --- 数据库 --------------------------------------------------------- # --- 数据库 ---------------------------------------------------------
GITEA__database__DB_TYPE: postgres GITEA__database__DB_TYPE: postgres
GITEA__database__HOST: db:5432 GITEA__database__HOST: db:5432
@@ -108,8 +116,11 @@ services:
GITEA__server__HTTP_ADDR: 0.0.0.0 GITEA__server__HTTP_ADDR: 0.0.0.0
GITEA__server__HTTP_PORT: "3000" GITEA__server__HTTP_PORT: "3000"
GITEA__server__APP_DATA_PATH: /data/gitea GITEA__server__APP_DATA_PATH: /data/gitea
# 现有部署未启用 SSH(git 用户无 .ssh/authorized_keys), 故关闭。 # 关闭 SSH: 界面只提供 HTTP 克隆地址(加公钥时会提示"仅用于提交签名验证")。
# 如需启用容器内置 SSH, 见 deploy/README.md "启用 SSH 克隆"。 # 注意镜像自带 sshd(s6 服务 openssh), 容器内就在 22 上监听 —— 只是没有发布端口。
# 启用要同时改 DISABLE_SSH / SSH_DOMAIN / SSH_PORT 并在 ports 里发布 2222:22,
# 少改一处就会出现 ssh://git@localhost:22/... 这种坏地址: 见
# deploy/README.md「如需启用 SSH 克隆(可选, 默认关闭)」。
GITEA__server__DISABLE_SSH: "true" GITEA__server__DISABLE_SSH: "true"
GITEA__server__LFS_START_SERVER: "true" GITEA__server__LFS_START_SERVER: "true"
GITEA__server__OFFLINE_MODE: ${GITEA_OFFLINE_MODE:-true} GITEA__server__OFFLINE_MODE: ${GITEA_OFFLINE_MODE:-true}
+28 -9
View File
@@ -4,14 +4,17 @@
# ./auto-deploy.sh # 部署当前 checkout # ./auto-deploy.sh # 部署当前 checkout
# ./auto-deploy.sh <sha> # 部署指定提交 # ./auto-deploy.sh <sha> # 部署指定提交
# #
# 流程: build.py(生成+校验) → docker compose up -d → 验证(verify.sh + check.sh) # 流程: build.py(生成+校验) → docker compose up -d → custom/ 与上次成功部署的指纹不同
# 任一步失败 → 回滚到 deploy/.state/last-deployed 记录的上一个成功提交。 # 就重启 gitea(模板/语言文件是启动时加载的) → 验证(verify.sh + check.sh)
# → 成功则记下 .state/{last-deployed,custom-hash}
# 任一步失败 → 回滚到 deploy/.state/last-deployed 记录的上一个成功提交并强制重启。
# 只动代码与挂载文件; 数据库/`.env`/备份目录全程不参与(见 deploy/ci-cd.md §6)。 # 只动代码与挂载文件; 数据库/`.env`/备份目录全程不参与(见 deploy/ci-cd.md §6)。
set -euo pipefail set -euo pipefail
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)" REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
STATE_DIR="${REPO_DIR}/deploy/.state" STATE_DIR="${REPO_DIR}/deploy/.state"
STATE_FILE="${STATE_DIR}/last-deployed" STATE_FILE="${STATE_DIR}/last-deployed"
HASH_FILE="${STATE_DIR}/custom-hash" # 上次成功部署时 customization/custom/ 的指纹
PUBLIC_URL="${GITEA_PUBLIC_URL:-http://10.80.42.185/QA}" PUBLIC_URL="${GITEA_PUBLIC_URL:-http://10.80.42.185/QA}"
# 本机/内网回环验证不能走代理, 否则会把 200 变成 502(见 deploy/README.md 陷阱 5) # 本机/内网回环验证不能走代理, 否则会把 200 变成 502(见 deploy/README.md 陷阱 5)
@@ -65,7 +68,11 @@ cd "${REPO_DIR}"
# customization/custom/ 的指纹: 模板、静态页、生成的语言文件都在里面。 # customization/custom/ 的指纹: 模板、静态页、生成的语言文件都在里面。
# 这些是 Gitea 启动时加载的, 变了必须重启容器才生效(README §3), 而 `compose up -d` # 这些是 Gitea 启动时加载的, 变了必须重启容器才生效(README §3), 而 `compose up -d`
# 只在 compose 配置变化时才重建 —— 所以这里自己比指纹, 变了就 restart。 # 只在 compose 配置变化时才重建容器 —— 所以自己比指纹, 变了就 restart。
# ⚠️ 比的是【与上次成功部署的指纹】(.state/custom-hash), 不是 build.py 前后:
# 后者只能发现语言文件被重新生成, 纯模板改动前后完全一样 → 永远不重启 → 容器继续
# 用启动时加载的旧模板 → check.sh 断言失败 → 整个部署回滚。2026-09-22 实际踩到
# (「提问指南」换地址那个提交就这么被回滚了)。
custom_hash() { custom_hash() {
(cd customization/custom && find . -type f -exec sha256sum {} + | sort | sha256sum | cut -d' ' -f1) (cd customization/custom && find . -type f -exec sha256sum {} + | sort | sha256sum | cut -d' ' -f1)
} }
@@ -92,16 +99,27 @@ prepare_custom_dirs() {
} }
deploy() { deploy() {
local before after local force="${1:-}" now last
prepare_custom_dirs || return 1 prepare_custom_dirs || return 1
before="$(custom_hash)"
"${PY}" customization/build.py || return 1 # 生成语言文件 + 规范 custom/ 权限 "${PY}" customization/build.py || return 1 # 生成语言文件 + 规范 custom/ 权限
"${PY}" customization/build.py --check || return 1 # 生成物/权限校验, 不过就中止, 不碰容器 "${PY}" customization/build.py --check || return 1 # 生成物/权限校验, 不过就中止, 不碰容器
after="$(custom_hash)" now="$(custom_hash)"
(cd deploy && docker compose up -d) || return 1 # 幂等: 只有配置/挂载/镜像变化时才重建 (cd deploy && docker compose up -d) || return 1 # 幂等: 只有配置/挂载/镜像变化时才重建
if [[ ${before} != "${after}" ]]; then last="$(cat "${HASH_FILE}" 2>/dev/null || true)"
echo "[auto-deploy] custom/ 有变化(模板/静态页/语言文件), 重启 gitea 使其生效" if [[ -n ${force} || ${now} != "${last}" ]]; then
if [[ -n ${force} ]]; then
echo "[auto-deploy] 回滚路径: 重启 gitea, 让回退后的模板/语言文件生效"
else
echo "[auto-deploy] custom/ 与上次成功部署不同, 重启 gitea 使模板/语言文件生效"
fi
# 用 restart 而不是 up -d: compose 配置没变时 up -d 不重建容器, 而模板/语言文件
# 是启动时加载的。restart 还会【重新解析 bind mount】—— 挂载源目录被「删掉再建」
# (例如某个提交把 public/ 下的文件删光了, git 会顺手删掉空目录)之后, 容器里
# 仍然挂着旧 inode(一个空目录), 只有重新 start 才会挂到新目录上。
# 2026-09-22 实际踩到: 线上 /QA/assets/tjhlp/ask-guide.html 变成 404。
(cd deploy && docker compose restart gitea) || return 1 (cd deploy && docker compose restart gitea) || return 1
else
echo "[auto-deploy] custom/ 与上次成功部署一致, 不重启"
fi fi
} }
@@ -124,7 +142,7 @@ rollback() {
# -f: 旧版本里可能没有 deploy/runner/* 这类文件, 它们在新版本是"未跟踪文件", # -f: 旧版本里可能没有 deploy/runner/* 这类文件, 它们在新版本是"未跟踪文件",
# 会挡住普通 checkout(实测), 这里直接覆盖 # 会挡住普通 checkout(实测), 这里直接覆盖
git checkout -f --detach "${PREV}" git checkout -f --detach "${PREV}"
deploy || true deploy force || true # force: 失败的那次可能已经用新模板重启过容器, 必须再重启回去
verify || true verify || true
} }
@@ -133,6 +151,7 @@ pipeline() { deploy && verify; }
if pipeline; then if pipeline; then
echo "${TARGET}" >"${STATE_FILE}" echo "${TARGET}" >"${STATE_FILE}"
custom_hash >"${HASH_FILE}" # 记下本次成功部署的 custom/ 指纹, 供下次比较
echo "[auto-deploy] ✅ 部署成功 ${TARGET}" echo "[auto-deploy] ✅ 部署成功 ${TARGET}"
else else
echo "[auto-deploy] ❌ 部署或验证失败, 开始回滚" echo "[auto-deploy] ❌ 部署或验证失败, 开始回滚"
+14
View File
@@ -156,6 +156,20 @@ uv run tjhlp labels sync tjhlp-2025f/hw03
uv run tjhlp webhooks list tjhlp-2025f/general uv run tjhlp webhooks list tjhlp-2025f/general
``` ```
### 显示名维护(学号-姓名)
Issue 页显示的是 `full_name`。OIDC 登录时会把 `full_name` 覆盖成认证源
`FullNameClaimName` 对应的 claim(`display_name` = `学号-姓名`),因此**存量用户
需要重新登录**才会刷新。若不想等用户重登,用 `tools/fix_full_name.py` 直接刷一遍:
```bash
export TJHLP_GITEA_TOKEN=<token> # 或建 scripts/.secrets.toml
uv run python tools/fix_full_name.py # dry-run,只打印
uv run python tools/fix_full_name.py --apply # 实际写入
```
脚本只改 `full_name`(成 `学号-姓名`),不动用户名/邮箱和团队归属;默认跳过 `admin`。
### 学期结束清理 ### 学期结束清理
```bash ```bash
+1 -1
View File
@@ -1,5 +1,5 @@
[default.gitea] [default.gitea]
url = "http://10.80.42.185:3000" url = "http://127.0.0.1:2080"
# 同学实际访问的平台地址(Apache 反代 /QA -> 127.0.0.1:2080)。 # 同学实际访问的平台地址(Apache 反代 /QA -> 127.0.0.1:2080)。
# 用于 Issue Template 等面向用户的链接; url 只用于 CLI 调 API。 # 用于 Issue Template 等面向用户的链接; url 只用于 CLI 调 API。
public_url = "https://cpp.tongji.sh/QA" public_url = "https://cpp.tongji.sh/QA"