SHA256
Compare commits
11
Commits
73ce8162aa
...
main
| Author | SHA256 | Date | |
|---|---|---|---|
|
|
9446850182 | ||
|
|
8d5c8c6bae | ||
|
|
53116f7a23 | ||
|
|
1272c1ebec | ||
|
|
487c9e8726 | ||
|
|
787481c2c8 | ||
|
|
7ff17f8b2a | ||
|
|
99547005bd | ||
|
|
438c0f4e01 | ||
|
|
c5fdbe16d6 | ||
|
|
77b9e72388 |
@@ -24,6 +24,17 @@ jobs:
|
|||||||
!contains(github.event.head_commit.message, '[skip deploy]'))
|
!contains(github.event.head_commit.message, '[skip deploy]'))
|
||||||
runs-on: self-hosted
|
runs-on: self-hosted
|
||||||
timeout-minutes: 30
|
timeout-minutes: 30
|
||||||
|
# ★ 宿主能力(docker socket、部署克隆、裸库、docker CLI)由【本 job】申报,而不是由
|
||||||
|
# runner 全局发给每个 job。runner 侧的 container.valid_volumes 是允许清单:
|
||||||
|
# 没列进去的挂载会被丢弃,所以这里的每一项都要在 deploy/runner/config.yaml 里有对应项。
|
||||||
|
# 将来加 PR 检查/测试 workflow 时,那个 job 不申报就什么都拿不到(无 socket = 无 root)。
|
||||||
|
container:
|
||||||
|
volumes:
|
||||||
|
- /home/ymy/deploy:/home/ymy/deploy # 工作目录(auto-deploy.sh 要写 .state)
|
||||||
|
- /srv/gitea:/srv/gitea:ro # deploy 克隆的 origin(本地裸库)
|
||||||
|
- /var/run/docker.sock:/var/run/docker.sock # docker compose up -d
|
||||||
|
- /usr/bin/docker:/usr/bin/docker:ro # 宿主 docker CLI
|
||||||
|
- /usr/libexec/docker/cli-plugins:/usr/libexec/docker/cli-plugins:ro # compose 插件
|
||||||
steps:
|
steps:
|
||||||
- name: 同步到目标提交
|
- name: 同步到目标提交
|
||||||
run: |
|
run: |
|
||||||
@@ -37,4 +48,7 @@ jobs:
|
|||||||
- name: 构建并部署(失败自动回滚)
|
- name: 构建并部署(失败自动回滚)
|
||||||
run: |
|
run: |
|
||||||
set -euo pipefail
|
set -euo pipefail
|
||||||
|
# 工作流没有 actions/checkout, 默认工作目录里没有代码; 上一步已把
|
||||||
|
# 部署克隆同步到目标提交, 这里必须显式 cd 过去 (2026-09-21 实际踩到)。
|
||||||
|
cd /home/ymy/deploy/tjhlp-gitea
|
||||||
./deploy/scripts/auto-deploy.sh
|
./deploy/scripts/auto-deploy.sh
|
||||||
|
|||||||
@@ -123,7 +123,8 @@ yamllint issue-templates/ # YAML 语法
|
|||||||
python3 customization/build.py # 生成定制语言文件
|
python3 customization/build.py # 生成定制语言文件
|
||||||
python3 customization/build.py --check # 校验生成物是否最新
|
python3 customization/build.py --check # 校验生成物是否最新
|
||||||
customization/preview/preview.sh up # 起本地预览(127.0.0.1:2081)
|
customization/preview/preview.sh up # 起本地预览(127.0.0.1:2081)
|
||||||
customization/preview/preview.sh check # 自动校验首页/页脚/meta/术语
|
customization/preview/preview.sh semester # 造一个学期组织, 看首页答疑入口卡片
|
||||||
|
customization/preview/preview.sh check # 自动校验首页/登录页/卡片/页脚/meta/术语
|
||||||
```
|
```
|
||||||
|
|
||||||
机制调查、日常改法与部署/升级流程见 [`customization/README.md`](customization/README.md);
|
机制调查、日常改法与部署/升级流程见 [`customization/README.md`](customization/README.md);
|
||||||
|
|||||||
+62
-13
@@ -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` |
|
||||||
@@ -106,7 +107,9 @@ customization/
|
|||||||
│ ├── templates/home.tmpl 落地页
|
│ ├── templates/home.tmpl 落地页
|
||||||
│ ├── templates/base/head_navbar.tmpl 导航栏(去掉 docs.gitea.com)
|
│ ├── templates/base/head_navbar.tmpl 导航栏(去掉 docs.gitea.com)
|
||||||
│ ├── templates/user/auth/signin.tmpl 登录页(统一身份认证优先, 管理员登录次要)
|
│ ├── templates/user/auth/signin.tmpl 登录页(统一身份认证优先, 管理员登录次要)
|
||||||
│ ├── public/assets/tjhlp/ask-guide.html 静态「提问指南」页(/assets/tjhlp/...)
|
│ ├── templates/user/dashboard/dashboard.tmpl 首页(登录后); 只比上游多一行 include
|
||||||
|
│ ├── templates/custom/tjhlp_semester_card.tmpl ★ 首页顶部的学期答疑入口卡片(自己写的)
|
||||||
|
│ ├── public/.gitkeep 占位(提问指南已只在官网, 目录留作将来放静态资源)
|
||||||
│ └── options/locale/locale_zh-CN.json 生成物,已 gitignore
|
│ └── options/locale/locale_zh-CN.json 生成物,已 gitignore
|
||||||
└── preview/ 本地预览(独立 compose,独立端口/数据)
|
└── preview/ 本地预览(独立 compose,独立端口/数据)
|
||||||
├── compose.yaml
|
├── compose.yaml
|
||||||
@@ -189,6 +192,41 @@ sg docker -c 'docker exec -u git gitea-preview gitea admin auth delete --id 1'
|
|||||||
`[service] ENABLE_PASSKEY_AUTHENTICATION = false`(两处 compose 都设了)。
|
`[service] ENABLE_PASSKEY_AUTHENTICATION = false`(两处 compose 都设了)。
|
||||||
上游那块在浏览器不支持条件中介时会渲染成一个空的方框,关掉配置连区块都不再输出。
|
上游那块在浏览器不支持条件中介时会渲染成一个空的方框,关掉配置连区块都不再输出。
|
||||||
|
|
||||||
|
### 3.5 首页(登录后)的「本学期答疑入口」卡片
|
||||||
|
|
||||||
|
登录后首页上游会给贡献热力图、最近活动、仓库列表, 对只来提问的同学是干扰。
|
||||||
|
我们在页面顶部加了一张约 1/3 屏高的卡片, 里面一个按钮直接跳到本学期答疑区。
|
||||||
|
|
||||||
|
涉及两个文件:
|
||||||
|
|
||||||
|
| 文件 | 作用 |
|
||||||
|
|---|---|
|
||||||
|
| `custom/templates/user/dashboard/dashboard.tmpl` | 覆盖上游同名模板, **只比上游多一行** `{{template "custom/tjhlp_semester_card" .}}`(插在 navbar 之后、`flex-container` 之前) |
|
||||||
|
| `custom/templates/custom/tjhlp_semester_card.tmpl` | 卡片本身(本课程自己写的, 上游没有这个文件) |
|
||||||
|
|
||||||
|
判定与规则(都在卡片文件里, 改它就行):
|
||||||
|
|
||||||
|
- 数据来自 `.Orgs` —— 当前登录用户所属的全部组织(`routers/web/user/home.go` 的 Dashboard 注入);
|
||||||
|
- 「学期组织」= 名字形如 `tjhlp-<5 位数字>`: `tjhlp-26271` 表示 26|27|1 →
|
||||||
|
2026-2027 学年第一学期; 旧命名 `tjhlp-2026s`(带字母)不认, 其它前缀(`course-team`)也不认;
|
||||||
|
- 同时匹配多个时取**名字最大**的(即最新学期), 所以同学同时在上学期/本学期组织里也只会看到本学期;
|
||||||
|
- 按钮指向 `{{AppSubUrl}}/<学期组织>/general/issues`
|
||||||
|
—— 依赖「每个学期组织都有一个 `general` 仓库」这个约定(`tjhlp setup init` 会建);
|
||||||
|
- 一个都匹配不上就**整张卡片不显示**(宁可不显示, 也不给同学一个错的入口)。
|
||||||
|
|
||||||
|
预览里怎么看:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./preview.sh admin # 先有管理员(仅首次)
|
||||||
|
./preview.sh semester # 建 tjhlp-26271 + general 仓库, 创建者即成员
|
||||||
|
# 想验证筛选规则, 再建几个干扰项: 旧的 tjhlp-25261 / 带字母的 tjhlp-2026s
|
||||||
|
./preview.sh semester previewadmin previewadmin123 tjhlp-2026s
|
||||||
|
# 然后浏览器登录 http://127.0.0.1:2081 (previewadmin / previewadmin123) 看首页
|
||||||
|
```
|
||||||
|
|
||||||
|
`./preview.sh check` 会自动登录 previewadmin 抓一次首页, 断言卡片存在、按钮指向
|
||||||
|
`<学期组织>/general/issues`、高度是 `33vh`。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 4. 纳入当前项目 & 部署
|
## 4. 纳入当前项目 & 部署
|
||||||
@@ -223,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"
|
||||||
```
|
```
|
||||||
|
|
||||||
设计取舍:
|
设计取舍:
|
||||||
@@ -241,17 +281,22 @@ GITEA_CUSTOM_DIR=../customization/custom
|
|||||||
|
|
||||||
| 位置 | 内容 | 文件 |
|
| 位置 | 内容 | 文件 |
|
||||||
| ------ | ------ | ------ |
|
| ------ | ------ | ------ |
|
||||||
| 导航栏(未登录) | 「课程官网」 | `custom/templates/base/head_navbar.tmpl` |
|
| 导航栏(未登录) | 「课程官网」/「提问指南」 | `custom/templates/base/head_navbar.tmpl` |
|
||||||
| 用户菜单(已登录) | 「课程官网」 | 同上 |
|
| 用户菜单(已登录) | 「课程官网」/「提问指南」 | 同上 |
|
||||||
| 首页「按模板提问」卡片 | 官网《学会提问》 | `custom/templates/home.tmpl` |
|
| 首页「按模板提问」卡片 | 官网《提问指南》 | `custom/templates/home.tmpl` |
|
||||||
| 首页底部「相关站点」 | 官网 / 学会提问 / 常见问题 / 联系我们 | 同上 |
|
| 首页底部「相关站点」 | 官网 / 提问指南 / 常见问题 / 联系我们 | 同上 |
|
||||||
| 站内提问指南页 | 顶部提示与底部「相关站点」 | `custom/public/assets/tjhlp/ask-guide.html` |
|
| 首页答疑入口卡片 | 官网《提问指南》 | `custom/templates/custom/tjhlp_semester_card.tmpl` |
|
||||||
| 新建 Issue 页的引导链接 | 学会提问 / 课程官网 / 平台速查 | `issue-templates/*/.gitea/ISSUE_TEMPLATE/config.yaml` |
|
| 新建 Issue 页的引导链接 | 提问指南 / 课程官网 | `issue-templates/*/.gitea/ISSUE_TEMPLATE/config.yaml` |
|
||||||
|
|
||||||
> **改地址时要一起改的地方**:官网地址 `https://cpp.tongji.sh/Website/` 在上表前三行的文件
|
官网地址 `https://cpp.tongji.sh/Website/` 出现在上表列出的模板与两个 `config.yaml` 里;
|
||||||
> 与两个 `config.yaml` 里各出现一次;平台自身地址只在
|
平台自身地址只在 `scripts/settings.toml` 的 `gitea.public_url` 里维护一处(Issue 模板里的
|
||||||
> `scripts/settings.toml` 的 `gitea.public_url` 里维护一处(Issue 模板里的
|
`{{BASE_URL}}` 在推送时替换)。
|
||||||
> `{{BASE_URL}}` 在推送时替换)。
|
|
||||||
|
> **提问指南只在官网保留一份**(`/Website/qa/ask/`):平台内原来的副本
|
||||||
|
> `custom/public/assets/tjhlp/ask-guide.html` 已在 2026-09 删除, 相关链接全部指向官网。
|
||||||
|
> 官网 2026-09 改版后的路径: 提问指南 `/Website/qa/ask/`、常见问题 `/Website/qa/faq/`、
|
||||||
|
> 联系我们 `/Website/contact.html`; 旧的 `/Website/ask-question/`、`/Website/faq/`
|
||||||
|
> 只是跳转页, `/Website/contact` 已经 404 —— 不要再写这些旧地址。
|
||||||
|
|
||||||
反向的入口(官网 → 平台)在 Website 仓库里,方案见
|
反向的入口(官网 → 平台)在 Website 仓库里,方案见
|
||||||
[`website-linkage.md`](website-linkage.md)。
|
[`website-linkage.md`](website-linkage.md)。
|
||||||
@@ -315,12 +360,16 @@ cd deploy && ./scripts/backup.sh --quiesce && docker compose pull gitea && docke
|
|||||||
- ✅ 落地页替换为定制 `home.tmpl`(4 张卡片、无 Gitea 功能介绍)
|
- ✅ 落地页替换为定制 `home.tmpl`(4 张卡片、无 Gitea 功能介绍)
|
||||||
- ✅ `[ui.meta]` 元信息替换(`GITEA__ui_0X2E_meta__*` 编码有效)
|
- ✅ `[ui.meta]` 元信息替换(`GITEA__ui_0X2E_meta__*` 编码有效)
|
||||||
- ✅ 页脚 Powered by / 版本号可关闭
|
- ✅ 页脚 Powered by / 版本号可关闭
|
||||||
- ✅ 导航栏 `docs.gitea.com` 外链替换为课程提问指南(整文件覆盖 `head_navbar.tmpl`)
|
- ✅ 导航栏 `docs.gitea.com` 外链替换为官网《提问指南》(`/Website/qa/ask/`)
|
||||||
- ✅ `custom/public/assets/tjhlp/ask-guide.html` 经 `/assets/` 正常访问
|
- ✅ 平台内 `public/assets/tjhlp/ask-guide.html` 已删除, 页面与 Issue 模板全部指向官网
|
||||||
- ✅ zh-CN 整份覆盖后,仓库 Issue 页显示「创建 Issue / 前往 Issue」,不再出现「工单」
|
- ✅ zh-CN 整份覆盖后,仓库 Issue 页显示「创建 Issue / 前往 Issue」,不再出现「工单」
|
||||||
- ✅ 语言文件在 dev 模式下改动即生效(模板仍须重启)
|
- ✅ 语言文件在 dev 模式下改动即生效(模板仍须重启)
|
||||||
- ✅ 登录页改成「统一身份认证」优先 + 「管理员登录」卡片,表单仍可正常登录/报错
|
- ✅ 登录页改成「统一身份认证」优先 + 「管理员登录」卡片,表单仍可正常登录/报错
|
||||||
- ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框
|
- ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框
|
||||||
|
- ✅ 首页(登录后)顶部出现学期答疑入口卡片: 只认 `tjhlp-<5 位数字>`、取最新学期、
|
||||||
|
无匹配则不显示(预览里用 3 个用户 × 4 个组织验证过)
|
||||||
|
- ✅ 打开 `[ui] DEFAULT_SHOW_FULL_NAME` 后, Issue 的「由 X 创建」与正文/评论作者
|
||||||
|
显示 `full_name`(姓名), 未填姓名的用户回退显示 login(学号)(预览实测)
|
||||||
|
|
||||||
尚未覆盖(需要时按同样套路加):
|
尚未覆盖(需要时按同样套路加):
|
||||||
|
|
||||||
|
|||||||
+23
-11
@@ -41,8 +41,9 @@ ok "首页可访问"
|
|||||||
|
|
||||||
grep -q "先搜索,再提问" "${tmp}/home.html" &&
|
grep -q "先搜索,再提问" "${tmp}/home.html" &&
|
||||||
ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
|
ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
|
||||||
grep -q "assets/tjhlp/ask-guide.html" "${tmp}/home.html" &&
|
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${tmp}/home.html" &&
|
||||||
ok "导航栏/首页已指向课程提问指南" || 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" &&
|
||||||
@@ -55,14 +56,16 @@ grep -q 'name="description" content="同济大学高级语言程序设计课程
|
|||||||
# --- 与课程官网的联动 -------------------------------------------------------
|
# --- 与课程官网的联动 -------------------------------------------------------
|
||||||
grep -q "https://cpp.tongji.sh/Website/" "${tmp}/home.html" &&
|
grep -q "https://cpp.tongji.sh/Website/" "${tmp}/home.html" &&
|
||||||
ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接"
|
ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接"
|
||||||
grep -q "https://cpp.tongji.sh/Website/ask-question/" "${tmp}/home.html" &&
|
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${tmp}/home.html" &&
|
||||||
ok "首页已链接官网《学会提问》" || bad "首页没有《学会提问》链接"
|
ok "首页已链接官网提问指南" || bad "首页没有官网提问指南链接"
|
||||||
if curl_ -fsS -o "${tmp}/guide.html" "${BASE_URL}/assets/tjhlp/ask-guide.html"; then
|
! grep -q "Website/ask-question/\|Website/faq/\|Website/contact\"" "${tmp}/home.html" &&
|
||||||
ok "custom/public 静态页可访问"
|
ok "没有指向官网已迁移/失效的旧地址" ||
|
||||||
grep -q "Website/ask-question/" "${tmp}/guide.html" &&
|
bad "仍有旧地址(ask-question / faq / contact 无 .html)"
|
||||||
ok "站内提问指南已回链官网" || bad "站内提问指南没有官网链接"
|
# 站内提问指南页已按决定删除: 提问指南只在官网保留一份
|
||||||
|
if curl_ -fsS -o /dev/null "${BASE_URL}/assets/tjhlp/ask-guide.html" 2>/dev/null; then
|
||||||
|
bad "平台内还留着 ask-guide.html(提问指南应只在官网)"
|
||||||
else
|
else
|
||||||
bad "提问指南静态页 404"
|
ok "平台内提问指南页已删除"
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# --- 中文术语与登录页 -------------------------------------------------------
|
# --- 中文术语与登录页 -------------------------------------------------------
|
||||||
@@ -106,10 +109,19 @@ if [[ -d ${ROOT}/issue-templates ]]; then
|
|||||||
! grep -rq "example.com" "${ROOT}/issue-templates/" &&
|
! grep -rq "example.com" "${ROOT}/issue-templates/" &&
|
||||||
ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com"
|
ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com"
|
||||||
fi
|
fi
|
||||||
if [[ -f ${ROOT}/custom/options/locale/locale_zh-CN.json ]]; then
|
if [[ -f ${ROOT}/customization/custom/options/locale/locale_zh-CN.json ]]; then
|
||||||
! grep -q "工单" "${ROOT}/custom/options/locale/locale_zh-CN.json" &&
|
! grep -q "工单" "${ROOT}/customization/custom/options/locale/locale_zh-CN.json" &&
|
||||||
ok "生成的 zh-CN 语言文件已无「工单」" || bad "语言文件里仍有「工单」"
|
ok "生成的 zh-CN 语言文件已无「工单」" || bad "语言文件里仍有「工单」"
|
||||||
fi
|
fi
|
||||||
|
# 首页(登录后)的学期答疑入口卡片: 渲染结果需要登录才能看, 这里只断言模板层
|
||||||
|
# (运行时的渲染断言在 customization/preview/preview.sh check 里, 要登录)。
|
||||||
|
if [[ -f ${ROOT}/customization/custom/templates/custom/tjhlp_semester_card.tmpl ]]; then
|
||||||
|
grep -q "本学期答疑入口" "${ROOT}/customization/custom/templates/custom/tjhlp_semester_card.tmpl" &&
|
||||||
|
ok "首页答疑入口卡片模板在位" || bad "卡片模板里没有预期的内容"
|
||||||
|
grep -q 'template "custom/tjhlp_semester_card"' \
|
||||||
|
"${ROOT}/customization/custom/templates/user/dashboard/dashboard.tmpl" &&
|
||||||
|
ok "dashboard.tmpl 已 include 学期答疑入口卡片" || bad "dashboard.tmpl 没有 include 卡片"
|
||||||
|
fi
|
||||||
|
|
||||||
if [[ ${fail} == 0 ]]; then
|
if [[ ${fail} == 0 ]]; then
|
||||||
echo "全部检查通过"
|
echo "全部检查通过"
|
||||||
|
|||||||
@@ -0,0 +1,15 @@
|
|||||||
|
# 这个文件唯一的用途: 让 git 跟踪住这个(现在)空的目录。
|
||||||
|
#
|
||||||
|
# customization/custom/ 下的三个子目录会被逐个 bind mount 进容器:
|
||||||
|
# custom/options -> /data/gitea/options
|
||||||
|
# custom/public -> /data/gitea/public
|
||||||
|
# custom/templates-> /data/gitea/templates
|
||||||
|
#
|
||||||
|
# public/ 原来放的是站内「提问指南」静态页
|
||||||
|
# (public/assets/tjhlp/ask-guide.html)。2026-09 起提问指南只在课程官网保留一份
|
||||||
|
# (https://cpp.tongji.sh/Website/qa/ask/), 平台内的副本已删除, 这个目录就空了。
|
||||||
|
# 目录不能跟着消失: bind mount 的源目录不存在时 docker compose 会【以 root 创建】它,
|
||||||
|
# 之后普通用户/CI 都用不了(同样的坑见 options/.gitkeep)。
|
||||||
|
#
|
||||||
|
# 将来要往平台里放静态资源时, 直接加在 public/ 下即可(例如
|
||||||
|
# public/assets/img/logo.svg -> /QA/assets/img/logo.svg)。
|
||||||
@@ -1,88 +0,0 @@
|
|||||||
<!DOCTYPE html>
|
|
||||||
<html lang="zh-CN">
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8">
|
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
||||||
<title>提问指南 - 同济大学高级语言程序设计课程</title>
|
|
||||||
<!--
|
|
||||||
静态页, 通过 Gitea 的 custom/public/assets/ 机制对外提供:
|
|
||||||
customization/custom/public/assets/tjhlp/ask-guide.html
|
|
||||||
-> {{AppSubUrl}}/assets/tjhlp/ask-guide.html
|
|
||||||
Gitea 只对 custom/public 下的 robots.txt、.well-known/ 和 assets/ 做静态服务。
|
|
||||||
本页不依赖 Gitea 的 JS/CSS, 可离线打开, 便于直接改文案。
|
|
||||||
-->
|
|
||||||
<style>
|
|
||||||
:root { color-scheme: light dark; }
|
|
||||||
body {
|
|
||||||
margin: 0 auto; padding: 2.5rem 1.25rem 4rem; max-width: 46rem;
|
|
||||||
font: 16px/1.75 -apple-system, "Segoe UI", "Noto Sans CJK SC", "Microsoft YaHei", sans-serif;
|
|
||||||
}
|
|
||||||
h1 { font-size: 1.75rem; margin-bottom: .25rem; }
|
|
||||||
h2 { font-size: 1.15rem; margin-top: 2.25rem; border-bottom: 1px solid #8884; padding-bottom: .35rem; }
|
|
||||||
code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; background: #888280; padding: .1em .35em; border-radius: 4px; }
|
|
||||||
.lead { color: #666; margin-top: 0; }
|
|
||||||
table { border-collapse: collapse; width: 100%; }
|
|
||||||
th, td { text-align: left; padding: .45rem .6rem; border-bottom: 1px solid #8883; vertical-align: top; }
|
|
||||||
.tip { border-left: 3px solid #3b82f6; background: #3b82f614; padding: .75rem 1rem; border-radius: 0 6px 6px 0; }
|
|
||||||
ol, ul { padding-left: 1.4rem; }
|
|
||||||
</style>
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<h1>提问指南</h1>
|
|
||||||
<p class="lead">同济大学高级语言程序设计课程 · 课程答疑平台</p>
|
|
||||||
|
|
||||||
<div class="tip">
|
|
||||||
提问规范以课程官网的<a href="https://cpp.tongji.sh/Website/ask-question/">《学会提问》</a>为准,
|
|
||||||
本页是它在答疑平台里的速查版。遇到问题请先看
|
|
||||||
<a href="https://cpp.tongji.sh/Website/faq/">官网常见问题</a>与
|
|
||||||
<a href="https://cpp.tongji.sh/Website/">课程官网</a>上的作业说明。
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<h2>提问前</h2>
|
|
||||||
<ol>
|
|
||||||
<li>在答疑仓库的 Issue 列表里用关键词(题号、函数名、报错信息)搜索,确认没有人问过。</li>
|
|
||||||
<li>自己先调试一遍:编译是否通过、报错信息是什么、最小复现是哪几行。</li>
|
|
||||||
<li>确认问题出在<strong>课程要求</strong>或<strong>你的代码</strong>,而不是环境没有按要求配置。</li>
|
|
||||||
</ol>
|
|
||||||
|
|
||||||
<h2>如何提问</h2>
|
|
||||||
<p>在对应仓库点击 <code>创建 Issue</code>,选择合适的模板后按模板填写:</p>
|
|
||||||
<ul>
|
|
||||||
<li><strong>题目信息</strong>:作业编号、题号、题目要求的关键点。</li>
|
|
||||||
<li><strong>相关代码</strong>:只贴必要片段,用代码块包裹,说明你期望的结果。</li>
|
|
||||||
<li><strong>实际现象</strong>:完整报错信息或错误输出(不要只截图,文字更便于检索)。</li>
|
|
||||||
<li><strong>已尝试的做法</strong>:查过什么资料、改过什么、结果如何。</li>
|
|
||||||
</ul>
|
|
||||||
<div class="tip">提问写得越具体,助教越容易直接定位问题;「我的代码不对,帮忙看看」这类问题通常只能得到「请补充信息」的回复。</div>
|
|
||||||
|
|
||||||
<h2>仓库与标签</h2>
|
|
||||||
<table>
|
|
||||||
<thead><tr><th>位置</th><th>用途</th></tr></thead>
|
|
||||||
<tbody>
|
|
||||||
<tr><td><code>general</code></td><td>课程内容、环境配置等一般性问题</td></tr>
|
|
||||||
<tr><td><code>hwNN</code></td><td>第 NN 次作业的特定问题</td></tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<p>助教会用标签标记处理状态,常见含义:</p>
|
|
||||||
<ul>
|
|
||||||
<li><strong>重复</strong>:已有同样的问题,请到原 Issue 继续讨论。</li>
|
|
||||||
<li><strong>待补充信息</strong>:描述不足以定位,请按提示补充。</li>
|
|
||||||
<li><strong>已解决</strong>:问题已答复,请确认后自行关闭。</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h2>其它</h2>
|
|
||||||
<ul>
|
|
||||||
<li>不要在 Issue 里粘贴完整的学号、密码等个人信息。</li>
|
|
||||||
<li>作业截止前是提问高峰,助教按时间顺序处理,请耐心等待。</li>
|
|
||||||
<li>与个人成绩、抄袭认定相关的事情请直接联系老师,不要发在公开 Issue 里。</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h2>相关站点</h2>
|
|
||||||
<ul>
|
|
||||||
<li><a href="https://cpp.tongji.sh/Website/">课程官网</a>:课程信息、作业说明、环境配置、扩展阅读。</li>
|
|
||||||
<li><a href="https://cpp.tongji.sh/Website/ask-question/">学会提问</a>:完整的提问规范,提问前请通读。</li>
|
|
||||||
<li><a href="https://cpp.tongji.sh/Website/faq/">常见问题</a>:中文乱码、Visual Studio 配置等高频问题。</li>
|
|
||||||
<li><a href="https://cpp.tongji.sh/Website/contact">联系我们</a>:网站问题与课程团队联系方式。</li>
|
|
||||||
</ul>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
@@ -43,7 +43,7 @@
|
|||||||
|
|
||||||
{{if not .IsSigned}}
|
{{if not .IsSigned}}
|
||||||
<a class="item" href="https://cpp.tongji.sh/Website/">课程官网</a>
|
<a class="item" href="https://cpp.tongji.sh/Website/">课程官网</a>
|
||||||
<a class="item" href="{{AppSubUrl}}/assets/tjhlp/ask-guide.html">提问指南</a>
|
<a class="item" href="https://cpp.tongji.sh/Website/qa/ask/">提问指南</a>
|
||||||
{{end}}
|
{{end}}
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
@@ -126,7 +126,7 @@
|
|||||||
{{svg "octicon-tools"}}
|
{{svg "octicon-tools"}}
|
||||||
{{ctx.Locale.Tr "your_settings"}}
|
{{ctx.Locale.Tr "your_settings"}}
|
||||||
</a>
|
</a>
|
||||||
<a class="item" href="{{AppSubUrl}}/assets/tjhlp/ask-guide.html">
|
<a class="item" href="https://cpp.tongji.sh/Website/qa/ask/">
|
||||||
{{svg "octicon-question"}}
|
{{svg "octicon-question"}}
|
||||||
提问指南
|
提问指南
|
||||||
</a>
|
</a>
|
||||||
|
|||||||
@@ -0,0 +1,56 @@
|
|||||||
|
{{/*
|
||||||
|
首页(登录后的仪表盘)顶部的「本学期答疑入口」大卡片。
|
||||||
|
这是本课程自己的模板, 不是上游文件; 插入点见
|
||||||
|
custom/templates/user/dashboard/dashboard.tmpl(只比上游多一行 include)。
|
||||||
|
|
||||||
|
逻辑:
|
||||||
|
* .Orgs = 当前用户所属的全部组织, 由 routers/web/user/home.go 的 Dashboard
|
||||||
|
处理器注入(organization.GetUserOrgsList, 按 lower_name 升序);
|
||||||
|
* 「学期组织」的判定 = 名字形如 tjhlp-<5 位数字>, 例如
|
||||||
|
tjhlp-26271 = 2026-2027 学年第一学期(26|27|1)
|
||||||
|
旧命名 tjhlp-2026s 这种带字母的不算, 也不认其它前缀的组织;
|
||||||
|
* 取其中名字最大(即最新学期)的一个;
|
||||||
|
* 渲染成一张约 1/3 屏高的大卡片, 按钮直达该组织的 general 仓库 Issue 区。
|
||||||
|
|
||||||
|
匹配不上就整张卡片不显示: 宁可什么都不显示, 也不要给同学一个错的入口。
|
||||||
|
改判定规则/文案只需要动这个文件(不要动 dashboard.tmpl 的其余部分)。
|
||||||
|
*/}}
|
||||||
|
{{$semester := ""}}
|
||||||
|
{{range .Orgs}}
|
||||||
|
{{$name := .Name}}
|
||||||
|
{{$code := StringUtils.TrimPrefix $name "tjhlp-"}}
|
||||||
|
{{if and
|
||||||
|
(ne $code $name)
|
||||||
|
(eq (len $code) 5)
|
||||||
|
(StringUtils.Contains "0123456789" (slice $code 0 1))
|
||||||
|
(StringUtils.Contains "0123456789" (slice $code 1 2))
|
||||||
|
(StringUtils.Contains "0123456789" (slice $code 2 3))
|
||||||
|
(StringUtils.Contains "0123456789" (slice $code 3 4))
|
||||||
|
(StringUtils.Contains "0123456789" (slice $code 4 5))}}
|
||||||
|
{{if or (eq $semester "") (gt $name $semester)}}{{$semester = $name}}{{end}}
|
||||||
|
{{end}}
|
||||||
|
{{end}}
|
||||||
|
{{if $semester}}
|
||||||
|
{{$code := StringUtils.TrimPrefix $semester "tjhlp-"}}
|
||||||
|
{{$term := slice $code 4 5}}
|
||||||
|
{{$termText := printf "第%s学期" $term}}
|
||||||
|
{{if eq $term "1"}}{{$termText = "第一学期"}}{{else if eq $term "2"}}{{$termText = "第二学期"}}{{end}}
|
||||||
|
{{$label := printf "20%s-20%s 学年%s" (slice $code 0 2) (slice $code 2 4) $termText}}
|
||||||
|
<div class="ui container tw-mb-4">
|
||||||
|
{{/* 33vh ≈ 屏幕纵向的 1/3; 用行内样式, 不依赖 Tailwind 是否收录了某个工具类 */}}
|
||||||
|
<div class="ui segment" style="min-height:33vh;display:flex;flex-direction:column;justify-content:center;align-items:center;text-align:center;gap:1rem;padding:1.5rem 1rem">
|
||||||
|
<h2 style="margin:0">本学期答疑入口</h2>
|
||||||
|
<p style="margin:0;color:var(--color-text-light-2)">
|
||||||
|
课程问题请进入下面的答疑区提问(一条 Issue 一个问题), 助教与老师会在那里回复。
|
||||||
|
</p>
|
||||||
|
<a class="ui primary fluid button" style="font-size:1.35rem;padding:1rem;max-width:34rem"
|
||||||
|
href="{{AppSubUrl}}/{{$semester}}/general/issues">
|
||||||
|
进入{{$label}}答疑区
|
||||||
|
</a>
|
||||||
|
<p style="margin:0;color:var(--color-text-light-2)">
|
||||||
|
第一次提问? 先看课程官网的<a href="https://cpp.tongji.sh/Website/qa/ask/">提问指南</a>
|
||||||
|
</p>
|
||||||
|
<p style="margin:0;color:var(--color-text-light-3);font-size:.85rem">学期组织: {{$semester}}</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{{end}}
|
||||||
@@ -7,9 +7,10 @@
|
|||||||
* 文案直接写中文(平台只面向中文用户), 不复用 Gitea 的 startpage.* 文案,
|
* 文案直接写中文(平台只面向中文用户), 不复用 Gitea 的 startpage.* 文案,
|
||||||
这样首页不再出现「一款极易搭建的自托管 Git 服务」之类的自我推销。
|
这样首页不再出现「一款极易搭建的自托管 Git 服务」之类的自我推销。
|
||||||
* 只改文案/图标/链接, 保留原有 class 与结构, 避免升级后样式失效。
|
* 只改文案/图标/链接, 保留原有 class 与结构, 避免升级后样式失效。
|
||||||
* 课程官网地址 https://cpp.tongji.sh/Website/ 在本文件、base/head_navbar.tmpl、
|
* 课程官网地址 https://cpp.tongji.sh/Website/ 出现在本文件、base/head_navbar.tmpl、
|
||||||
public/assets/tjhlp/ask-guide.html 以及 issue-templates 下两个 config.yaml 里
|
custom/tjhlp_semester_card.tmpl 以及 issue-templates 下两个 config.yaml 里,
|
||||||
各出现一次, 换域名/路径时这几处要一起改(见 customization/README.md「与官网联动」)。
|
换域名/路径时这几处要一起改(见 customization/README.md「与官网联动」)。
|
||||||
|
提问指南只在官网存一份: /Website/qa/ask/ —— 平台内不再保留副本(2026-09 起)。
|
||||||
*/}}
|
*/}}
|
||||||
{{template "base/head" .}}
|
{{template "base/head" .}}
|
||||||
<div role="main" aria-label="{{if .IsSigned}}{{ctx.Locale.Tr "dashboard"}}{{else}}{{ctx.Locale.Tr "home_title"}}{{end}}" class="page-content home">
|
<div role="main" aria-label="{{if .IsSigned}}{{ctx.Locale.Tr "dashboard"}}{{else}}{{ctx.Locale.Tr "home_title"}}{{end}}" class="page-content home">
|
||||||
@@ -41,8 +42,8 @@
|
|||||||
</h1>
|
</h1>
|
||||||
<p class="large tw-text-balance">
|
<p class="large tw-text-balance">
|
||||||
新建 Issue 时请选择合适的模板,写清题号、相关代码、报错信息和已经尝试过的做法。
|
新建 Issue 时请选择合适的模板,写清题号、相关代码、报错信息和已经尝试过的做法。
|
||||||
提问规范见课程官网<a href="https://cpp.tongji.sh/Website/ask-question/">《学会提问》</a>,
|
提问规范与具体做法见课程官网的
|
||||||
平台操作见<a href="{{AppSubUrl}}/assets/tjhlp/ask-guide.html">提问指南</a>。
|
<a href="https://cpp.tongji.sh/Website/qa/ask/">《提问指南》</a>。
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -70,9 +71,9 @@
|
|||||||
<p class="large">
|
<p class="large">
|
||||||
相关站点:
|
相关站点:
|
||||||
<a href="https://cpp.tongji.sh/Website/">课程官网</a> ·
|
<a href="https://cpp.tongji.sh/Website/">课程官网</a> ·
|
||||||
<a href="https://cpp.tongji.sh/Website/ask-question/">学会提问</a> ·
|
<a href="https://cpp.tongji.sh/Website/qa/ask/">提问指南</a> ·
|
||||||
<a href="https://cpp.tongji.sh/Website/faq/">常见问题</a> ·
|
<a href="https://cpp.tongji.sh/Website/qa/faq/">常见问题</a> ·
|
||||||
<a href="https://cpp.tongji.sh/Website/contact">联系我们</a>
|
<a href="https://cpp.tongji.sh/Website/contact.html">联系我们</a>
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
<small>本平台只用于课程答疑,课程通知、作业要求等以课程官网与课程群为准。</small>
|
<small>本平台只用于课程答疑,课程通知、作业要求等以课程官网与课程群为准。</small>
|
||||||
|
|||||||
@@ -0,0 +1,22 @@
|
|||||||
|
{{template "base/head" .}}
|
||||||
|
<div role="main" aria-label="{{.Title}}" class="page-content dashboard feeds">
|
||||||
|
{{template "user/dashboard/navbar" .}}
|
||||||
|
{{/* ★ 本课程新增(上游没有这一行): 首页顶部的「本学期答疑入口」卡片。
|
||||||
|
卡片内容在 custom/templates/custom/tjhlp_semester_card.tmpl;
|
||||||
|
升级 Gitea 时先 diff upstream/<版本>/templates/user/dashboard/dashboard.tmpl,
|
||||||
|
确认上游结构变化后把这一行重新插到 navbar 之后即可。 */}}
|
||||||
|
{{template "custom/tjhlp_semester_card" .}}
|
||||||
|
<div class="ui container flex-container">
|
||||||
|
<div class="flex-container-main">
|
||||||
|
{{template "base/alert" .}}
|
||||||
|
{{template "user/heatmap" .}}
|
||||||
|
{{if .Page.Paginater.TotalPages}}
|
||||||
|
{{template "user/dashboard/feeds" .}}
|
||||||
|
{{else}}
|
||||||
|
{{template "user/dashboard/guide" .}}
|
||||||
|
{{end}}
|
||||||
|
</div>
|
||||||
|
{{template "user/dashboard/repolist" .}}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{{template "base/footer" .}}
|
||||||
@@ -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}
|
||||||
|
|
||||||
|
|||||||
@@ -8,6 +8,7 @@
|
|||||||
# ./preview.sh ps 查看状态
|
# ./preview.sh ps 查看状态
|
||||||
# ./preview.sh shell 进入容器
|
# ./preview.sh shell 进入容器
|
||||||
# ./preview.sh admin 在预览实例里建一个管理员(用于验证登录后的页面)
|
# ./preview.sh admin 在预览实例里建一个管理员(用于验证登录后的页面)
|
||||||
|
# ./preview.sh semester 造一个学期组织(含 general 仓库), 用于看首页的答疑入口卡片
|
||||||
# ./preview.sh check 构建校验 + 首页文案/页脚/元信息抽查
|
# ./preview.sh check 构建校验 + 首页文案/页脚/元信息抽查
|
||||||
#
|
#
|
||||||
# 说明: 本机 docker 需要 docker 组权限; 当前 shell 没有时会自动改用
|
# 说明: 本机 docker 需要 docker 组权限; 当前 shell 没有时会自动改用
|
||||||
@@ -86,6 +87,31 @@ admin)
|
|||||||
--email "${USERNAME}@example.com" --admin --must-change-password=false
|
--email "${USERNAME}@example.com" --admin --must-change-password=false
|
||||||
echo "管理员: ${USERNAME} / ${PASSWORD}"
|
echo "管理员: ${USERNAME} / ${PASSWORD}"
|
||||||
;;
|
;;
|
||||||
|
semester)
|
||||||
|
# 造一个学期组织 + general 仓库, 用来在预览里验证首页(登录后)的答疑入口卡片。
|
||||||
|
# 幂等: 已存在就跳过。默认建 tjhlp-26271(2026-2027 学年第一学期 的命名),
|
||||||
|
# 想验证"只认最新学期/不认旧命名"可以再建几个:
|
||||||
|
# ./preview.sh semester previewadmin previewadmin123 tjhlp-25261
|
||||||
|
# ./preview.sh semester previewadmin previewadmin123 tjhlp-2026s
|
||||||
|
USERNAME="${2:-previewadmin}"
|
||||||
|
PASSWORD="${3:-previewadmin123}"
|
||||||
|
ORG="${4:-tjhlp-26271}"
|
||||||
|
api() { curl -fsS --noproxy '*' -u "${USERNAME}:${PASSWORD}" -H 'Content-Type: application/json' "$@"; }
|
||||||
|
if api "${BASE_URL}/api/v1/orgs/${ORG}" >/dev/null 2>&1; then
|
||||||
|
echo "组织 ${ORG} 已存在, 跳过创建"
|
||||||
|
else
|
||||||
|
api -X POST -d "{\"username\":\"${ORG}\",\"full_name\":\"${ORG}\"}" "${BASE_URL}/api/v1/orgs" >/dev/null
|
||||||
|
echo "已创建组织 ${ORG}(创建者即成员, 也就是 ${USERNAME})"
|
||||||
|
fi
|
||||||
|
if api "${BASE_URL}/api/v1/repos/${ORG}/general" >/dev/null 2>&1; then
|
||||||
|
echo "仓库 ${ORG}/general 已存在"
|
||||||
|
else
|
||||||
|
api -X POST -d '{"name":"general","auto_init":true,"private":true}' \
|
||||||
|
"${BASE_URL}/api/v1/orgs/${ORG}/repos" >/dev/null
|
||||||
|
echo "已创建仓库 ${ORG}/general"
|
||||||
|
fi
|
||||||
|
echo "用 ${USERNAME} 登录 ${BASE_URL} 看首页卡片; 期望按钮指向 ${ORG}/general/issues"
|
||||||
|
;;
|
||||||
check)
|
check)
|
||||||
python3 "${ROOT}/build.py" --check --quiet
|
python3 "${ROOT}/build.py" --check --quiet
|
||||||
fail=0
|
fail=0
|
||||||
@@ -100,7 +126,9 @@ check)
|
|||||||
curl -fsS "${BASE_URL}/" -o "${html}"
|
curl -fsS "${BASE_URL}/" -o "${html}"
|
||||||
|
|
||||||
grep -q "先搜索,再提问" "${html}" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
|
grep -q "先搜索,再提问" "${html}" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
|
||||||
grep -q "assets/tjhlp/ask-guide.html" "${html}" && ok "导航栏/首页已指向课程提问指南" || bad "没找到提问指南链接"
|
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${html}" &&
|
||||||
|
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"
|
||||||
@@ -108,18 +136,18 @@ check)
|
|||||||
grep -q 'name="description" content="同济大学高级语言程序设计课程答疑平台"' "${html}" &&
|
grep -q 'name="description" content="同济大学高级语言程序设计课程答疑平台"' "${html}" &&
|
||||||
ok "meta description 已替换" || bad "meta description 未替换"
|
ok "meta description 已替换" || bad "meta description 未替换"
|
||||||
|
|
||||||
curl -fsS -o /dev/null "${BASE_URL}/assets/tjhlp/ask-guide.html" &&
|
# 站内提问指南页已按决定删除(提问指南只在官网保留一份)
|
||||||
ok "custom/public 静态页可访问" || bad "提问指南静态页 404"
|
! curl -fsS -o /dev/null "${BASE_URL}/assets/tjhlp/ask-guide.html" 2>/dev/null &&
|
||||||
|
ok "平台内提问指南页已删除" || bad "平台内还留着 ask-guide.html"
|
||||||
|
|
||||||
# --- 与课程官网的联动 -------------------------------------------------
|
# --- 与课程官网的联动 -------------------------------------------------
|
||||||
grep -q "https://cpp.tongji.sh/Website/" "${html}" &&
|
grep -q "https://cpp.tongji.sh/Website/" "${html}" &&
|
||||||
ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接"
|
ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接"
|
||||||
grep -q "https://cpp.tongji.sh/Website/ask-question/" "${html}" &&
|
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${html}" &&
|
||||||
ok "首页已链接官网《学会提问》" || bad "首页没有《学会提问》链接"
|
ok "首页已链接官网提问指南" || bad "首页没有官网提问指南链接"
|
||||||
guide="$(mktemp)"
|
! grep -q "Website/ask-question/\|Website/faq/\|Website/contact\"" "${html}" &&
|
||||||
curl -fsS "${BASE_URL}/assets/tjhlp/ask-guide.html" -o "${guide}"
|
ok "没有指向官网已迁移/失效的旧地址" ||
|
||||||
grep -q "Website/ask-question/" "${guide}" && ok "站内提问指南已回链官网" || bad "站内提问指南没有官网链接"
|
bad "仍有旧地址(ask-question / faq / contact 无 .html)"
|
||||||
rm -f "${guide}"
|
|
||||||
! grep -rq "example.com" "${ROOT}/../issue-templates/" &&
|
! grep -rq "example.com" "${ROOT}/../issue-templates/" &&
|
||||||
ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com"
|
ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com"
|
||||||
|
|
||||||
@@ -137,6 +165,29 @@ check)
|
|||||||
echo " (提示: 预览未配置认证源, 登录页不显示统一身份认证按钮; 见 customization/README.md 3.4)"
|
echo " (提示: 预览未配置认证源, 登录页不显示统一身份认证按钮; 见 customization/README.md 3.4)"
|
||||||
rm -f "${login}"
|
rm -f "${login}"
|
||||||
|
|
||||||
|
# --- 首页(登录后)的「本学期答疑入口」卡片 -----------------------------
|
||||||
|
# 预览里没有管理员/学期组织时会跳过(只提示), 不算失败。
|
||||||
|
cj="$(mktemp)"
|
||||||
|
dash="$(mktemp)"
|
||||||
|
trap 'rm -f "${html}" "${cj}" "${dash}"' EXIT
|
||||||
|
curl -fsS -c "${cj}" -b "${cj}" -X POST \
|
||||||
|
--data-urlencode "user_name=${PREVIEW_ADMIN_USER:-previewadmin}" \
|
||||||
|
--data-urlencode "password=${PREVIEW_ADMIN_PASSWORD:-previewadmin123}" \
|
||||||
|
"${BASE_URL}/user/login" -o /dev/null || true
|
||||||
|
curl -fsS -b "${cj}" "${BASE_URL}/" -o "${dash}" || true
|
||||||
|
if ! grep -q 'class="page-content dashboard' "${dash}"; then
|
||||||
|
echo " (提示: 预览里没有可登录的 previewadmin; 跑 ./preview.sh admin 后再检查登录后页面)"
|
||||||
|
elif grep -q "本学期答疑入口" "${dash}"; then
|
||||||
|
ok "首页(登录后)有「本学期答疑入口」卡片"
|
||||||
|
grep -q "/tjhlp-[0-9]\{5\}/general/issues" "${dash}" &&
|
||||||
|
ok "卡片按钮指向 <学期组织>/general/issues" ||
|
||||||
|
bad "卡片按钮链接不是 <学期组织>/general/issues"
|
||||||
|
grep -q "min-height:33vh" "${dash}" &&
|
||||||
|
ok "卡片高度约 1/3 屏(33vh)" || bad "卡片没有 33vh 高度"
|
||||||
|
else
|
||||||
|
echo " (提示: 当前登录用户不属于任何学期组织 => 卡片不显示; 跑 ./preview.sh semester 造一个)"
|
||||||
|
fi
|
||||||
|
|
||||||
[ "${fail}" = 0 ] && echo "全部检查通过" || echo "存在检查未通过项"
|
[ "${fail}" = 0 ] && echo "全部检查通过" || echo "存在检查未通过项"
|
||||||
exit "${fail}"
|
exit "${fail}"
|
||||||
;;
|
;;
|
||||||
|
|||||||
@@ -8,3 +8,4 @@ options/locale/locale_zh-CN.json
|
|||||||
templates/home.tmpl
|
templates/home.tmpl
|
||||||
templates/base/head_navbar.tmpl
|
templates/base/head_navbar.tmpl
|
||||||
templates/user/auth/signin.tmpl
|
templates/user/auth/signin.tmpl
|
||||||
|
templates/user/dashboard/dashboard.tmpl
|
||||||
|
|||||||
@@ -0,0 +1,17 @@
|
|||||||
|
{{template "base/head" .}}
|
||||||
|
<div role="main" aria-label="{{.Title}}" class="page-content dashboard feeds">
|
||||||
|
{{template "user/dashboard/navbar" .}}
|
||||||
|
<div class="ui container flex-container">
|
||||||
|
<div class="flex-container-main">
|
||||||
|
{{template "base/alert" .}}
|
||||||
|
{{template "user/heatmap" .}}
|
||||||
|
{{if .Page.Paginater.TotalPages}}
|
||||||
|
{{template "user/dashboard/feeds" .}}
|
||||||
|
{{else}}
|
||||||
|
{{template "user/dashboard/guide" .}}
|
||||||
|
{{end}}
|
||||||
|
</div>
|
||||||
|
{{template "user/dashboard/repolist" .}}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{{template "base/footer" .}}
|
||||||
@@ -68,9 +68,15 @@
|
|||||||
Gitea 默认落地页(「一款极易搭建的自托管 Git 服务」), 定制上线后平台首页已换成答疑
|
Gitea 默认落地页(「一款极易搭建的自托管 Git 服务」), 定制上线后平台首页已换成答疑
|
||||||
平台介绍; 若截图里出现过「工单」字样也与现在的 「Issue」不一致。建议定制上线后按同样
|
平台介绍; 若截图里出现过「工单」字样也与现在的 「Issue」不一致。建议定制上线后按同样
|
||||||
流程重拍、**文件名不变**地替换, 这样正文不用改。
|
流程重拍、**文件名不变**地替换, 这样正文不用改。
|
||||||
11. **内容重复**:官网《学会提问》与平台内 `/assets/tjhlp/ask-guide.html` 有重叠。平台侧
|
11. **内容重复(已在平台侧处理完)**:官网提问指南与平台内的副本曾有重叠。2026-09 起
|
||||||
已把官网定为权威版本(站内页顶部注明"以官网为准"并给出链接), 官网页不必反向复制平台
|
**提问指南只在官网保留一份**(`/Website/qa/ask/`), 平台内的
|
||||||
操作细节, 链接到 `/faq/gitea/` 即可。
|
`/assets/tjhlp/ask-guide.html` 已删除, 平台页面与 Issue 模板的引导链接全部指向官网;
|
||||||
|
官网页因此不必再考虑与平台副本同步的问题。
|
||||||
|
|
||||||
|
> **2026-09 官网改版后的路径**:提问指南 `/Website/qa/ask/`、常见问题 `/Website/qa/faq/`、
|
||||||
|
> 联系我们 `/Website/contact.html`。旧的 `/Website/ask-question/`、`/Website/faq/` 已变成
|
||||||
|
> 跳转页, `/Website/contact` 已经 404。本文下面几节写于改版前, 里面的
|
||||||
|
> `/ask-question/`、`/contact.md` 等路径按新路径理解(PR #52 也要相应更新)。
|
||||||
|
|
||||||
## 3. 建议改动(可直接套用)
|
## 3. 建议改动(可直接套用)
|
||||||
|
|
||||||
|
|||||||
+72
-7
@@ -197,15 +197,40 @@
|
|||||||
> sudo rm -rf customization/custom/options # 空的 root 目录, 删掉即可
|
> sudo rm -rf customization/custom/options # 空的 root 目录, 删掉即可
|
||||||
> ```
|
> ```
|
||||||
>
|
>
|
||||||
> **⚠️ 8. act_runner 的 job 容器不要自己挂 `docker.sock`。**
|
> **⚠️ 8. `docker.sock` 怎么挂:`docker_host: "-"` 与"job 自己申报"是配套的一对。**
|
||||||
> act_runner 会把 docker daemon socket **自动**挂进 job 容器(`container.docker_host` 的默认
|
> 默认行为是 act_runner 把 docker daemon socket **自动**挂进 job 容器 —— 等于这个 runner 上的
|
||||||
> 行为); 再在 `deploy/runner/config.yaml` 的 `container.options` 里挂一次, 第一次真实部署
|
> **每个** job 都白拿 docker(= root 等价)。现在把这份能力收窄成"要用 docker 的 job 自己申报":
|
||||||
> 就会以这个错误告终:
|
> ```yaml
|
||||||
|
> # deploy/runner/config.yaml —— runner 侧: 不自动挂, 并给申报加白名单
|
||||||
|
> container:
|
||||||
|
> docker_host: "-" # 自动找 daemon, 但不挂进 job 容器
|
||||||
|
> valid_volumes: [...] # job 申报的挂载必须在这个表里
|
||||||
|
> ```
|
||||||
|
> ```yaml
|
||||||
|
> # .gitea/workflows/deploy.yml —— job 侧: 只给需要它的那个 job
|
||||||
|
> container:
|
||||||
|
> volumes:
|
||||||
|
> - /var/run/docker.sock:/var/run/docker.sock
|
||||||
|
> ```
|
||||||
|
> ⚠️ **两者必须成对**: 只写 `volumes` 而没有 `docker_host: "-"`, 就会和自动挂载撞成
|
||||||
> ```
|
> ```
|
||||||
> failed to create container: 'Duplicate mount point: /var/run/docker.sock'
|
> failed to create container: 'Duplicate mount point: /var/run/docker.sock'
|
||||||
> ```
|
> ```
|
||||||
> 2026-09-13 用 `act_runner exec` 预演 job 时提前发现。`container.options` 里只保留
|
> (2026-09-13 用 `act_runner exec` 预演时第一次踩到。注意 `exec` 有自己的
|
||||||
> 部署克隆(同路径)、宿主 docker CLI、compose 插件这三项。
|
> `--container-daemon-socket` 默认值、**不读**配置里的 `docker_host`, 所以用 exec 预演时
|
||||||
|
> 这个错会一直出现 —— 它验证不了这一项。)
|
||||||
|
>
|
||||||
|
> **⚠️ 10. `valid_volumes` 会静默丢掉挂载。**
|
||||||
|
> job 申报的 `container.volumes`(以及全局 `options` 里的 `--volume`)都必须出现在
|
||||||
|
> `container.valid_volumes` 里, 否则 act_runner 只打一行
|
||||||
|
> `... is not a valid volume, will be ignored` 就把它丢掉, **job 照常往下跑** —— 现象是容器里
|
||||||
|
> 少了个目录, 而不是报错。2026-09-21 就因此让部署 job 的
|
||||||
|
> `cd /home/ymy/deploy/tjhlp-gitea` 失败。排查两行命令:
|
||||||
|
> ```bash
|
||||||
|
> docker exec gitea-runner sed -n '/valid_volumes/,+6p' /config/config.yaml
|
||||||
|
> docker inspect $(docker ps -q --filter name=GITEA-ACTIONS) \
|
||||||
|
> --format '{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"\n"}}{{end}}'
|
||||||
|
> ```
|
||||||
>
|
>
|
||||||
> **⚠️ 9. 宿主 `/usr/bin/python3` 是 3.6, 别让它排到 PATH 前面。**
|
> **⚠️ 9. 宿主 `/usr/bin/python3` 是 3.6, 别让它排到 PATH 前面。**
|
||||||
> `customization/build.py` 用了 `from __future__ import annotations`, 需要 ≥3.7。
|
> `customization/build.py` 用了 `from __future__ import annotations`, 需要 ≥3.7。
|
||||||
@@ -791,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` 重新挂载 |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -858,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 反代路径不变, 同时消除直连暴露面 |
|
||||||
@@ -867,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'` 更省事, 不必动服务器。
|
||||||
|
|
||||||
**迁移中发现并处理的既有问题**:
|
**迁移中发现并处理的既有问题**:
|
||||||
|
|
||||||
| # | 问题 | 证据 | 处理 |
|
| # | 问题 | 证据 | 处理 |
|
||||||
|
|||||||
+170
-70
@@ -19,33 +19,45 @@
|
|||||||
不在本方案范围内:Gitea 版本升级(要备份 + 数据库迁移,仍走 [README §7](README.md) 人工流程)、
|
不在本方案范围内:Gitea 版本升级(要备份 + 数据库迁移,仍走 [README §7](README.md) 人工流程)、
|
||||||
`issue-templates` 重新推送(运营操作)、官网仓库(`Website`)的部署(那是 GitHub Actions 的事)。
|
`issue-templates` 重新推送(运营操作)、官网仓库(`Website`)的部署(那是 GitHub Actions 的事)。
|
||||||
|
|
||||||
### 0.1 落地现状与剩余动作(2026-09-13)
|
### 0.1 落地现状与剩余动作(更新到 2026-09-22)
|
||||||
|
|
||||||
已完成并验证:
|
**CI/CD 已上线跑通。** `action_run` 表里共 5 次运行:前几次是打通路上的跳过/失败,最新一次
|
||||||
|
(HEAD `9954700`)`status=1`(=Success),`deploy/.state/last-deployed` = `9954700` —— 生产
|
||||||
|
就是 CI 部署的版本。
|
||||||
|
|
||||||
| 项 | 证据 |
|
| 项 | 证据 |
|
||||||
|---|---|
|
|---|---|
|
||||||
| 部署克隆 `/home/ymy/deploy/tjhlp-gitea`(`origin` = 本机裸仓库,免凭据) | `git remote -v`;`deploy/.env` 600;工作树干净 |
|
| 部署克隆 `/home/ymy/deploy/tjhlp-gitea`(`origin` = 本机裸仓库,免凭据) | `git remote -v`;`deploy/.env` 600 |
|
||||||
| runner 已注册 | `action_runner` 表:`tjhlp-gitea-1 / v0.6.1 / ["self-hosted"]`;日志 `declare successfully` |
|
| runner 已注册 | `action_runner`:`tjhlp-gitea-1 / v0.6.1 / ["self-hosted"]` |
|
||||||
| 生产已切到部署克隆 | `docker inspect gitea` 的三个挂载源都指向 `/home/ymy/deploy/tjhlp-gitea/...` |
|
| 生产由 CI 部署 | `last-deployed` = HEAD 的 SHA;`action_run` 最新一次 `status=1` |
|
||||||
| 部署脚本本机跑通(回滚被真实触发过两次) | `auto-deploy.sh` → `build.py` → `up -d` → `verify.sh` + `check.sh` → `✅ 部署成功`;`deploy/.state/last-deployed` 记 SHA |
|
| job 容器里工具齐全 | `act_runner exec` 预演:`Python 3.10.12 / git 2.55 / docker server 29.8.0 / compose v5.5.1` |
|
||||||
| job 容器路径 | `act_runner exec` 预演:`uid=0 / Python 3.10.12 / git 2.55 / docker server 29.8.0 / compose v5.5.1`,部署克隆可见,`loopback-api=200 apache=200`,`🏁 Job succeeded` |
|
|
||||||
|
|
||||||
这次落地中发现并修掉的问题(细节见 [README](README.md) 陷阱 7–9):
|
2026-09-21 打通时踩的三个坑(对应当天几次红色的运行):
|
||||||
|
|
||||||
1. 全新克隆里 `customization/custom/options/` 不存在 → docker 以 root 创建这个挂载源目录 →
|
1. **`container.valid_volumes` 为空表时,挂载会被静默丢弃**(只打一行
|
||||||
`build.py` 写不进去 → **语言文件生成失败、「工单」回归**(首页/登录页却看着正常)。
|
`... is not a valid volume, will be ignored`)→ job 容器里没有部署克隆,第一步
|
||||||
修法:`.gitkeep` 让目录随 checkout 存在 + 部署前可写性检查。
|
`cd /home/ymy/deploy/tjhlp-gitea` 就失败。修法:把要挂的路径列进白名单。
|
||||||
2. `container.options` 里自己挂 `docker.sock` 与 act_runner 的自动挂载冲突
|
2. **部署克隆的 `origin` 是宿主上的本地裸库**(`/srv/gitea/...`),job 容器里没有它 →
|
||||||
(`Duplicate mount point`),第一次真实部署必然失败。修法:去掉显式挂载。
|
`git fetch` 报 "does not appear to be a git repository"。修法:把 `/srv/gitea` 只读挂进去。
|
||||||
3. 宿主 `/usr/bin/python3` 是 **3.6**,PATH 顺序一变 `build.py` 就 `SyntaxError`,而且语言
|
3. **workflow 的 step 之间不共享工作目录**,第二步要自己 `cd` 过去(`actions/checkout` 那种
|
||||||
文件会**静默地**不再更新。修法:脚本自己挑 ≥3.7 的解释器并用它跑 build.py。
|
"代码在当前目录"的心智模型在这里不成立)。
|
||||||
|
|
||||||
|
2026-09-22 本轮改动:**把宿主能力从"runner 全局发给每个 job"收窄成"deploy job 自己申报"**:
|
||||||
|
|
||||||
|
- `container.docker_host: "-"` → 不再自动把 docker socket 挂进 job 容器;
|
||||||
|
- 删掉 `container.options` 里的全局挂载;
|
||||||
|
- 五项挂载(部署克隆、`/srv/gitea`、socket、docker CLI、compose 插件)改为在
|
||||||
|
`.gitea/workflows/deploy.yml` 的 `container.volumes` 里申报,并全部列进
|
||||||
|
`container.valid_volumes` 白名单。
|
||||||
|
|
||||||
|
效果:**将来加的 PR 检查/测试 job 默认是裸容器**——没有宿主路径,也申报不了白名单之外的卷
|
||||||
|
(本机实测:不申报任何挂载的 job 看不到 `/home/ymy/deploy` 与 `/srv/gitea`)。socket 那一项
|
||||||
|
在真实调度路径上的确认方式与失败模式见 §9,其余残留见 §7.2。
|
||||||
|
|
||||||
剩余动作:
|
剩余动作:
|
||||||
|
|
||||||
1. **你来 `git push`**(本地有 4 个未推送提交)——推送即触发第一次 CI 运行;由于要部署的
|
1. 本轮改动**要等一次 push 才能端到端验证**(判据与回退方式见 §9 第 2 条)。
|
||||||
版本已经在本机部署过,这次应当是"无变化"的快速通过。
|
2. 用一个测试 fork 发 PR,确认 fork PR 的 workflow 审批行为(§9);确认前不要把仓库
|
||||||
2. 用一个测试 fork 发 PR,确认 fork PR 的 workflow 审批行为(§9.1);确认前不要把仓库
|
|
||||||
开放给不可信贡献者。
|
开放给不可信贡献者。
|
||||||
3. 给 `main` 加分支保护(§4.4)。
|
3. 给 `main` 加分支保护(§4.4)。
|
||||||
|
|
||||||
@@ -56,7 +68,7 @@
|
|||||||
| 项 | 实测值 | 对方案的影响 |
|
| 项 | 实测值 | 对方案的影响 |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| Gitea | 1.27.3;Actions 默认开启(`modules/setting/actions.go` 里 `Enabled: true`),仓库页有 `/actions` | 不用改配置就能用 |
|
| Gitea | 1.27.3;Actions 默认开启(`modules/setting/actions.go` 里 `Enabled: true`),仓库页有 `/actions` | 不用改配置就能用 |
|
||||||
| 已注册 runner | **无**(`action_runner` 表空) | 要自己起一个 |
|
| 已注册 runner | 方案制定时**无**(现已注册,见 §0.1) | 要自己起一个 |
|
||||||
| `act_runner` 镜像 | `docker pull gitea/act_runner:latest` 成功:**arm64, v0.6.1, 69.3MB** | runner 用容器跑,**不需要 root** |
|
| `act_runner` 镜像 | `docker pull gitea/act_runner:latest` 成功:**arm64, v0.6.1, 69.3MB** | runner 用容器跑,**不需要 root** |
|
||||||
| job 镜像 | `docker.gitea.com/runner-images:ubuntu-22.04`(Gitea 官方, arm64 可用)、`catthehacker/ubuntu:act-22.04`(arm64, 压缩约 512MB)、`node:20-bookworm-slim`、`rockylinux:8` 的 manifest 都能取到 | 有现成镜像可跑容器模式 job |
|
| job 镜像 | `docker.gitea.com/runner-images:ubuntu-22.04`(Gitea 官方, arm64 可用)、`catthehacker/ubuntu:act-22.04`(arm64, 压缩约 512MB)、`node:20-bookworm-slim`、`rockylinux:8` 的 manifest 都能取到 | 有现成镜像可跑容器模式 job |
|
||||||
| 宿主出网 | 国内直连 `200`;境外经代理 `200`(`https://dl.gitea.com/...`、`https://github.com` 经 `127.0.0.1:7890` 均 `200`) | 正常联网,不是离线环境 |
|
| 宿主出网 | 国内直连 `200`;境外经代理 `200`(`https://dl.gitea.com/...`、`https://github.com` 经 `127.0.0.1:7890` 均 `200`) | 正常联网,不是离线环境 |
|
||||||
@@ -79,11 +91,11 @@
|
|||||||
Gitea (10.80.42.185/QA) ── 调度 workflow ──► act_runner(docker compose 服务, 容器)
|
Gitea (10.80.42.185/QA) ── 调度 workflow ──► act_runner(docker compose 服务, 容器)
|
||||||
▲ │ 拉起 job 容器
|
▲ │ 拉起 job 容器
|
||||||
│ 日志/状态显示在仓库 Actions 标签 ▼
|
│ 日志/状态显示在仓库 Actions 标签 ▼
|
||||||
└──────────────────── job 容器(network: host)
|
└──────────────────── job 容器(network: host;宿主能力由 job 自己申报)
|
||||||
├─ 挂 docker.sock → 可执行 docker compose
|
├─ 挂 docker.sock → 可执行 docker compose
|
||||||
├─ 挂 /home/ymy/deploy(同路径)→ 部署克隆
|
├─ 挂 /home/ymy/deploy(同路径, 部署克隆)+ /srv/gitea(ro, 它的 origin)
|
||||||
└─ 跑 auto-deploy.sh: build.py → up -d → verify → 失败回滚
|
└─ 跑 auto-deploy.sh: build.py → up -d → verify → 失败回滚
|
||||||
```
|
未申报的 job(将来的 PR 检查)拿不到上面任何一项
|
||||||
|
|
||||||
### 2.2 runner 形态:容器(推荐)vs 宿主二进制
|
### 2.2 runner 形态:容器(推荐)vs 宿主二进制
|
||||||
|
|
||||||
@@ -92,7 +104,7 @@
|
|||||||
| 安装 | `docker compose up -d`(镜像实测可拉) | 下载二进制 + **需要 sudo** 装 systemd 单元 |
|
| 安装 | `docker compose up -d`(镜像实测可拉) | 下载二进制 + **需要 sudo** 装 systemd 单元 |
|
||||||
| job 执行 | job 容器(镜像由 label 决定) | 直接在宿主以 `ymy` 执行 |
|
| job 执行 | job 容器(镜像由 label 决定) | 直接在宿主以 `ymy` 执行 |
|
||||||
| 工具依赖 | 靠 job 镜像(要确认镜像里有 git/python3/docker CLI) | 宿主现成,最省事 |
|
| 工具依赖 | 靠 job 镜像(要确认镜像里有 git/python3/docker CLI) | 宿主现成,最省事 |
|
||||||
| 挂载 | 靠 `container.options` 把 docker.sock 与部署克隆按**同路径**挂进 job 容器 | 无 |
|
| 挂载 | 由 deploy job 在 `container.volumes` 里申报(受 runner 的 `valid_volumes` 白名单约束) | 无 |
|
||||||
| 开机自启 | compose 的 `restart: unless-stopped` | systemd |
|
| 开机自启 | compose 的 `restart: unless-stopped` | systemd |
|
||||||
| 结论 | **默认选它**:不需要 root、标准、日志清晰 | 想少一层容器、且你愿意跑一次 sudo 时选它 |
|
| 结论 | **默认选它**:不需要 root、标准、日志清晰 | 想少一层容器、且你愿意跑一次 sudo 时选它 |
|
||||||
|
|
||||||
@@ -220,25 +232,31 @@ runner:
|
|||||||
- "self-hosted:docker://docker.gitea.com/runner-images:ubuntu-22.04"
|
- "self-hosted:docker://docker.gitea.com/runner-images:ubuntu-22.04"
|
||||||
container:
|
container:
|
||||||
network: host # job 容器与宿主共用网络: 127.0.0.1:2080 与 10.80.42.185 都能直连
|
network: host # job 容器与宿主共用网络: 127.0.0.1:2080 与 10.80.42.185 都能直连
|
||||||
options: >-
|
docker_host: "-" # 自动找 daemon, 但【不】把 socket 挂进 job 容器(要用 docker 的 job 自己申报)
|
||||||
--volume /home/ymy/deploy:/home/ymy/deploy
|
valid_volumes: # 允许 job 申报的挂载白名单(glob 匹配挂载源路径; [] = 一个都不许)
|
||||||
--volume /usr/bin/docker:/usr/bin/docker:ro
|
- /home/ymy/deploy
|
||||||
--volume /usr/libexec/docker/cli-plugins:/usr/libexec/docker/cli-plugins:ro
|
- /srv/gitea
|
||||||
|
- /var/run/docker.sock
|
||||||
|
- /usr/bin/docker
|
||||||
|
- /usr/libexec/docker/cli-plugins
|
||||||
|
# 这里【故意不写】全局 options: 挂载由 deploy job 自己申报, 见 §5.1
|
||||||
force_pull: false # 镜像已有就别每次拉
|
force_pull: false # 镜像已有就别每次拉
|
||||||
# ★ 不要挂 /var/run/docker.sock: act_runner 会自动挂, 重复挂会
|
|
||||||
# "Duplicate mount point: /var/run/docker.sock" 直接失败(实测)
|
|
||||||
cache:
|
cache:
|
||||||
enabled: true
|
enabled: true
|
||||||
```
|
```
|
||||||
|
|
||||||
三处关键点:
|
四处关键点:
|
||||||
|
|
||||||
- `--volume /home/ymy/deploy:/home/ymy/deploy` **必须同路径**:`docker compose` 在 job 容器里
|
- **白名单管两头**:job 申报的 `container.volumes` 和全局 `options` 里的 `--volume` 都要在
|
||||||
把相对挂载解析成绝对路径后交给宿主 daemon 执行,路径不一致会挂到空目录;
|
`valid_volumes` 里,否则被**静默丢弃**(`... is not a valid volume, will be ignored`),
|
||||||
- 挂 `/usr/bin/docker` 与 `cli-plugins` 是为了不依赖 job 镜像里有没有 docker CLI / compose 插件
|
2026-09-21 实际因此失败;
|
||||||
(宿主是 glibc,Ubuntu 镜像能用;落地时若镜像自带,也可以去掉这两行);
|
- **同路径挂载 `/home/ymy/deploy`**:`docker compose` 在 job 容器里把相对挂载解析成绝对路径后
|
||||||
- `docker.sock` 会被 act_runner 自动挂进 job 容器(`container.docker_host` 默认行为),
|
交给宿主 daemon 执行,路径不一致会挂到空目录;
|
||||||
上面仍显式挂一次更直观。
|
- **`/srv/gitea` 只读**:部署克隆的 `origin` 是这个宿主路径下的裸库,job 容器里没有它就
|
||||||
|
`git fetch` 不了(2026-09-21 实际踩到);
|
||||||
|
- **不把 `docker.sock` 写进全局 `options`**:那等于每个 job 都拿到 root。改由 deploy job
|
||||||
|
自己申报,而 `docker_host: "-"` 保证它不会和"自动挂载"撞成
|
||||||
|
`Duplicate mount point: /var/run/docker.sock`。
|
||||||
|
|
||||||
### 4.3 试运行(手动触发)
|
### 4.3 试运行(手动触发)
|
||||||
|
|
||||||
@@ -264,12 +282,15 @@ cache:
|
|||||||
`auto-deploy.sh`(可版本化、可手工跑、可本地调试)。
|
`auto-deploy.sh`(可版本化、可手工跑、可本地调试)。
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
|
# main 推送后自动部署到 10.80.42.185/QA。
|
||||||
|
# 逻辑都在 deploy/scripts/auto-deploy.sh 里, 这里只负责"同步到目标提交 + 调脚本"。
|
||||||
|
# 详见 deploy/ci-cd.md。
|
||||||
name: deploy
|
name: deploy
|
||||||
|
|
||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
branches: [main]
|
branches: [main]
|
||||||
workflow_dispatch: # 阶段 4.3 只留这个
|
workflow_dispatch:
|
||||||
|
|
||||||
concurrency:
|
concurrency:
|
||||||
group: deploy-main
|
group: deploy-main
|
||||||
@@ -287,19 +308,40 @@ jobs:
|
|||||||
!contains(github.event.head_commit.message, '[skip deploy]'))
|
!contains(github.event.head_commit.message, '[skip deploy]'))
|
||||||
runs-on: self-hosted
|
runs-on: self-hosted
|
||||||
timeout-minutes: 30
|
timeout-minutes: 30
|
||||||
|
# ★ 宿主能力(docker socket、部署克隆、裸库、docker CLI)由【本 job】申报,而不是由
|
||||||
|
# runner 全局发给每个 job。runner 侧的 container.valid_volumes 是允许清单:
|
||||||
|
# 没列进去的挂载会被丢弃,所以这里的每一项都要在 deploy/runner/config.yaml 里有对应项。
|
||||||
|
# 将来加 PR 检查/测试 workflow 时,那个 job 不申报就什么都拿不到(无 socket = 无 root)。
|
||||||
|
container:
|
||||||
|
volumes:
|
||||||
|
- /home/ymy/deploy:/home/ymy/deploy # 工作目录(auto-deploy.sh 要写 .state)
|
||||||
|
- /srv/gitea:/srv/gitea:ro # deploy 克隆的 origin(本地裸库)
|
||||||
|
- /var/run/docker.sock:/var/run/docker.sock # docker compose up -d
|
||||||
|
- /usr/bin/docker:/usr/bin/docker:ro # 宿主 docker CLI
|
||||||
|
- /usr/libexec/docker/cli-plugins:/usr/libexec/docker/cli-plugins:ro # compose 插件
|
||||||
steps:
|
steps:
|
||||||
- name: 同步到目标提交
|
- name: 同步到目标提交
|
||||||
run: |
|
run: |
|
||||||
set -euo pipefail
|
set -euo pipefail
|
||||||
cd /home/ymy/deploy/tjhlp-gitea
|
cd /home/ymy/deploy/tjhlp-gitea
|
||||||
git fetch --prune origin
|
git fetch --prune origin
|
||||||
git checkout --detach "${{ github.sha }}"
|
# -f: 部署克隆是 CI 独占的; 上一个已部署版本的 deploy/runner/* 等文件在本版本
|
||||||
|
# 若已被跟踪, 会作为"未跟踪文件"挡住普通 checkout(实测)
|
||||||
|
git checkout -f --detach "${{ github.sha }}"
|
||||||
|
git --no-pager log --oneline -1
|
||||||
- name: 构建并部署(失败自动回滚)
|
- name: 构建并部署(失败自动回滚)
|
||||||
run: |
|
run: |
|
||||||
set -euo pipefail
|
set -euo pipefail
|
||||||
|
# 工作流没有 actions/checkout, 默认工作目录里没有代码; 上一步已把
|
||||||
|
# 部署克隆同步到目标提交, 这里必须显式 cd 过去 (2026-09-21 实际踩到)。
|
||||||
|
cd /home/ymy/deploy/tjhlp-gitea
|
||||||
./deploy/scripts/auto-deploy.sh
|
./deploy/scripts/auto-deploy.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
|
`container.volumes` 那一块是 2026-09-22 收窄授权的结果:需要宿主能力的只有这一个 job,
|
||||||
|
所以挂载在它这里申报;runner 侧的 `valid_volumes` 决定哪些申报能被接受。**加新的 workflow
|
||||||
|
(例如 PR 检查)时不需要、也不要给它申报这些卷** —— 它默认就是裸容器。
|
||||||
|
|
||||||
**不写 `uses:`** 的理由:本项目不需要——代码从本机裸仓库取、部署逻辑是仓库里的脚本,
|
**不写 `uses:`** 的理由:本项目不需要——代码从本机裸仓库取、部署逻辑是仓库里的脚本,
|
||||||
省掉每次运行下载 action 的开销,也避开 `github.com` 主站直连超时带来的不确定性。
|
省掉每次运行下载 action 的开销,也避开 `github.com` 主站直连超时带来的不确定性。
|
||||||
将来若要做 PR 检查(lint/pytest)想用现成 action,两条路:给 runner 容器配容器可达的代理,
|
将来若要做 PR 检查(lint/pytest)想用现成 action,两条路:给 runner 容器配容器可达的代理,
|
||||||
@@ -323,12 +365,13 @@ PUBLIC_URL="${GITEA_PUBLIC_URL:-https://cpp.tongji.sh/QA}"
|
|||||||
# 本机回环验证不能走代理, 否则会拿 502 冒充故障(见 README 陷阱 5)
|
# 本机回环验证不能走代理, 否则会拿 502 冒充故障(见 README 陷阱 5)
|
||||||
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY
|
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY
|
||||||
export no_proxy='*' NO_PROXY='*'
|
export no_proxy='*' NO_PROXY='*'
|
||||||
# 既能在 job 容器里跑, 也能在宿主上跑; 不要写死某台机器的 pyenv 路径
|
# 既能在 job 容器里跑, 也能在宿主上跑: 脚本用 pick_python() 自己挑一个 ≥3.7 的解释器
|
||||||
export PATH="/usr/local/bin:/usr/bin:/bin:${PATH}"
|
# (宿主 /usr/bin/python3 是 3.6, 见 README 陷阱 9), 不要写死某台机器的 pyenv 路径
|
||||||
|
|
||||||
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; }
|
||||||
@@ -336,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() {
|
||||||
@@ -351,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] ❌ 部署或验证失败, 开始回滚"
|
||||||
@@ -365,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` 只记可执行位)。
|
||||||
|
|
||||||
@@ -414,24 +481,41 @@ curl -sS --noproxy '*' -H 'Accept-Language: zh-CN' "${BASE}/user/login" | grep -
|
|||||||
|
|
||||||
## 7. 安全
|
## 7. 安全
|
||||||
|
|
||||||
- job 容器里挂了 `docker.sock`,而 `docker` 组等价 root;host 模式(备选 B)更是直接以 `ymy` 在
|
### 7.1 收窄后的边界(2026-09-22 起)
|
||||||
宿主执行。所以:
|
|
||||||
|
|
||||||
1. runner 只注册成**仓库级**(`/repos/{owner}/{repo}/actions/runners/registration-token`),
|
runner 不再把宿主能力全局发给每个 job:
|
||||||
不要注册成 instance/org 级——否则组织里任何仓库都能用这个 runner 拿到宿主 root;
|
|
||||||
2. `main` 必须开分支保护(PR + review)。贡献者是课程团队,属于可信范围,但
|
- `container.docker_host: "-"`:**不**把 docker socket 自动挂进 job 容器;
|
||||||
"谁有写权限 = 谁能 root 宿主"这条要写明白;
|
- 需要宿主能力的是 **deploy job 自己**,它在 `container.volumes` 里申报五项挂载;
|
||||||
3. **落地前确认 fork PR 的工作流策略**(§9.1):若 fork PR 能不经批准直接跑 workflow,
|
- `container.valid_volumes` 是允许清单:申报了但不在表里的卷会被**丢弃**(不是报错),
|
||||||
等于把宿主 root 交给外部 PR;确认之前不要把仓库开放给不可信贡献者。若策略不可控,
|
所以这个 runner 上的任何 job 都挂不上 `/`、`/etc`、`~/.ssh` 之类。
|
||||||
退化为 §10 的 cron 轮询(只跑宿主上的固定脚本,不执行仓库里的代码);
|
|
||||||
|
也就是说,"能 root 宿主"从"这个 runner 上的**所有** job"收窄成了"**deploy job** 加上白名单
|
||||||
|
里那五项"。将来加 PR 检查/测试 workflow 时,那些 job 默认是裸容器(实测:不申报任何挂载的
|
||||||
|
job 看不到 `/home/ymy/deploy`、`/srv/gitea`)。
|
||||||
|
|
||||||
|
### 7.2 仍然存在的残留(别当成"已经隔离了")
|
||||||
|
|
||||||
|
1. **能 push workflow 的人 = 能 root 宿主。** job 容器里跑的是仓库里的脚本,而 deploy job
|
||||||
|
必须有 socket;`main` 的分支保护才是这条的实际控制点。
|
||||||
|
⚠️ 另外 v0.6.1 **不会**剥离 job 自己申报的逃逸类 `container.options`(如 `--privileged`):
|
||||||
|
这是 runner 3.x 才有的行为(3.x 文档写明"会剥离并告警",v0.6.1 的 `generate-config` 里
|
||||||
|
没有这类说明)。所以**升级 runner 到 3.x 值得排期**——镜像 `gitea/runner:3` 已经存在,
|
||||||
|
配置键(`valid_volumes`/`docker_host`/`container.network`)也是同一套。
|
||||||
|
2. **`container.network: host` 是 runner 级设置**,收窄不到单个 job:这个 runner 上的每个
|
||||||
|
job 都共享宿主网络,因此能访问宿主回环上的服务(例如 `127.0.0.1:2080` 的 Gitea)。
|
||||||
|
要收窄它,得把 `--network host` 挪到 deploy job 的 `container.options`,并把 `verify.sh`
|
||||||
|
的回环检查改成"连不上就跳过、只认公网 URL"——留作后续。
|
||||||
|
3. **fork PR 的策略仍未确认**(§9):若 fork PR 能不经批准直接跑 workflow,等于把宿主 root
|
||||||
|
交给外部 PR;确认之前不要把仓库开放给不可信贡献者。
|
||||||
4. `[skip deploy]`、`if:` 是防误操作,不是安全边界。
|
4. `[skip deploy]`、`if:` 是防误操作,不是安全边界。
|
||||||
|
|
||||||
- 凭据最小化:部署流程**不需要任何 git token**(从本机裸仓库 fetch);注册令牌一次性用完即弃;
|
### 7.3 其余
|
||||||
只有将来要回写状态/发 Issue 时才需要 Actions secrets(1.27 支持仓库级
|
|
||||||
`/repos/{owner}/{repo}/actions/secrets`)。
|
|
||||||
|
|
||||||
- `gitea/act_runner` 镜像来自 Docker Hub 的官方组织仓库(本机 daemon 经代理拉取);
|
- runner 只注册成**仓库级**(`/repos/{owner}/{repo}/actions/runners/registration-token`),
|
||||||
落地时记录 tag/digest,升级方式与 Gitea 同(写进 README 升级章节)。
|
不要注册成 instance/org 级——否则组织里任何仓库都能用这个 runner 拿到宿主 root。
|
||||||
|
- 凭据最小化:部署流程**不需要任何 git token**(从本机裸仓库 fetch);注册令牌一次性用完即弃。
|
||||||
|
- `gitea/act_runner` 镜像来自 Docker Hub 官方组织仓库;落地时记录 tag/digest(升级方式同 README)。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -448,6 +532,12 @@ cd /home/ymy/deploy/tjhlp-gitea && git checkout --detach <sha> && ./deploy/scrip
|
|||||||
cd /home/ymy/deploy/tjhlp-gitea/deploy/runner && docker compose logs -f runner
|
cd /home/ymy/deploy/tjhlp-gitea/deploy/runner && docker compose logs -f runner
|
||||||
docker compose stop runner && docker compose start runner
|
docker compose stop runner && docker compose start runner
|
||||||
|
|
||||||
|
# ★ 改了 deploy/runner/config.yaml 之后【必须重启 runner】才生效
|
||||||
|
# (runner 只在启动时读一次配置; 只 `up -d` 不会重建容器)
|
||||||
|
cd /home/ymy/deploy/tjhlp-gitea/deploy/runner && docker compose restart runner
|
||||||
|
# ⚠️ 别让 deploy job 自己去重启 runner: 那等于掐断正在跑的这个 job
|
||||||
|
# (重启日志里会出现 "cancelled in progress jobs during shutdown")。
|
||||||
|
|
||||||
# 平台日志(部署后排查)
|
# 平台日志(部署后排查)
|
||||||
docker compose -f /home/ymy/deploy/tjhlp-gitea/deploy/compose.yaml logs -f gitea
|
docker compose -f /home/ymy/deploy/tjhlp-gitea/deploy/compose.yaml logs -f gitea
|
||||||
# 每次运行的完整日志在 仓库 → Actions 里
|
# 每次运行的完整日志在 仓库 → Actions 里
|
||||||
@@ -457,22 +547,32 @@ docker compose -f /home/ymy/deploy/tjhlp-gitea/deploy/compose.yaml logs -f gitea
|
|||||||
|
|
||||||
## 9. 尚未验证的点(诚实清单)
|
## 9. 尚未验证的点(诚实清单)
|
||||||
|
|
||||||
已由本机预演确认、不再是待确认项的:job 镜像里有 `git 2.55`/`Python 3.10`/docker CLI ✓;
|
**已经被真实运行确认的**(2026-09-21,共 5 次运行、最新一次成功):
|
||||||
act_runner v0.6.1 支持 `:host` 标签与 `container.network: host` ✓;compose 插件在 job 容器里
|
|
||||||
可用 ✓;部署克隆、回环 `127.0.0.1:2080`、经 Apache 的 `10.80.42.185/QA` 在 job 容器内都通 ✓。
|
|
||||||
|
|
||||||
仍然未知:
|
- Gitea 1.27 的调度、日志回传、`concurrency`、`timeout-minutes`、`permissions`、job 级
|
||||||
|
`if` + `contains(github.event.head_commit.message, ...)`、`github.sha` 都按预期工作;
|
||||||
|
- job 镜像里有 `git 2.55` / `Python 3.10` / docker CLI;`container.network: host` 下回环与
|
||||||
|
`10.80.42.185/QA` 都通;`docker compose` 可用;
|
||||||
|
- runner 配置里的 `container.valid_volumes` 会被**真实调度路径**采纳(09-21 那次失败正是
|
||||||
|
空白名单把挂载丢掉导致的)。
|
||||||
|
|
||||||
1. **fork PR 的 workflow 审批行为**(安全前提):用一个测试 fork 发 PR 验证;在此之前按 §7.3 处理。
|
**仍然未知:**
|
||||||
2. **workflow 语法支持面**:`concurrency`、`timeout-minutes`、`permissions`、job 级 `if` 里的
|
|
||||||
`contains(...)` 在 1.27 的实现里是否都生效 —— 第一次真实运行即知。
|
1. **fork PR 的 workflow 审批行为**(安全前提):用一个测试 fork 发 PR 验证;在此之前按 §7.2
|
||||||
3. **Gitea 侧的调度与日志回传**:本机只预演了 job *执行*,没预演调度/日志上报。第一次真实
|
第 3 条处理。
|
||||||
运行会验证。此外部署过程本身会重启 gitea 容器,job 与 Gitea 的连接可能短暂断开
|
2. **本轮收窄授权(2026-09-22)的端到端效果**:`docker_host: "-"` + job 自己申报
|
||||||
(act_runner 会重试),表现为日志里若干 `failed to fetch task` / `unexpected EOF` —— 属正常现象。
|
`container.volumes` 这条路径,`act_runner exec` 验证不了——exec 有自己的
|
||||||
4. **`github.sha` / `github.event.head_commit.message`** 的取值(试运行时 echo 一次确认)。
|
`--container-daemon-socket` 默认值、也不读配置里的 `valid_volumes`(实测:exec 里未授权
|
||||||
5. **Actions 日志保留与体积**:`[actions] LOG_RETENTION_DAYS`(默认 365)与存储位置。
|
路径照样挂上、裸 job 照样有 socket),只能靠一次真实 push。判据:
|
||||||
6. **Gitea 是否支持"环境审批"**:若有 deployments/environments 的审批,可作为
|
- **成功**:运行变绿 + `deploy/.state/last-deployed` = 本次 SHA;
|
||||||
"自动部署但上线要点一下"的中间档。
|
- **失败**:部署 job 在第一步 `cd /home/ymy/deploy/tjhlp-gitea` 就报错、**线上不受影响**
|
||||||
|
(挂载没挂上 = 什么都还没做)→ 说明 `container.volumes` 没被采纳,`git revert` 回退到
|
||||||
|
"全局 options + 白名单"的旧形态即可。
|
||||||
|
- 想在**生产路径**上验证"裸 job 真的连 socket 也没有",需要临时加一个
|
||||||
|
`on: workflow_dispatch` 的探针 workflow(本机只验证了"没有宿主路径"这一半 ✓)。
|
||||||
|
3. **Actions 日志保留与体积**:`[actions] LOG_RETENTION_DAYS`(默认 365)与存储位置。
|
||||||
|
4. **Gitea 是否支持"环境审批"**:若有 deployments/environments 的审批,可作为"自动部署但
|
||||||
|
上线要点一下"的中间档。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
+14
-3
@@ -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}
|
||||||
@@ -153,7 +164,7 @@ services:
|
|||||||
# --- OIDC / OAuth2 --------------------------------------------------
|
# --- OIDC / OAuth2 --------------------------------------------------
|
||||||
GITEA__openid__ENABLE_OPENID_SIGNIN: "false"
|
GITEA__openid__ENABLE_OPENID_SIGNIN: "false"
|
||||||
GITEA__openid__ENABLE_OPENID_SIGNUP: "true"
|
GITEA__openid__ENABLE_OPENID_SIGNUP: "true"
|
||||||
GITEA__oauth2_client__OPENID_CONNECT_SCOPES: profile
|
GITEA__oauth2_client__OPENID_CONNECT_SCOPES: profile email
|
||||||
GITEA__oauth2_client__ENABLE_AUTO_REGISTRATION: "true"
|
GITEA__oauth2_client__ENABLE_AUTO_REGISTRATION: "true"
|
||||||
GITEA__oauth2_client__USERNAME: userid
|
GITEA__oauth2_client__USERNAME: userid
|
||||||
GITEA__oauth2_client__ACCOUNT_LINKING: auto
|
GITEA__oauth2_client__ACCOUNT_LINKING: auto
|
||||||
|
|||||||
+29
-13
@@ -14,21 +14,37 @@ runner:
|
|||||||
container:
|
container:
|
||||||
# host: job 容器与宿主共用网络 —— verify.sh 里对 127.0.0.1:2080 的检查才有效,
|
# host: job 容器与宿主共用网络 —— verify.sh 里对 127.0.0.1:2080 的检查才有效,
|
||||||
# 10.80.42.185 也不需要额外放行。
|
# 10.80.42.185 也不需要额外放行。
|
||||||
|
# ⚠️ 这是 runner 级设置, 所以这个 runner 上的【每个】job 都共享宿主网络 —— 还没能
|
||||||
|
# 收窄的一轴(见 ci-cd.md §7 残留项)。
|
||||||
network: host
|
network: host
|
||||||
# ★ 不要在这里挂 /var/run/docker.sock: act_runner 会自动把 docker daemon socket
|
# ★ 不把宿主 docker socket 自动挂进 job 容器(默认行为是自动挂 = 每个 job 都能拿到
|
||||||
# 挂进 job 容器(container.docker_host 的默认行为), 再挂一次会直接失败:
|
# root 等价能力)。改成"要用 docker 的 job 自己申报", 并受下面的白名单约束。
|
||||||
# failed to create container: 'Duplicate mount point: /var/run/docker.sock'
|
docker_host: "-"
|
||||||
# (2026-09-13 用 `act_runner exec` 预演 job 时实测踩到 —— 若没预演, 第一次真实
|
# ★ job 允许申报的挂载白名单(gobwas/glob 匹配【挂载源路径】; [] = 一个都不许, ['**'] = 全放)。
|
||||||
# 部署就会以这个错误告终。)
|
# 注意: 全局 options 里的 --volume 也过这道白名单 —— 不在表里的会被
|
||||||
|
# "[xxx] is not a valid volume, will be ignored" 直接丢弃。2026-09-21 就因为这个
|
||||||
|
# (当时 options 有挂载但白名单是默认空表)让 job 容器里看不到 /home/ymy/deploy,
|
||||||
|
# 第一步 `cd /home/ymy/deploy/tjhlp-gitea` 就失败。
|
||||||
#
|
#
|
||||||
# 下面这些挂载是 act_runner 不管的:
|
# 表里的四项分别对应:
|
||||||
# * 部署克隆同路径挂载: job 容器里 `docker compose` 会把相对挂载解析成绝对路径后
|
# /home/ymy/deploy job 里的工作目录(deploy job 申报, 可写)
|
||||||
# 交给宿主 daemon, 两边路径必须一致, 否则会挂到空目录;
|
# /srv/gitea 部署克隆的 origin 是这里面的本地裸库; 不挂进去
|
||||||
# * 宿主 docker CLI + compose 插件: 不依赖 job 镜像里带没带(宿主是 glibc, Ubuntu 镜像能用)。
|
# `git fetch` 会报 "does not appear to be a git repository"
|
||||||
options: >-
|
# (2026-09-21 实际踩到), 只读
|
||||||
--volume /home/ymy/deploy:/home/ymy/deploy
|
# /var/run/docker.sock 部署要 `docker compose up -d`, 只给申报它的 job
|
||||||
--volume /usr/bin/docker:/usr/bin/docker:ro
|
# /usr/bin/docker 等 docker CLI + compose 插件, 不依赖 job 镜像里带没带
|
||||||
--volume /usr/libexec/docker/cli-plugins:/usr/libexec/docker/cli-plugins:ro
|
valid_volumes:
|
||||||
|
- /home/ymy/deploy
|
||||||
|
- /srv/gitea
|
||||||
|
- /var/run/docker.sock
|
||||||
|
- /usr/bin/docker
|
||||||
|
- /usr/libexec/docker/cli-plugins
|
||||||
|
# ★ 这里【故意不写】全局 options 挂载: 需要宿主路径/socket 的只有 deploy 这一个 job,
|
||||||
|
# 由它在 .gitea/workflows/deploy.yml 的 container.volumes 里自己申报(见 ci-cd.md §5.1)。
|
||||||
|
# 挂在这里等于这个 runner 上的每个 job(比如将来加的 PR 检查/测试)都白拿 socket = root。
|
||||||
|
# 另外 act_runner 会自动挂 docker.sock, 再在 options 里挂一次会以
|
||||||
|
# "Duplicate mount point: /var/run/docker.sock" 直接失败(2026-09-13 预演时实测),
|
||||||
|
# 所以 docker_host: "-" 与 job 自己申报是配套的一对改动。
|
||||||
force_pull: false # 镜像本地已有就不再拉
|
force_pull: false # 镜像本地已有就不再拉
|
||||||
|
|
||||||
cache:
|
cache:
|
||||||
|
|||||||
@@ -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] ❌ 部署或验证失败, 开始回滚"
|
||||||
|
|||||||
@@ -30,7 +30,8 @@ issue-templates/
|
|||||||
## config.yaml 里的链接与占位符
|
## config.yaml 里的链接与占位符
|
||||||
|
|
||||||
`config.yaml` 的 `contact_links` 是「新建 Issue」页面上的引导入口, 目前指向**课程官网**
|
`config.yaml` 的 `contact_links` 是「新建 Issue」页面上的引导入口, 目前指向**课程官网**
|
||||||
(学会提问 / 课程信息 / 常见问题), 把答疑平台和官网串起来。课程官网地址是硬编码常量
|
(提问指南 / 课程信息), 把答疑平台和官网串起来。提问指南只在官网保留一份
|
||||||
|
(`https://cpp.tongji.sh/Website/qa/ask/`, 平台内不再有副本); 课程官网地址是硬编码常量
|
||||||
(`https://cpp.tongji.sh/Website/`), 换域名时两个 `config.yaml` 要一起改。
|
(`https://cpp.tongji.sh/Website/`), 换域名时两个 `config.yaml` 要一起改。
|
||||||
|
|
||||||
平台自身的链接用占位符, 避免把学期组织名写死:
|
平台自身的链接用占位符, 避免把学期组织名写死:
|
||||||
|
|||||||
@@ -1,11 +1,8 @@
|
|||||||
blank_issues_enabled: false
|
blank_issues_enabled: false
|
||||||
contact_links:
|
contact_links:
|
||||||
- name: 提问前必读 · 学会提问
|
- name: 提问前必读 · 提问指南
|
||||||
url: https://cpp.tongji.sh/Website/ask-question/
|
url: https://cpp.tongji.sh/Website/qa/ask/
|
||||||
about: 课程官网上的提问规范。不合规范的提问很可能不会得到回答
|
about: 课程官网上的提问规范与做法。不合规范的提问很可能不会得到回答
|
||||||
- name: 课程官网
|
- name: 课程官网
|
||||||
url: https://cpp.tongji.sh/Website/
|
url: https://cpp.tongji.sh/Website/
|
||||||
about: 课程信息、作业说明、环境配置要求、常见问题
|
about: 课程信息、作业说明、环境配置要求、常见问题
|
||||||
- name: 答疑平台提问指南
|
|
||||||
url: "{{BASE_URL}}/assets/tjhlp/ask-guide.html"
|
|
||||||
about: 搜索 Issue、选择模板、填写信息、关闭 Issue 的平台内速查
|
|
||||||
|
|||||||
@@ -3,9 +3,9 @@ contact_links:
|
|||||||
- name: 一般性问题请到 general 仓库提问
|
- name: 一般性问题请到 general 仓库提问
|
||||||
url: "{{BASE_URL}}/{{ORG}}/general/issues/new/choose"
|
url: "{{BASE_URL}}/{{ORG}}/general/issues/new/choose"
|
||||||
about: 课程内容答疑、环境配置等非作业特定问题请到 general 仓库
|
about: 课程内容答疑、环境配置等非作业特定问题请到 general 仓库
|
||||||
- name: 提问前必读 · 学会提问
|
- name: 提问前必读 · 提问指南
|
||||||
url: https://cpp.tongji.sh/Website/ask-question/
|
url: https://cpp.tongji.sh/Website/qa/ask/
|
||||||
about: 课程官网上的提问规范。不合规范的提问很可能不会得到回答
|
about: 课程官网上的提问规范与做法。不合规范的提问很可能不会得到回答
|
||||||
- name: 课程官网
|
- name: 课程官网
|
||||||
url: https://cpp.tongji.sh/Website/
|
url: https://cpp.tongji.sh/Website/
|
||||||
about: 课程信息、作业说明、环境配置要求、常见问题
|
about: 课程信息、作业说明、环境配置要求、常见问题
|
||||||
|
|||||||
@@ -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,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"
|
||||||
|
|||||||
Reference in New Issue
Block a user