yuetsh
1a059d0b88
设计文档写的是「不双跑不灰度」，这次改主意了。理由：「只换前后端」形态下新栈
本来就不碰数据库进程，双跑的增量风险只剩「两个后端同时写同一个库」这一条；
换来的是**正式切换退化成改一行 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>
72 lines
2.8 KiB
Plaintext
72 lines
2.8 KiB
Plaintext
# 部署用的环境变量。拷成 .env（服务器）或 .env.school（机房）后填。
|
||
#
|
||
# cp docker/.env.example docker/.env
|
||
#
|
||
# 仓库里不留任何真实密钥。带 `:?` 的变量没设置时 docker compose 会直接报错退出，
|
||
# 不会静默起一个用弱默认值的服务。
|
||
|
||
# 数据库口令。机房那套连的是服务器的库，两边必须一致。
|
||
POSTGRES_PASSWORD=
|
||
|
||
# 判题机 token。后端和判题机容器读的是同一个变量，自己生成：
|
||
# openssl rand -hex 32
|
||
OJ2_JUDGE_TOKEN=
|
||
|
||
# 判题并发。受判题沙箱能力限制，不是越大越好。
|
||
# 服务器 2，机房机器宽裕可以给 4。
|
||
JUDGE_CONCURRENCY=2
|
||
|
||
# DeepSeek key，用于题解 AI 分析。留空则 AI 功能不可用（其余功能不受影响）。
|
||
AI_KEY=
|
||
|
||
# --- 数据在哪 ---
|
||
#
|
||
# 这三个变量决定新栈是「自带 postgres/redis」还是「接着用旧栈的」。
|
||
#
|
||
# DATA_DIR 是所有数据卷的根（库、测试点、上传的图片、判题机日志）。
|
||
# **不设的话默认是 `../data`，也就是 `OJ2/data` —— 不是部署目录的 `data/`。**
|
||
# 沿用旧数据时必须写成旧目录的绝对路径，例如服务器上：
|
||
#
|
||
# DATA_DIR=/root/OJDeploy/data
|
||
#
|
||
# 不设它就等于开一套空数据：空库（站点没有用户没有题）、没有测试点、题面图片 404。
|
||
DATA_DIR=
|
||
|
||
# 库和 redis 的位置。留空 = 用本 compose 自己起的容器（要加 `--profile local-data`）。
|
||
# 沿用旧栈那两个容器时这样填（它们已经把端口发布在宿主机上了）：
|
||
#
|
||
# DB_HOST=host.docker.internal
|
||
# DB_PORT=5445
|
||
# REDIS_HOST=host.docker.internal
|
||
# REDIS_PORT=5446
|
||
#
|
||
# host.docker.internal 由 compose 里的 extra_hosts 映射到 host-gateway，不出本机。
|
||
# 机房那套没有本地库，DB_HOST 不填时默认指向服务器（默认值在 compose.school.yml 里）。
|
||
DB_HOST=
|
||
DB_PORT=
|
||
REDIS_HOST=
|
||
REDIS_PORT=
|
||
|
||
# --- 并行试跑（oj2.xuyue.cc）才需要 ---
|
||
#
|
||
# 新站和旧站同时跑的时候，这两个必须设，否则会跟旧栈抢资源。
|
||
#
|
||
# 对外端口。旧 backend 占着 8080（机房 81），新栈换一个，NPM 那边把
|
||
# oj2.xuyue.cc 指到这个端口。**NPM 的记录要打开 Websockets Support**，
|
||
# 否则学生那边「判题中…」永远不动。
|
||
WEB_PORT=
|
||
|
||
# 判题机的运行状态目录。不设的话是 `$DATA_DIR/judge_server`，和旧判题机同一份 ——
|
||
# 试跑期间两个 judger 都在跑，必须分开，例如：
|
||
#
|
||
# JUDGE_STATE_DIR=/root/OJDeploy/data/judge_server_oj2
|
||
#
|
||
# 建完记得 `mkdir -p .../{log,run}`。
|
||
# `test_case` 和 `public/upload` 仍然共享，那是**故意的** —— 测试点和题面图片
|
||
# 两边必须看到同一份。
|
||
JUDGE_STATE_DIR=
|
||
|
||
# --- 只有机房那套需要 ---
|
||
# 机房走 http 直连 IP，没有 TLS，必须 false，否则 Cookie 发不回来。
|
||
COOKIE_SECURE=false
|