fix: 前端部署方案B修复 - deploy.yml支持首次真实目录迁移到releases/initial再建软链; 删除多余且基于错误假设的caddy-switch.yml(Caddy已是file_server)

.gitea/workflows/caddy-switch.yml

@@ -1,62 +0,0 @@
-name: switch-caddy-to-fileserver
-
-# 一次性：把 Caddy 对 /userbase* 的反代改为 file_server 直接读取软链接目录
-# 触发：Gitea 网页 Actions -> 本工作流 -> Run workflow（仅执行一次）
-# 做了什么：
-#   1) 确保 /data/www/userbase/releases 与初始 front 软链接存在（caddy 启动前 root 必须存在）
-#   2) 备份并原地修改宿主 Caddyfile：仅替换唯一行 `reverse_proxy userbase-front:80`
-#      -> root * /data/www/userbase/front + file_server + try_files（SPA 回退）
-#   3) 按现有 caddy 容器的 image/端口/挂载/网络 重建（追加 /data/www/userbase 挂载）
-#   4) 移除已被取代的 userbase-front 容器
-# 回滚：/opt/docker/infra/Caddyfile.bak-* 备份 + docker rm -f caddy 后用旧参数重建。
-
-on:
-  workflow_dispatch:
-
-jobs:
-  switch:
-    runs-on: ubuntu-latest
-    container:
-      image: docker:24
-    steps:
-      - name: Recreate caddy (file_server + mount /data/www/userbase)
-        run: |
-          set -e
-          apk add --no-cache jq
-
-          # 0) 前端目录与初始软链接（避免 caddy 因 root 不存在而启动失败）
-          docker run --rm -v /data/www/userbase:/data/www/userbase alpine sh -c '
-            mkdir -p /data/www/userbase/releases
-            if [ ! -e /data/www/userbase/front ]; then
-              mkdir -p /data/www/userbase/releases/initial
-              ln -sfn /data/www/userbase/releases/initial /data/www/userbase/front
-            fi
-          '
-
-          # 1) 备份 + 替换宿主 Caddyfile 中唯一的前后端反代行
-          docker run --rm -v /opt/docker/infra:/opt/docker/infra alpine sh -c '
-            cp -f /opt/docker/infra/Caddyfile /opt/docker/infra/Caddyfile.bak-$(date +%Y%m%d-%H%M)
-            sed -i "s#reverse_proxy userbase-front:80#root * /data/www/userbase/front\n\tfile_server\n\ttry_files {path} /index.html#" /opt/docker/infra/Caddyfile
-            echo "=== 新的 /userbase 块 ==="
-            grep -n -A4 "handle_path /userbase" /opt/docker/infra/Caddyfile
-          '
-
-          # 2) 按现有 caddy 容器参数重建（保留原 image/端口/挂载/网络，追加前端目录挂载）
-          docker inspect caddy > /tmp/c.json
-          IMG=$(jq -r '.[0].Config.Image' /tmp/c.json)
-          NET=$(jq -r '.[0].HostConfig.NetworkMode' /tmp/c.json)
-          PORTS=$(jq -r '.[0].HostConfig.PortBindings | to_entries[]? | "-p \(.value[0].HostPort):\(.key | rtrimstr("/tcp"))"' /tmp/c.json | tr "\n" " ")
-          BINDS=$(jq -r '.[0].HostConfig.Binds[]? | "-v \(.)"' /tmp/c.json | tr "\n" " ")
-          CMD=$(jq -r '.[0].Config.Cmd | join(" ")' /tmp/c.json)
-          echo "recreate caddy: IMG=$IMG NET=$NET PORTS=[$PORTS] BINDS=[$BINDS] CMD=[$CMD]"
-
-          docker rm -f caddy 2>/dev/null || true
-          # shellcheck disable=SC2086
-          docker run -d --name caddy --restart unless-stopped --network "$NET" $PORTS $BINDS -v /data/www/userbase:/data/www/userbase "$IMG" $CMD
-
-          sleep 6
-          docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Image}}' | grep -E 'caddy|userbase' || true
-
-          # 3) 旧的 userbase-front 容器已被 Caddy file_server 取代
-          docker rm -f userbase-front 2>/dev/null || echo "userbase-front already removed"
-          echo "CADDY SWITCH DONE"

.gitea/workflows/deploy.yml

@@ -6,8 +6,8 @@ name: deploy-userbase-front
 #       -> 拷贝到 /data/www/userbase/releases/<version>/
 #       -> 原子切换 /data/www/userbase/front 软链接指向新版本
 #       -> 保留最近 5 个版本，更早自动清理（秒级回滚）
-# 不再构建/推送 nginx 镜像；Caddy 由 caddy-switch 工作流一次性改为 file_server。
+# 不再构建/推送 nginx 镜像；Caddy 已改为 file_server（root=/srv/userbase=/data/www/userbase）。
-# 依赖：160 宿主的 docker daemon（runner 已挂 docker.sock）。无需 NEXUS secret。
+# 依赖：160 宿主的 docker daemon（runner 已挂 docker.sock），且 runner valid_volumes 已放行 /data/www/**。无需 NEXUS secret。
 
 on:
   push:
@@ -58,16 +58,24 @@ jobs:
             npm run build:prod
           '
 
-          # 部署：拷贝 dist/prod -> releases/<version>，原子切换软链接
+          # 部署：首次把真实目录 front 迁入 releases/initial 并建软链；之后均为软链替换
           docker exec frontbuild sh -c '
             set -e
             cd /build
+            # ---- 首次初始化：front 当前是真实目录，无法直接 ln -sfn 覆盖 ----
+            if [ ! -L /data/www/userbase/front ]; then
+              mkdir -p /data/www/userbase/releases
+              mv /data/www/userbase/front /data/www/userbase/releases/initial
+              ln -sfn /data/www/userbase/releases/initial /data/www/userbase/front
+              echo "INIT: front -> releases/initial (保留上线前状态用于回滚)"
+            fi
+
             mkdir -p /data/www/userbase/releases/$VERSION
             cp -r /build/dist/prod/. /data/www/userbase/releases/$VERSION/
-            # 原子切换：ln -sfn 不跟随已有链接，直接替换指向
+            # 原子切换：front 此时已是软链接，ln -sfn 直接替换指向
             ln -sfn /data/www/userbase/releases/$VERSION /data/www/userbase/front
             echo "current symlink ->"; ls -la /data/www/userbase/front
-            # 清理旧版本，保留最近 5 个
+            # 清理旧版本，保留最近 5 个（initial 也会被计入，最多保留 5 个含 initial）
             cd /data/www/userbase/releases
             ls -1t | tail -n +6 | while read d; do echo "rm old: $d"; rm -rf "$d"; done
             echo "remaining versions:"; ls -1t