ci(部署): 部署走 GitHub Actions，产物挪到 runner 上编

服务器性能差，镜像 builder 阶段（1238 个包的 bun install + bun compile +
vite build）首次约 5 分钟，光前端就 160s。改成在 runner 上编好 dist/oj2-api
和 apps/web/dist，rsync 过去，服务器那边只剩几条 COPY。

服务器自己编的能力没有砍掉。Dockerfile 顶部加了全局 ARG ARTIFACTS：

  build（默认）    builder 阶段自己编，只要有 docker 就能手动部署
  prebuilt         用构建上下文里现成的产物，builder 不进构建图

实现是两个 scratch 阶段归一成 /artifacts/ 布局，再用变量阶段名
FROM artifacts-${ARTIFACTS} 选一个，运行时阶段不关心产物是谁编的。

deploy.sh 加 --prebuilt：产物缺失在自检就 die；顺带检测 buildx —— 没装的话
compose 会退回 classic builder，那个不看依赖图、所有阶段挨个跑，产物白编
（结果正确但不省时间），黄字提醒不阻断。

.dockerignore 末尾放行两个产物路径，必须在 dist/ 那些规则之后，
dockerignore 是最后一条匹配说了算。

顺手删掉 apps/web/.github/ —— 从 ojnext 抄来的残留，路径不对（GitHub 只认
仓库根的 .github/workflows/）从来没跑过，内容也是 ojnext 的。

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

docker/Dockerfile

@@ -6,6 +6,33 @@
 # 构建上下文是**仓库根**，不是 docker/：
 #   docker compose -f docker/compose.debian.yml build
 #
+# ## 产物从哪来：ARTIFACTS
+#
+# 两个产物（后端单二进制 + 前端 dist）可以在镜像里现编，也可以用外面编好的：
+#
+#   ARTIFACTS=build     （默认）builder 阶段自己编。服务器上手动部署走这条，
+#                       只要有 docker 就行，不依赖 CI、不依赖别处传产物。
+#   ARTIFACTS=prebuilt  直接拿构建上下文里现成的 dist/oj2-api 和 apps/web/dist，
+#                       builder 阶段整个不进构建图（连 bun 镜像都不会拉）。
+#
+# ⚠️ prebuilt 省时间的前提是 **BuildKit**：只有它按依赖图构建、跳过用不到的阶段。
+# 没装 buildx 的机器上 compose 会退回 classic builder，那个把所有阶段挨个跑一遍，
+# 于是 builder 照样编一次，产物白编（结果仍然正确，只是没省下时间）。
+# docker/deploy.sh --prebuilt 会检查并提醒。
+#
+# 加这个开关是因为服务器性能差：builder 里 1238 个包的 bun install + bun compile +
+# vite build，首次约 5 分钟，光前端就 160s。GitHub Actions 的 runner 编完 rsync
+# 过来，服务器这边只剩几条 COPY。见 .github/workflows/deploy.yml。
+#
+# 两条路都得留着 —— CI 挂了 / 改不动网络时，服务器上 `docker/deploy.sh` 原样能跑。
+#
+# 手工产出 prebuilt 产物（仓库根）：
+#   bun install --frozen-lockfile
+#   bun run --filter '@oj2/api' build      # → dist/oj2-api
+#   cd apps/web && bun run build           # → apps/web/dist
+#
+ARG ARTIFACTS=build
+
 # 旧后端是一个容器里用 supervisord 跑 caddy + gunicorn + dramatiq 三个进程。
 # 这里拆开：Docker 自己就是进程管理器，拆开之后 worker 挂了能单独重启、
 # 也能单独看日志，少一层 supervisord 要维护。
@@ -46,6 +73,26 @@ RUN bun build --compile --target=bun-linux-x64 apps/api/src/main.ts --outfile /b
 # 一次构建 = 一个版本，切换那天不会出现「后端换了前端忘了拷」这种半新半旧状态。
 RUN cd apps/web && bun run build
 
+# ---------------------------------------------------------------- 产物来源
+# 两个来源都归一成同样的布局（/artifacts/oj2-api、/artifacts/web），下面的运行时
+# 阶段只认这个布局，不关心产物是谁编的。
+#
+# 用 scratch 是因为这里只是「摆放文件」，不需要任何基底；这两个阶段也不会单独产出
+# 镜像，只被 COPY --from 引用。
+#
+# BuildKit 只构建进了依赖图的阶段：选 prebuilt 时 builder 和 oven/bun 镜像
+# 完全不参与，选 build 时下面那条 `COPY dist/oj2-api` 不存在也不报错。
+FROM scratch AS artifacts-build
+COPY --from=builder /build/oj2-api /artifacts/oj2-api
+COPY --from=builder /build/apps/web/dist /artifacts/web
+
+FROM scratch AS artifacts-prebuilt
+COPY dist/oj2-api /artifacts/oj2-api
+COPY apps/web/dist /artifacts/web
+
+# 变量阶段名，取值来自顶部那个全局 ARG
+FROM artifacts-${ARTIFACTS} AS artifacts
+
 # ---------------------------------------------------------------- 后端运行时
 # 用 debian 基底而不是 alpine：内嵌的 jieba 原生模块是 linux-x64-**gnu**，
 # musl 基底跑不起来（换基底必须同步改 vendor/jieba.ts 里写死的导入）。
@@ -80,7 +127,7 @@ RUN sed -i "s|deb.debian.org|${APT_MIRROR}|g" /etc/apt/sources.list.d/debian.sou
 # 官方静态二进制 —— 不为它引入整个 Python 运行时。
 COPY --from=ghcr.io/astral-sh/ruff:0.15.12 /ruff /usr/local/bin/ruff
 
-COPY --from=builder /build/oj2-api /usr/local/bin/oj2-api
+COPY --from=artifacts /artifacts/oj2-api /usr/local/bin/oj2-api
 
 # /data 下是要持久化的东西：测试用例、上传的图片、头像。
 # 相对路径按 cwd 解析（见 apps/api/src/runtime.ts），所以 workdir 设成 /data；
@@ -102,6 +149,6 @@ CMD ["oj2-api", "serve"]
 
 # ---------------------------------------------------------------- 前端 + 反代
 FROM caddy:2-alpine AS web
-COPY --from=builder /build/apps/web/dist /srv
+COPY --from=artifacts /artifacts/web /srv
 COPY docker/Caddyfile /etc/caddy/Caddyfile
 EXPOSE 8000

docker/compose.debian.yml

@@ -104,6 +104,10 @@ services:
       context: ..
       dockerfile: docker/Dockerfile
       target: api
+      # 产物来源，见 docker/Dockerfile 顶部。默认 build（服务器自己编）；
+      # CI 传 ARTIFACTS=prebuilt 用 runner 编好的产物。
+      args:
+        ARTIFACTS: ${ARTIFACTS:-build}
     image: oj2-api:latest
     container_name: oj-api
     restart: always
@@ -166,6 +170,8 @@ services:
       context: ..
       dockerfile: docker/Dockerfile
       target: web
+      args:
+        ARTIFACTS: ${ARTIFACTS:-build}
     image: oj2-web:latest
     container_name: oj-web
     restart: always

docker/compose.school.yml

@@ -59,6 +59,10 @@ services:
       context: ..
       dockerfile: docker/Dockerfile
       target: api
+      # 产物来源，见 docker/Dockerfile 顶部。默认 build（服务器自己编）；
+      # CI 传 ARTIFACTS=prebuilt 用 runner 编好的产物。
+      args:
+        ARTIFACTS: ${ARTIFACTS:-build}
     image: oj2-api:latest
     container_name: oj-api
     restart: always
@@ -105,6 +109,8 @@ services:
       context: ..
       dockerfile: docker/Dockerfile
       target: web
+      args:
+        ARTIFACTS: ${ARTIFACTS:-build}
     image: oj2-web:latest
     container_name: oj-web
     restart: always

docker/deploy.sh

@@ -7,6 +7,13 @@
 #   docker/deploy.sh              # 自检 → 构建 → 起栈 → 冒烟
 #   docker/deploy.sh --check      # 只自检，不动任何容器
 #   docker/deploy.sh --no-build   # 跳过构建（只改了 env / compose 时用）
+#   docker/deploy.sh --prebuilt   # 用现成产物，不在这台机器上编（CI 走这条）
+#
+# 默认（不带 --prebuilt）是**服务器自己编**：只要有 docker 就能跑，不依赖 CI，
+# 也不依赖别处传产物过来。代价是这台机器性能差，builder 阶段首次约 5 分钟。
+#
+# --prebuilt 则要求 dist/oj2-api 和 apps/web/dist 已经在这个目录里（GitHub
+# Actions 编好后 rsync 过来的），镜像构建只剩几条 COPY。产物缺失会在自检就拦下。
 #
 # 代码怎么上到服务器不归它管。没有 git remote 的话，在本机：
 #
@@ -31,12 +38,15 @@ for arg in "$@"; do
   case "$arg" in
     --check)    CHECK_ONLY=1 ;;
     --no-build) BUILD=0 ;;
-    *) echo "未知参数：$arg（可用：--check、--no-build）" >&2; exit 2 ;;
+    # compose 里写的是 args: ARTIFACTS: ${ARTIFACTS:-build}，导出即可生效
+    --prebuilt) export ARTIFACTS=prebuilt ;;
+    *) echo "未知参数：$arg（可用：--check、--no-build、--prebuilt）" >&2; exit 2 ;;
   esac
 done
 
 say()  { printf '\n\033[1;36m==> %s\033[0m\n' "$*"; }
 ok()   { printf '    \033[32m✓\033[0m %s\n' "$*"; }
+warn() { printf '    \033[33m!\033[0m %s\n' "$*"; }
 die()  { printf '\n\033[1;31m❌ %s\033[0m\n\n' "$*" >&2; exit 1; }
 
 # ---------------------------------------------------------------- 自检
@@ -52,6 +62,29 @@ ver=$(docker compose version --short 2>/dev/null || echo 0)
   || die "docker compose 版本太老（$ver），需要 ≥ 2.20（depends_on.required 是那个版本才有的字段）"
 ok "docker compose $ver"
 
+# --prebuilt 时产物就是构建输入。缺了的话 docker 只会甩一句 COPY 找不到文件，
+# 这里提前拦下并说清楚该怎么办。
+if [ "${ARTIFACTS:-build}" = prebuilt ]; then
+  for f in dist/oj2-api apps/web/dist/index.html; do
+    [ -e "$f" ] || die "--prebuilt 需要现成产物，但 $f 不存在。
+
+要么让 CI 把产物 rsync 过来（.github/workflows/deploy.yml），
+要么去掉 --prebuilt 让这台机器自己编（慢，但不依赖任何外部环节）。"
+  done
+  ok "用现成产物（$(du -sh dist/oj2-api apps/web/dist 2>/dev/null | tr '\n' ' ')）"
+
+  # 没有 buildx 时 compose 会退回 classic builder（构建日志末尾那行
+  # `LABEL com.docker.compose.image.builder=classic` 就是它）。classic **不看
+  # 依赖图，所有阶段挨个跑**，于是 builder 照样 bun install + vite build 一遍，
+  # 产物白编了 —— 结果是对的，只是一分钟没省下来。
+  docker buildx version >/dev/null 2>&1 \
+    || warn "没装 buildx，compose 会退回老 builder，它不跳过用不到的阶段
+      —— 这次 --prebuilt 省不下时间（结果仍然正确）。
+      修：apt-get install docker-buildx-plugin"
+else
+  ok "产物在镜像里现编（首次约 5 分钟；CI 部署走的是 --prebuilt）"
+fi
+
 cfg=$("${COMPOSE[@]}" config) || die "compose 配置解析失败，看上面的报错"
 
 # ① DATA_DIR：不生效的话卷会挂到 OJ2/data 这个空目录上 —— 站点起得来，