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
parent 2c6f8d11f3
commit cbff292551
5 changed files with 274 additions and 46 deletions
--- a/docker/.env.example
+++ b/docker/.env.example
@@ -19,9 +19,34 @@ JUDGE_CONCURRENCY=2
 # DeepSeek key，用于题解 AI 分析。留空则 AI 功能不可用（其余功能不受影响）。
 AI_KEY=

-# --- 只有机房那套需要 ---
-# 服务器地址。默认值写在 compose.school.yml 里，换机器时在这里覆盖。
+# --- 数据在哪 ---
+#
+# 这三个变量决定新栈是「自带 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=
+
+# --- 只有机房那套需要 ---
 # 机房走 http 直连 IP，没有 TLS，必须 false，否则 Cookie 发不回来。
 COOKIE_SECURE=false
--- a/docker/compose.debian.yml
+++ b/docker/compose.debian.yml
@@ -7,14 +7,35 @@
 # 和旧的 docker-compose.debian.yml 的对应关系：
 #   oj-backend（supervisord 跑 caddy+gunicorn+dramatiq）→ 拆成 oj-web + oj-api + oj-worker
 #   端口、数据目录、判题机配置全部保持不变，这样回滚只是换回旧 compose。
+#
+# ## 两种形态
+#
+# **自带数据**（演练用的就是这个）：postgres 和 redis 也由本文件起，要显式加 profile。
+#
+#   docker compose -f docker/compose.debian.yml --env-file docker/.env --profile local-data up -d
+#
+# **只换前后端**（默认，上线用这个）：旧栈的 postgres / redis 容器继续跑，
+# 这里只起 api / worker / web / judge，
+# 通过 env 指过去。切换当天数据库进程根本不重启，库和文件都不用挪位置。
+#
+#   docker compose -f docker/compose.debian.yml --env-file docker/.env up -d
+#
+# 后者要在 env 里设 `DB_HOST` / `REDIS_HOST` / `DATA_DIR`，见 `.env.example` 末尾。
+#
+# ⚠️ `DATA_DIR` 默认值 `../data` 解析出来是 **`OJ2/data`**，不是部署目录的 `data/`。
+# 旧栈用的是 `<部署目录>/data/`，两者不是一个地方 —— 直接用默认值切过去，postgres 会在
+# 空目录上初始化一个全新的空库，测试点和题面图片也全都不在。**用旧数据就必须设 `DATA_DIR`。**

 services:
  oj-postgres:
    image: postgres:16-alpine
    container_name: oj-postgres
    restart: always
+    # 只在「自带数据」形态下启动。用旧栈的库时不启动它 —— 否则 5445 端口会和
+    # 旧的 postgres 撞，而且两个进程开同一个数据目录本来也起不来。
+    profiles: ["local-data"]
    volumes:
-      - ../data/postgres:/var/lib/postgresql/data
+      - ${DATA_DIR:-../data}/postgres:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: onlinejudge
      POSTGRES_USER: onlinejudge
@@ -32,8 +53,12 @@ services:
    image: redis:7-alpine
    container_name: oj-redis
    restart: always
+    # 同上：旧栈的 redis 也发布了 5446，两个一起跑会撞端口。
+    # redis 里没有非丢不可的东西（会话、判题队列），用旧的那个也无所谓 ——
+    # 旧后端已经停了，新后端独占它，剩下的 Django / dramatiq 残留键前缀不同，互不干扰。
+    profiles: ["local-data"]
    volumes:
-      - ../data/redis:/data
+      - ${DATA_DIR:-../data}/redis:/data
    ports:
      - "5446:6379"
    healthcheck:
@@ -57,9 +82,9 @@ services:
    tmpfs:
      - /tmp
    volumes:
-      - ../data/backend/test_case:/test_case:ro
-      - ../data/judge_server/log:/log
-      - ../data/judge_server/run:/judger
+      - ${DATA_DIR:-../data}/backend/test_case:/test_case:ro
+      - ${DATA_DIR:-../data}/judge_server/log:/log
+      - ${DATA_DIR:-../data}/judge_server/run:/judger
    environment:
      SERVICE_URL: http://oj-judge:8080
      # 心跳路径跟着新后端改了：judge_server_heartbeat/ → judge-server/heartbeat
@@ -76,15 +101,25 @@ services:
    container_name: oj-api
    restart: always
    depends_on:
+      # required: false —— 「只换前后端」时这两个服务不在启动集合里（profile 未启用），
+      # 严格的 depends_on 会让整个 project 直接判定 invalid（实测过，不是猜的）。
+      # 代价：自带数据形态下 postgres 起不来时，compose 只警告不中止，oj-api 照样起，
+      # 然后自己 crash 循环。看 `docker compose ps`，oj-api 会是 unhealthy。
      oj-postgres:
        condition: service_healthy
+        required: false
      oj-redis:
        condition: service_healthy
+        required: false
+    # 用旧栈的库时，库在宿主机上（旧 postgres 发布了 5445），走 host-gateway 过去，
+    # 不出本机、不走公网。DB_HOST 填 host.docker.internal 即可。
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
    volumes:
-      - ../data/backend:/data
+      - ${DATA_DIR:-../data}/backend:/data
    environment: &api-env
-      DATABASE_URL: postgres://onlinejudge:${POSTGRES_PASSWORD:?}@oj-postgres:5432/onlinejudge
-      REDIS_URL: redis://oj-redis:6379
+      DATABASE_URL: postgres://onlinejudge:${POSTGRES_PASSWORD:?}@${DB_HOST:-oj-postgres}:${DB_PORT:-5432}/onlinejudge
+      REDIS_URL: redis://${REDIS_HOST:-oj-redis}:${REDIS_PORT:-6379}
      JUDGE_SERVER_URL: http://oj-judge:8080
      JUDGE_SERVER_TOKEN: ${OJ2_JUDGE_TOKEN:?}
      JUDGE_CONCURRENCY: ${JUDGE_CONCURRENCY:-2}
@@ -106,8 +141,10 @@ services:
    restart: always
    depends_on:
      - oj-api
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
    volumes:
-      - ../data/backend:/data
+      - ${DATA_DIR:-../data}/backend:/data
    environment: *api-env
    # 同一个镜像，换个子命令就是判题消费者
    command: ["oj2-api", "worker"]
@@ -125,7 +162,7 @@ services:
      - oj-api
    volumes:
      # Caddy 只往这里写访问日志，静态资源在镜像里
-      - ../data/backend/log:/data/log
+      - ${DATA_DIR:-../data}/backend/log:/data/log
    ports:
      - "0.0.0.0:8080:8000"
    mem_limit: 256m
--- a/docker/compose.school.yml
+++ b/docker/compose.school.yml
@@ -10,6 +10,10 @@
 #   旧后端的 Channels 也是这样，不是回归；
 # - **切换那天两边都要切。** 只切一边的话，另一边的旧后端仍在读写同一个库，
 #   而库结构已经按新后端迁过了。
+#
+# ⚠️ `DATA_DIR` 默认值 `../data` 解析出来是 **`OJ2/data`**，不是机房部署目录的 `data/`。
+# 测试点（`data/backend/test_case`）和题面图片（`data/backend/public/upload`）都在旧目录里，
+# 不设 `DATA_DIR` 就会挂一堆空目录上去：判题全错、图片 404。**沿用旧数据必须设它。**

 services:
  oj-redis:
@@ -17,7 +21,7 @@ services:
    container_name: oj-redis
    restart: always
    volumes:
-      - ../data/redis:/data
+      - ${DATA_DIR:-../data}/redis:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
@@ -39,9 +43,9 @@ services:
    tmpfs:
      - /tmp
    volumes:
-      - ../data/backend/test_case:/test_case:ro
-      - ../data/judge_server/log:/log
-      - ../data/judge_server/run:/judger
+      - ${DATA_DIR:-../data}/backend/test_case:/test_case:ro
+      - ${DATA_DIR:-../data}/judge_server/log:/log
+      - ${DATA_DIR:-../data}/judge_server/run:/judger
    environment:
      SERVICE_URL: http://oj-judge:8080
      BACKEND_URL: http://oj-api:3000/api/judge-server/heartbeat
@@ -61,7 +65,7 @@ services:
      oj-redis:
        condition: service_healthy
    volumes:
-      - ../data/backend:/data
+      - ${DATA_DIR:-../data}/backend:/data
    environment: &api-env
      # 库在服务器上，走公网。DB_HOST 默认值就是服务器地址，换机器改 env 文件
      DATABASE_URL: postgres://onlinejudge:${POSTGRES_PASSWORD:?}@${DB_HOST:-150.158.29.156}:${DB_PORT:-5445}/onlinejudge
@@ -89,7 +93,7 @@ services:
    depends_on:
      - oj-api
    volumes:
-      - ../data/backend:/data
+      - ${DATA_DIR:-../data}/backend:/data
    environment: *api-env
    command: ["oj2-api", "worker"]
    mem_limit: 2g
@@ -105,7 +109,7 @@ services:
    depends_on:
      - oj-api
    volumes:
-      - ../data/backend/log:/data/log
+      - ${DATA_DIR:-../data}/backend/log:/data/log
    ports:
      - "81:8000"
    mem_limit: 256m