fix deploy backup blocking publish

scripts/deploy/production-stdb-publish.sh

@@ -5,14 +5,15 @@ set -euo pipefail
 usage() {
   cat <<'EOF'
 用法:
-  ./scripts/deploy/production-stdb-publish.sh --source-dir build/<version> --database <database> [--server-url http://127.0.0.1:3101] [--server local] [--root-dir /stdb] [--run-as-user spacetimedb] [--clear-database] [--skip-backup]
+  ./scripts/deploy/production-stdb-publish.sh --source-dir build/<version> --database <database> [--server-url http://127.0.0.1:3101] [--server local] [--root-dir /stdb] [--run-as-user spacetimedb] [--clear-database] [--backup-mode async|sync|skip]
 
 说明:
   进入维护模式，校验 spacetime_module.wasm.sha256，并在生产实例本机执行 spacetime publish。
   默认使用 http://127.0.0.1:3101，避免与部署机本机 Git/Web 服务的 3000 端口冲突。
   默认使用 /stdb 作为 spacetime CLI root-dir，并以 spacetimedb 用户发布，避免 root CLI 身份污染自托管实例。
   发布时固定追加 --no-config，只使用显式参数，避免工作区或用户目录里的 spacetime 配置干扰目标。
-  publish 前默认执行一次 OSS 冷备份；备份失败会阻断 publish。仅明确传入 --skip-backup 时跳过。
+  默认在 publish 成功后异步触发 genarrative-database-backup.service，避免低带宽 OSS 上传阻塞部署。
+  如需强制等待备份完成并在失败时阻断 publish，传入 --backup-mode sync。
   失败时保留维护模式。
 EOF
 }
@@ -44,7 +45,7 @@ SERVER_URL="http://127.0.0.1:3101"
 SPACETIME_ROOT_DIR="/stdb"
 RUN_AS_USER="spacetimedb"
 CLEAR_DATABASE=0
-SKIP_BACKUP=0
+BACKUP_MODE="${GENARRATIVE_STDB_PUBLISH_BACKUP_MODE:-async}"
 DEPLOY_COMPLETED=0
 PUBLISH_TMP_DIR=""
 
@@ -84,9 +85,17 @@ while [[ $# -gt 0 ]]; do
       shift
       ;;
     --skip-backup)
-      SKIP_BACKUP=1
+      BACKUP_MODE="skip"
       shift
       ;;
+    --sync-backup)
+      BACKUP_MODE="sync"
+      shift
+      ;;
+    --backup-mode)
+      BACKUP_MODE="${2:?缺少 --backup-mode 的值}"
+      shift 2
+      ;;
     *)
       echo "[production-stdb-publish] 未知参数: $1" >&2
       usage >&2
@@ -104,6 +113,11 @@ if [[ ! "${SPACETIME_ROOT_DIR}" == /* || "${SPACETIME_ROOT_DIR}" == *".."* ]]; t
   exit 1
 fi
 
+if [[ ! "${BACKUP_MODE}" =~ ^(async|sync|skip)$ ]]; then
+  echo "[production-stdb-publish] --backup-mode 只能是 async、sync 或 skip: ${BACKUP_MODE}" >&2
+  exit 1
+fi
+
 if [[ -n "${RUN_AS_USER}" && ! "${RUN_AS_USER}" =~ ^[A-Za-z_][A-Za-z0-9_-]*$ ]]; then
   echo "[production-stdb-publish] --run-as-user 只能是本机用户名: ${RUN_AS_USER}" >&2
   exit 1
@@ -134,27 +148,47 @@ on_exit() {
 
 trap on_exit EXIT
 
+trigger_async_backup() {
+  # Jenkins 发布路径不能被低带宽 OSS 上传长时间占住；默认只把已安装的 systemd
+  # oneshot 备份任务排队启动。必须放在 publish 成功后，避免冷备份停止 SpacetimeDB
+  # 与 spacetime publish 同时争用 spacetimedb.service。
+  if command -v systemctl >/dev/null 2>&1 && systemctl list-unit-files genarrative-database-backup.service --no-legend | grep -q '^genarrative-database-backup\.service'; then
+    echo "[production-stdb-publish] 异步触发数据库 OSS 备份，不等待上传完成"
+    if ! systemctl start --no-block genarrative-database-backup.service; then
+      echo "[production-stdb-publish] 警告：异步触发数据库备份失败；继续发布，请检查 genarrative-database-backup.service 日志" >&2
+    fi
+  else
+    echo "[production-stdb-publish] 警告：未找到 genarrative-database-backup.service，跳过异步备份触发" >&2
+  fi
+}
+
 "${SCRIPT_DIR}/maintenance-on.sh" "spacetime module publish ${DATABASE}"
 
-if [[ "${SKIP_BACKUP}" -ne 1 ]]; then
-  BACKUP_SCRIPT="${SCRIPT_DIR}/../database-backup-to-oss.mjs"
-  if [[ ! -f "${BACKUP_SCRIPT}" ]]; then
-    BACKUP_SCRIPT="${SOURCE_DIR}/scripts/database-backup-to-oss.mjs"
-  fi
-  if [[ ! -f "${BACKUP_SCRIPT}" ]]; then
-    echo "[production-stdb-publish] 缺少 publish 前数据库备份脚本: ${BACKUP_SCRIPT}" >&2
-    exit 1
-  fi
+case "${BACKUP_MODE}" in
+  async)
+    echo "[production-stdb-publish] 将在 publish 成功后异步触发数据库 OSS 备份"
+    ;;
+  sync)
+    BACKUP_SCRIPT="${SCRIPT_DIR}/../database-backup-to-oss.mjs"
+    if [[ ! -f "${BACKUP_SCRIPT}" ]]; then
+      BACKUP_SCRIPT="${SOURCE_DIR}/scripts/database-backup-to-oss.mjs"
+    fi
+    if [[ ! -f "${BACKUP_SCRIPT}" ]]; then
+      echo "[production-stdb-publish] 缺少 publish 前数据库备份脚本: ${BACKUP_SCRIPT}" >&2
+      exit 1
+    fi
 
-  echo "[production-stdb-publish] publish 前执行 OSS 冷备份"
-  node "${BACKUP_SCRIPT}" \
-    --env-file /etc/genarrative/api-server.env \
-    --data-dir "${SPACETIME_ROOT_DIR}" \
-    --database "${DATABASE}" \
-    --stop-service spacetimedb.service
-else
-  echo "[production-stdb-publish] 已按参数跳过 publish 前数据库备份"
-fi
+    echo "[production-stdb-publish] publish 前同步执行 OSS 冷备份，失败会阻断发布"
+    node "${BACKUP_SCRIPT}" \
+      --env-file /etc/genarrative/api-server.env \
+      --data-dir "${SPACETIME_ROOT_DIR}" \
+      --database "${DATABASE}" \
+      --stop-service spacetimedb.service
+    ;;
+  skip)
+    echo "[production-stdb-publish] 已按参数跳过 publish 前数据库备份"
+    ;;
+esac
 
 echo "[production-stdb-publish] 校验 wasm"
 (
@@ -218,4 +252,9 @@ fi
 
 "${SCRIPT_DIR}/maintenance-off.sh"
 DEPLOY_COMPLETED=1
+
+if [[ "${BACKUP_MODE}" == "async" ]]; then
+  trigger_async_backup
+fi
+
 echo "[production-stdb-publish] 完成"