GitHub Actions：测试和自动部署

- 每次推送和 PR：编译 C# 运行时，跑服务端测试（含 bubblewrap 沙箱）、网页端测试和类型检查
- 推送到 main 且测试通过：带缓存构建镜像，经 SSH 传到服务器并重启；Secrets 未配置时跳过部署
- 只在 github.com 上运行，git.xuyue.cc 上跳过
- deploy.sh：SKIP_BUILD 跳过构建；启动后等编译服务就绪，沙箱自检失败时部署失败；
  服务器目录默认 ~/IOT_SIM

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

deploy/README.md

@@ -51,13 +51,38 @@
 
 4. 浏览器打开域名，输入口令进入。
 
+## 自动部署（GitHub Actions）
+
+`.github/workflows/ci.yml`：
+
+- 每次推送和 PR：编译 C# 运行时，跑服务端测试（含沙箱）、网页端测试和类型检查。
+- 推送到 GitHub 的 main 且测试通过：构建镜像，经 SSH 传到服务器并重启，等到"编译服务已就绪"才算成功。**重启会结束正在运行的学生程序**，上课时间尽量不要推送 main。
+- 在 GitHub 的 Actions 页面点 Run workflow 可以手动重新部署。
+- 只在 github.com 上运行；推到 git.xuyue.cc 不会触发。
+
+一次性配置（在本机执行，需要已登录的 `gh`）：
+
+1. 服务器上的部署用户要能运行 docker（在 docker 组里），并按上面"第一次部署"第 1 步准备好 `~/IOT_SIM/.env`。
+2. 生成部署专用的 SSH 密钥，公钥放到服务器，私钥和服务器信息存进仓库 Secrets：
+
+   ```bash
+   ssh-keygen -t ed25519 -N '' -C iot-sim-deploy -f /tmp/iot_deploy
+   ssh-copy-id -i /tmp/iot_deploy.pub 用户@服务器
+   gh secret set DEPLOY_SSH_KEY -R yuetsh/IOT_SIM < /tmp/iot_deploy
+   gh secret set DEPLOY_HOST -R yuetsh/IOT_SIM -b 服务器地址
+   gh secret set DEPLOY_USER -R yuetsh/IOT_SIM -b 用户名
+   rm /tmp/iot_deploy /tmp/iot_deploy.pub
+   ```
+
+   SSH 端口不是 22 时，再设置 `DEPLOY_PORT`；服务器目录不是 `~/IOT_SIM` 时，设置变量 `gh variable set DEPLOY_DIR -R yuetsh/IOT_SIM -b 目录`。
+
 ## 日常操作
 
 在服务器的 `~/IOT_SIM` 目录下：
 
 | 做什么 | 命令 |
 |---|---|
-| 更新到新版本 | 在本机再执行一次 `deploy/deploy.sh 用户@服务器` |
+| 更新到新版本 | 推送到 GitHub 的 main（自动部署），或在本机执行 `deploy/deploy.sh 用户@服务器` |
 | 换口令 | 修改 `.env` 后 `docker compose up -d`（所有人要重新输入口令） |
 | 看日志 | `docker compose logs -f app` |
 | 看资源占用 | `docker stats` |

deploy/deploy.sh

@@ -1,6 +1,8 @@
 #!/usr/bin/env bash
-# 在本机构建镜像，传到服务器后启动（服务器不需要访问 Docker Hub，也不用自己编译）。
+# 构建镜像，传到服务器后启动（服务器不需要访问 Docker Hub，也不用自己编译）。
+# 本机手动部署和 GitHub Actions 自动部署都用这个脚本。
 # 用法：deploy/deploy.sh 用户@服务器 [服务器上的目录，默认 ~/IOT_SIM]
+#   SKIP_BUILD=1 时不构建，直接用已有的 iot-sim:latest 镜像（Actions 里已带缓存构建好）
 # 第一次部署前，先按 deploy/README.md 在服务器上准备好 .env
 set -euo pipefail
 
@@ -8,8 +10,10 @@ host=${1:?用法：deploy/deploy.sh 用户@服务器 [目录]}
 dir=${2:-IOT_SIM}
 cd "$(dirname "$0")/.."
 
-echo "== 构建镜像"
-docker compose build app
+if [[ -z "${SKIP_BUILD:-}" ]]; then
+  echo "== 构建镜像"
+  docker compose build app
+fi
 docker pull -q caddy:2-alpine
 
 echo "== 上传配置文件到 $host:$dir"
@@ -24,6 +28,30 @@ if ! ssh "$host" 'docker image inspect caddy:2-alpine >/dev/null 2>&1'; then
 fi
 
 echo "== 启动"
-ssh "$host" "cd $dir && test -f .env || { echo '服务器上还没有 .env：cp .env.example .env 后设置 ACCESS_PASSWORD'; exit 1; }
-  docker compose up -d --no-build --remove-orphans && docker image prune -f >/dev/null
-  sleep 5 && docker compose logs --tail 5 app"
+ssh "$host" bash -s -- "$dir" <<'EOF'
+set -euo pipefail
+cd "$1"
+if [[ ! -f .env ]]; then
+  echo '服务器上还没有 .env：cp .env.example .env 后设置 ACCESS_PASSWORD'
+  exit 1
+fi
+docker compose up -d --no-build --remove-orphans
+docker image prune -f >/dev/null
+
+# 等编译服务就绪；沙箱自检失败时部署算失败
+for _ in $(seq 60); do
+  logs=$(docker compose logs app 2>&1)
+  if grep -q '沙箱（bubblewrap）无法启动' <<<"$logs"; then
+    echo "$logs" | tail -5
+    exit 1
+  fi
+  if grep -q 'C# 编译服务已就绪' <<<"$logs"; then
+    echo '== 部署成功'
+    exit 0
+  fi
+  sleep 2
+done
+echo '== 120 秒内没有启动完成'
+docker compose logs --tail 20 app
+exit 1
+EOF