fix publish backup flow

scripts/deploy/production-stdb-publish.sh

@@ -12,7 +12,7 @@ usage() {
   默认使用 http://127.0.0.1:3101，避免与部署机本机 Git/Web 服务的 3000 端口冲突。
   默认使用 /stdb 作为 spacetime CLI root-dir，并以 spacetimedb 用户发布，避免 root CLI 身份污染自托管实例。
   发布时固定追加 --no-config，只使用显式参数，避免工作区或用户目录里的 spacetime 配置干扰目标。
-  默认在 publish 成功后异步触发 genarrative-database-backup.service，避免低带宽 OSS 上传阻塞部署。
+  async 模式会在 publish 前先做本地冷备份，再在 publish 完成后后台上传 OSS，避免低带宽上传阻塞部署。
   如需强制等待备份完成并在失败时阻断 publish，传入 --backup-mode sync。
   失败时保留维护模式。
 EOF
@@ -48,6 +48,11 @@ CLEAR_DATABASE=0
 BACKUP_MODE="${GENARRATIVE_STDB_PUBLISH_BACKUP_MODE:-async}"
 DEPLOY_COMPLETED=0
 PUBLISH_TMP_DIR=""
+ASYNC_BACKUP_STATUS_FILE=""
+ASYNC_BACKUP_SCRIPT=""
+ASYNC_BACKUP_ARCHIVE=""
+ASYNC_BACKUP_MANIFEST=""
+ASYNC_BACKUP_LOG=""
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
@@ -137,6 +142,9 @@ fi
 
 on_exit() {
   local exit_code=$?
+  if [[ "${BACKUP_MODE}" == "async" && -n "${ASYNC_BACKUP_STATUS_FILE}" && -f "${ASYNC_BACKUP_STATUS_FILE}" ]]; then
+    start_async_backup_upload || true
+  fi
   if [[ -n "${PUBLISH_TMP_DIR}" && -d "${PUBLISH_TMP_DIR}" ]]; then
     rm -rf "${PUBLISH_TMP_DIR}"
   fi
@@ -148,25 +156,58 @@ 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
+prepare_async_backup() {
+  ASYNC_BACKUP_SCRIPT="${SCRIPT_DIR}/../database-backup-to-oss.mjs"
+  if [[ ! -f "${ASYNC_BACKUP_SCRIPT}" ]]; then
+    ASYNC_BACKUP_SCRIPT="${SOURCE_DIR}/scripts/database-backup-to-oss.mjs"
   fi
+  if [[ ! -f "${ASYNC_BACKUP_SCRIPT}" ]]; then
+    echo "[production-stdb-publish] 缺少数据库备份脚本: ${ASYNC_BACKUP_SCRIPT}" >&2
+    exit 1
+  fi
+
+  ASYNC_BACKUP_STATUS_FILE="$(mktemp /tmp/genarrative-stdb-backup-status.XXXXXX.json)"
+  echo "[production-stdb-publish] publish 前生成本地冷备份，随后会异步上传 OSS"
+  node "${ASYNC_BACKUP_SCRIPT}" \
+    --env-file /etc/genarrative/api-server.env \
+    --data-dir "${SPACETIME_ROOT_DIR}" \
+    --database "${DATABASE}" \
+    --stop-service spacetimedb.service \
+    --defer-upload \
+    --result-file "${ASYNC_BACKUP_STATUS_FILE}"
+}
+
+start_async_backup_upload() {
+  if [[ -z "${ASYNC_BACKUP_STATUS_FILE}" || ! -f "${ASYNC_BACKUP_STATUS_FILE}" ]]; then
+    echo "[production-stdb-publish] 警告：未找到可上传的本地备份状态文件，跳过异步上传" >&2
+    return 0
+  fi
+
+  ASYNC_BACKUP_ARCHIVE="$(node -e 'const fs=require("node:fs"); const p=process.argv[1]; const o=JSON.parse(fs.readFileSync(p,"utf8")); process.stdout.write(o.archivePath || "");' "${ASYNC_BACKUP_STATUS_FILE}")"
+  ASYNC_BACKUP_MANIFEST="$(node -e 'const fs=require("node:fs"); const p=process.argv[1]; const o=JSON.parse(fs.readFileSync(p,"utf8")); process.stdout.write(o.manifestPath || "");' "${ASYNC_BACKUP_STATUS_FILE}")"
+  if [[ -z "${ASYNC_BACKUP_ARCHIVE}" || -z "${ASYNC_BACKUP_MANIFEST}" ]]; then
+    echo "[production-stdb-publish] 警告：备份状态文件缺少 archivePath 或 manifestPath，跳过异步上传" >&2
+    return 0
+  fi
+
+  mkdir -p "$(dirname "${ASYNC_BACKUP_ARCHIVE}")"
+  ASYNC_BACKUP_LOG="$(dirname "${ASYNC_BACKUP_ARCHIVE}")/${DATABASE}-upload.log"
+  echo "[production-stdb-publish] 后台上传本地备份到 OSS: ${ASYNC_BACKUP_ARCHIVE}"
+  nohup node "${ASYNC_BACKUP_SCRIPT}" \
+    --env-file /etc/genarrative/api-server.env \
+    --upload-archive "${ASYNC_BACKUP_ARCHIVE}" \
+    --manifest-file "${ASYNC_BACKUP_MANIFEST}" \
+    >"${ASYNC_BACKUP_LOG}" 2>&1 &
+  echo "[production-stdb-publish] OSS 后台上传日志: ${ASYNC_BACKUP_LOG}"
+  rm -f "${ASYNC_BACKUP_STATUS_FILE}"
+  ASYNC_BACKUP_STATUS_FILE=""
 }
 
 "${SCRIPT_DIR}/maintenance-on.sh" "spacetime module publish ${DATABASE}"
 
 case "${BACKUP_MODE}" in
   async)
-    echo "[production-stdb-publish] 将在 publish 成功后异步触发数据库 OSS 备份"
+    prepare_async_backup
     ;;
   sync)
     BACKUP_SCRIPT="${SCRIPT_DIR}/../database-backup-to-oss.mjs"
@@ -253,8 +294,4 @@ fi
 "${SCRIPT_DIR}/maintenance-off.sh"
 DEPLOY_COMPLETED=1
 
-if [[ "${BACKUP_MODE}" == "async" ]]; then
-  trigger_async_backup
-fi
-
 echo "[production-stdb-publish] 完成"