deploy 添加失败回滚

Author: longsizhuo

.github/workflows/deploy.yml

@@ -35,8 +35,29 @@ jobs:
           script: |
             cd /home/ubuntu/involution-hell
 
-            # 构建新镜像（失败则整个 workflow 标红）
+            # 保存当前镜像为回滚备份（首次部署时镜像可能不存在，忽略错误）
+            docker tag involutionhell-backend:latest involutionhell-backend:rollback 2>/dev/null || true
+
+            # 构建新镜像（失败则整个 workflow 标红，旧容器不受影响）
             docker build -t involutionhell-backend:latest .
 
             # 用新镜像重启服务
             docker compose up -d --remove-orphans
+
+            # 等待服务启动，最多 60 秒
+            echo "等待服务健康检查..."
+            for i in $(seq 1 12); do
+              if curl -fsS "http://127.0.0.1:8080/api/v1/actuator/health" | grep -q '"status":"UP"'; then
+                echo "✅ 部署成功，服务正常运行"
+                exit 0
+              fi
+              echo "第 $i 次检查未就绪，5 秒后重试..."
+              sleep 5
+            done
+
+            # 健康检查超时，用备份镜像回滚
+            echo "❌ 健康检查失败，正在回滚到上一个版本..."
+            docker tag involutionhell-backend:rollback involutionhell-backend:latest
+            docker compose up -d --remove-orphans
+            echo "回滚完成，workflow 标红以提示本次部署失败"
+            exit 1

README.md

@@ -122,6 +122,33 @@ curl -X POST http://127.0.0.1:8080/api/auth/login \
 # 产物位于 target/backend
 ```
 
+## CI/CD 自动部署
+
+推送到 `main` 分支后，GitHub Actions 会自动触发部署流程：
+
+```
+push to main
+  → SCP 同步源码到服务器
+  → 服务器执行 docker build
+  → docker compose up -d 重启服务
+```
+
+**生产环境健康检查端点：**
+
+```
+GET https://api.involutionhell.com/api/v1/actuator/health
+```
+
+返回 `{"status":"UP"}` 表示服务正常运行。
+
+> [!IMPORTANT]
+> **关于部署失败与宕机风险：**
+>
+> - **`docker build` 阶段失败** → 安全，旧容器不受影响，GitHub Actions 标红但服务继续运行。
+> - **build 成功但新容器启动崩溃**（配置错误、数据库迁移异常等）→ 会短暂宕机。旧容器已被停止，新容器因 `restart: always` 持续重启但无法自愈，需人工介入。
+>
+> 合并前请确保本地执行 `./mvnw test` 通过，并确认 `.env` 所需的环境变量在服务器上已正确配置。
+
 ## 贡献规范
 - 保持代码可编译，提交前执行 `./mvnw test`。
 - 业务逻辑请放在 `service` 层，保持 `controller` 层简洁。