xuyue/OJ2 - OJ2 - Gitea: Git with a cup of tea

xuyue/OJ2

Fork 0

Commit Graph

Author	SHA1	Message	Date
yuetsh	1a059d0b88	feat(切换): 支持并行试跑，新站先挂 oj2.xuyue.cc 跑几天设计文档写的是「不双跑不灰度」，这次改主意了。理由：「只换前后端」形态下新栈本来就不碰数据库进程，双跑的增量风险只剩「两个后端同时写同一个库」这一条；换来的是正式切换退化成改一行 NPM 上游，比停机切换更稳，回滚也不用停任何容器。 ## 两个新变量 WEB_PORT 对外端口。8080 还被旧 backend 占着（机房是 81） JUDGE_STATE_DIR 判题机运行状态目录 JUDGE_STATE_DIR 是必须的：不设的话新旧两个 judger 会同时往 `data/judge_server/{run,log}` 里写。默认值用嵌套写法跟着 DATA_DIR 走（`${JUDGE_STATE_DIR:-${DATA_DIR:-../data}/judge_server}`，compose 支持嵌套默认值，试过），所以一次性切换那条路径完全不受影响。 test_case 和 public/upload 仍然共享 —— 那是故意的，测试点和题面图片两边必须看到同一份。 ## 手册新增第四节「并行试跑」，后面章节顺移（原四~九 → 五~十），两处交叉引用一并改了。第五节拆成两条路径：试跑过的只需改 NPM 上游 + 事后停旧栈；没试跑的走原来那套。第七节回滚同理。试跑那节写明了三件容易踩的：NPM 的 Websockets Support 必须打开（漏了的话页面一切正常，唯独「判题中…」永远不动，而刷新一下结果就出来，自测很难发现）、两边登录态不互通、以及双写的是真实数据不是沙盒（别在 oj2 上办正式比赛）。 ## 验证试跑形态 `config` 解析：判题机目录落到 judge_server_oj2、端口 8090、test_case 仍指向共享的那份；不设新变量时默认值一个没变（judge_server / 8080）。四份 compose `config -q` 全通过。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-16 09:04:16 -06:00
yuetsh	cbff292551	feat(切换): compose 支持「只换前后端」，接着用旧栈的 postgres/redis 演练把一件事盖住了：当时是把生产 dump 恢复进 `OJ2/data/postgres` 的，所以没人发现新 compose 在 `OJ2/docker/` 下，`../data` 解析出来是 `OJ2/data`，而旧栈用的是 `<部署目录>/data`（服务器上是 `/root/OJDeploy/data`）。照原手册切过去，postgres 会在一个空目录上初始化一个全新的空库 —— 站点起得来，但没有用户没有题、判题全挂、题面图片 404。旧数据完好，回滚正常，但当天会白吓一场。 ## 改法三组 env 旋钮，默认值保持原样，不影响本机和演练那条路： DATA_DIR 所有数据卷的根，默认 ../data DB_HOST/PORT 默认 oj-postgres:5432 REDIS_HOST/PORT 默认 oj-redis:6379 postgres 和 redis 挪进 `profiles: ["local-data"]`，默认不起 —— 否则会跟旧栈那两个抢 5445 / 5446。配套给 depends_on 加 `required: false`：实测严格的 depends_on 碰上未启用的 profile 会让整个 project 直接 invalid，不是可选项。代价写进注释了：自带数据形态下 postgres 起不来时 compose 只警告不中止。给 api / worker 加 host-gateway 映射，DB_HOST 填 host.docker.internal 就行，不用去猜 docker0 的网段。数据库流量不出本机。 school 那套的 7 个挂载点同样换成 DATA_DIR —— 机房那台也有自己的旧数据目录，测试点和题面图片都在里面，同一个坑。 ## 验证用 docs/specs/schema.sql 起了个发布在宿主机 5445 的 postgres 冒充旧栈：正好 4 个容器（没有 postgres/redis）、oj-api healthy、首页与 /api/site /api/problems 200、未登录进后台 401。读写两个方向都验了 —— 那个库的 pg_stat_activity 里有来自 172.17.0.1 的 postgres.js 连接，judge_server 表里也出现了新判题机写进去的心跳行。四份 compose 的 `config -q` 全通过。手册第三、四、六节按这个形态重写：停旧栈改成只 stop oj-backend / oj-judge （旧判题机会争 data/judge_server/run，旧 backend 占着 8080），回滚变成把这两个再 start 起来，数据库进程全程不停。 DATA_DIR 漏填不会报错（它有默认值），是切换当天唯一会静默走歪的地方，手册里给了 `config \| grep source:` 的自查和两种症状的区分。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-16 08:57:25 -06:00
yuetsh	ea521e7b0a	feat(阶段5): 镜像、三套 compose，前端切回 /api 与 /ws ## 镜像一个 Dockerfile 两个 target：api（单二进制）和 web（Caddy + 前端产物）。旧后端是一个容器里用 supervisord 跑 caddy+gunicorn+dramatiq，这里拆成 oj-web / oj-api / oj-worker 三个容器 —— Docker 本身就是进程管理器，拆开之后 worker 挂了能单独重启、日志也分得开，少一层 supervisord 要维护。同一个镜像换个子命令就是 worker，镜像里只有一份运行时。新增 healthcheck 子命令：运行镜像是 debian-slim，没有 curl/wget，让二进制自己打 /health（只打 /health 不碰库 —— 库挂了该由库的 healthcheck 报，不该让 api 跟着被判不健康然后被重启）。数据目录照抄旧后端（test_case、public/upload、public/avatar）。不是审美问题：切换那天不用搬动任何文件，回滚时旧后端立刻能找到自己的数据。少一次几十 GB 的 mv，就少一个在停机窗口里出错的机会。构建路上踩到三个坑，都是「本地能过、容器里过不了」那一类： - 构建上下文吸进了 data/，judge_server/run 是判题沙箱用别的 uid 建的， docker 连 stat 都做不了，构建直接失败 → 补 .dockerignore - mermaid@9.4.3（机房老 Chrome 的 legacy 依赖，不能砍）从容器里连 registry.npmjs.com 稳定失败，主机上没问题 → 换 npmmirror，并重试两次 - 容器里 bun 用 isolated 布局，本地是扁平的。靠「提升」才能解析到的包在容器里一律解析不到：@node-rs/jieba-linux-x64-gnu（编译要 import 它的 .node）、以及前端的 @codemirror/{language,state,view} 和 @lezer/highlight。这些本来就是代码直接 import 的，补成直接依赖。顺手写了个脚本扫全仓，确认只有这 4 个。 ## 前端切回 /api、/ws 迁移期用 /api2、/ws2 指新后端，/api、/ws 还指着 Django。端点已全部搬完，临时前缀去掉。改动只有三处（api2.ts 的 baseURL、websocket.ts 的两个 URL）， `api2` 那些 import 是模块名不是路径，不动。vite 代理同步收敛成三条。 ## compose - debian：全套（含 postgres，对外开 5445 给机房连） - school：没有 postgres，连服务器的库；本地 Redis + 本地判题沙箱 - 两边共用一个库但各有各的队列和 WS 推送，和旧后端的 Dramatiq/Channels 拓扑一致密钥一律走 env 且带 `:?`，没设置就直接报错退出，不静默用弱默认值。 COOKIE_SECURE 在机房必须是 false（http 直连 IP，带 Secure 的 Cookie 发不回来，表现是「登录成功但立刻又变未登录」）。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-07 23:41:20 -06:00

Author

SHA1

Message

Date

yuetsh

1a059d0b88

feat(切换): 支持并行试跑，新站先挂 oj2.xuyue.cc 跑几天

设计文档写的是「不双跑不灰度」，这次改主意了。理由：「只换前后端」形态下新栈
本来就不碰数据库进程，双跑的增量风险只剩「两个后端同时写同一个库」这一条；
换来的是**正式切换退化成改一行 NPM 上游**，比停机切换更稳，回滚也不用停任何容器。

## 两个新变量

    WEB_PORT          对外端口。8080 还被旧 backend 占着（机房是 81）
    JUDGE_STATE_DIR   判题机运行状态目录

JUDGE_STATE_DIR 是必须的：不设的话新旧两个 judger 会同时往
`data/judge_server/{run,log}` 里写。默认值用嵌套写法跟着 DATA_DIR 走
（`${JUDGE_STATE_DIR:-${DATA_DIR:-../data}/judge_server}`，compose 支持嵌套默认值，
试过），所以一次性切换那条路径完全不受影响。

test_case 和 public/upload 仍然共享 —— 那是故意的，测试点和题面图片两边必须
看到同一份。

## 手册

新增第四节「并行试跑」，后面章节顺移（原四~九 → 五~十），两处交叉引用一并改了。
第五节拆成两条路径：试跑过的只需改 NPM 上游 + 事后停旧栈；没试跑的走原来那套。
第七节回滚同理。

试跑那节写明了三件容易踩的：NPM 的 Websockets Support 必须打开（漏了的话页面
一切正常，唯独「判题中…」永远不动，而刷新一下结果就出来，自测很难发现）、
两边登录态不互通、以及双写的是真实数据不是沙盒（别在 oj2 上办正式比赛）。

## 验证

试跑形态 `config` 解析：判题机目录落到 judge_server_oj2、端口 8090、test_case
仍指向共享的那份；不设新变量时默认值一个没变（judge_server / 8080）。
四份 compose `config -q` 全通过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-16 09:04:16 -06:00

yuetsh

cbff292551

feat(切换): compose 支持「只换前后端」，接着用旧栈的 postgres/redis

演练把一件事盖住了：当时是把生产 dump 恢复进 `OJ2/data/postgres` 的，
所以没人发现新 compose 在 `OJ2/docker/` 下，`../data` 解析出来是 `OJ2/data`，
而旧栈用的是 `<部署目录>/data`（服务器上是 `/root/OJDeploy/data`）。

照原手册切过去，postgres 会在一个空目录上初始化一个全新的空库 —— 站点起得来，
但没有用户没有题、判题全挂、题面图片 404。旧数据完好，回滚正常，但当天会白吓一场。

## 改法

三组 env 旋钮，默认值保持原样，不影响本机和演练那条路：

    DATA_DIR    所有数据卷的根，默认 ../data
    DB_HOST/PORT      默认 oj-postgres:5432
    REDIS_HOST/PORT   默认 oj-redis:6379

postgres 和 redis 挪进 `profiles: ["local-data"]`，默认不起 —— 否则会跟旧栈
那两个抢 5445 / 5446。配套给 depends_on 加 `required: false`：实测严格的
depends_on 碰上未启用的 profile 会让整个 project 直接 invalid，不是可选项。
代价写进注释了：自带数据形态下 postgres 起不来时 compose 只警告不中止。

给 api / worker 加 host-gateway 映射，DB_HOST 填 host.docker.internal 就行，
不用去猜 docker0 的网段。数据库流量不出本机。

school 那套的 7 个挂载点同样换成 DATA_DIR —— 机房那台也有自己的旧数据目录，
测试点和题面图片都在里面，同一个坑。

## 验证

用 docs/specs/schema.sql 起了个发布在宿主机 5445 的 postgres 冒充旧栈：
正好 4 个容器（没有 postgres/redis）、oj-api healthy、首页与 /api/site
/api/problems 200、未登录进后台 401。读写两个方向都验了 —— 那个库的
pg_stat_activity 里有来自 172.17.0.1 的 postgres.js 连接，judge_server 表里
也出现了新判题机写进去的心跳行。

四份 compose 的 `config -q` 全通过。

手册第三、四、六节按这个形态重写：停旧栈改成只 stop oj-backend / oj-judge
（旧判题机会争 data/judge_server/run，旧 backend 占着 8080），回滚变成把这两个
再 start 起来，数据库进程全程不停。

**DATA_DIR 漏填不会报错**（它有默认值），是切换当天唯一会静默走歪的地方，
手册里给了 `config | grep source:` 的自查和两种症状的区分。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-16 08:57:25 -06:00

yuetsh

ea521e7b0a

feat(阶段5): 镜像、三套 compose，前端切回 /api 与 /ws

## 镜像

一个 Dockerfile 两个 target：api（单二进制）和 web（Caddy + 前端产物）。
旧后端是一个容器里用 supervisord 跑 caddy+gunicorn+dramatiq，这里拆成
oj-web / oj-api / oj-worker 三个容器 —— Docker 本身就是进程管理器，
拆开之后 worker 挂了能单独重启、日志也分得开，少一层 supervisord 要维护。

同一个镜像换个子命令就是 worker，镜像里只有一份运行时。
新增 healthcheck 子命令：运行镜像是 debian-slim，没有 curl/wget，
让二进制自己打 /health（只打 /health 不碰库 —— 库挂了该由库的 healthcheck 报，
不该让 api 跟着被判不健康然后被重启）。

**数据目录照抄旧后端**（test_case、public/upload、public/avatar）。
不是审美问题：切换那天不用搬动任何文件，回滚时旧后端立刻能找到自己的数据。
少一次几十 GB 的 mv，就少一个在停机窗口里出错的机会。

构建路上踩到三个坑，都是「本地能过、容器里过不了」那一类：

- 构建上下文吸进了 data/，judge_server/run 是判题沙箱用别的 uid 建的，
  docker 连 stat 都做不了，构建直接失败 → 补 .dockerignore
- mermaid@9.4.3（机房老 Chrome 的 legacy 依赖，不能砍）从容器里连
  registry.npmjs.com 稳定失败，主机上没问题 → 换 npmmirror，并重试两次
- 容器里 bun 用 isolated 布局，本地是扁平的。靠「提升」才能解析到的包
  在容器里一律解析不到：@node-rs/jieba-linux-x64-gnu（编译要 import 它的 .node）、
  以及前端的 @codemirror/{language,state,view} 和 @lezer/highlight。
  这些本来就是代码直接 import 的，补成直接依赖。顺手写了个脚本扫全仓，
  确认只有这 4 个。

## 前端切回 /api、/ws

迁移期用 /api2、/ws2 指新后端，/api、/ws 还指着 Django。端点已全部搬完，
临时前缀去掉。改动只有三处（api2.ts 的 baseURL、websocket.ts 的两个 URL），
`api2` 那些 import 是模块名不是路径，不动。vite 代理同步收敛成三条。

## compose

- debian：全套（含 postgres，对外开 5445 给机房连）
- school：**没有 postgres**，连服务器的库；本地 Redis + 本地判题沙箱
- 两边共用一个库但各有各的队列和 WS 推送，和旧后端的 Dramatiq/Channels 拓扑一致

密钥一律走 env 且带 `:?`，没设置就直接报错退出，不静默用弱默认值。
COOKIE_SECURE 在机房必须是 false（http 直连 IP，带 Secure 的 Cookie 发不回来，
表现是「登录成功但立刻又变未登录」）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-07 23:41:20 -06:00

3 Commits