Files
novalon-website/scripts/deploy.sh
T
zhangxiang c0c41eb528 chore(release): 生产 seed 与 compose 漂移闭环、回滚重建容器、PR #29 与发布证据入库
- AUTH-D2 生产 db:seed 已执行:esbuild 打包真 seed → 生产库副本演练 → 逐表差异
  (Permission +63/−0、ContentItem 37→38、24 条随 seed 源更新、User 口令逐字节未变)
  → 停容器窗口内用生产镜像跑 → 事后取回比对。快照 prod.db.bak.20261008_174734-preseed
- H compose 漂移已消除:先 diff 证明只差挂载一行,备份后同步并重建,
  docker inspect 现取 ./uploads -> /app/public/uploads
- I cmd_rollback 追加 docker-compose build && up -d 与就绪轮询,并复用资源级 verify
- J PR #29 建成(qa/seal-2026-09-28 → dev,mergeable true);同时作废「本环境无 Gitea
  token」这条由 `2>/dev/null` 吞掉报错造成的假事实,教训入 lessons §5.35
- 新登记 K:navigation 与 site-config 在 seed 的 permissionMatrix 里无授予项
- 证据:docs/acceptance/2026-10-08-release/(build/deploy/type-check/lint 日志、
  seed 演练与逐表差异脚本及输出)
2026-10-08 17:58:21 +08:00

557 lines
19 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env bash
# ============================================================
# Novalon 统一发布脚本
#
# 用法:
# ./scripts/deploy.sh [命令] [选项]
#
# 命令:
# build 构建静态产物 (npm run build / npm run build:clean)
# deploy 构建并发布到生产服务器 (默认命令)
# rollback 回滚到最近一次远程备份
# status 查看生产环境发布状态
# help 显示帮助
#
# 选项:
# --skip-build 跳过本地构建,直接使用现有 dist/
# --auto-rollback 部署/验证失败时自动回滚到最近备份
# --clean 构建前清理 .next 与 dist
# --server-ip IP 服务器地址 (默认 139.155.109.62)
# --server-user USER SSH 用户 (默认 root)
# --deploy-root PATH 服务器部署根目录 (默认 /home/novalon/docker-app)
# --project-name NAME 服务器项目目录名 (默认 novalon-website)
# --nginx-container C Nginx 容器名 (默认 novalon-nginx-secure)
# --domain URL 验证域名 (默认 https://novalon.cn)
# --backup-retention N 远程备份保留份数 (默认 3)
# --dist-dir DIR 本地构建产物目录 (默认 dist)
# --dry-run 只打印远程命令,不实际执行
# -h, --help 显示帮助
#
# 环境变量覆盖:
# SERVER_IP SERVER_USER DEPLOY_ROOT PROJECT_NAME NGINX_CONTAINER
# NEXTJS_CONTAINER COMPOSE_FILE COMPOSE_CMD
# DOMAIN BACKUP_RETENTION_COUNT DIST_DIR
# ============================================================
set -euo pipefail
# ---------- 默认配置 ----------
SERVER_IP="${SERVER_IP:-139.155.109.62}"
SERVER_USER="${SERVER_USER:-root}"
DEPLOY_ROOT="${DEPLOY_ROOT:-/home/novalon/docker-app}"
PROJECT_NAME="${PROJECT_NAME:-novalon-website}"
NGINX_CONTAINER="${NGINX_CONTAINER:-novalon-nginx-secure}"
NEXTJS_CONTAINER="${NEXTJS_CONTAINER:-novalon-website}"
COMPOSE_FILE="${COMPOSE_FILE:-docker-compose.server.yml}"
COMPOSE_CMD="${COMPOSE_CMD:-docker-compose}"
DOMAIN="${DOMAIN:-https://novalon.cn}"
BACKUP_RETENTION="${BACKUP_RETENTION_COUNT:-${BACKUP_RETENTION:-3}}"
DIST_DIR="${DIST_DIR:-dist}"
REMOTE_PROJECT_DIR="$DEPLOY_ROOT/$PROJECT_NAME"
REMOTE_DIST_DIR="$REMOTE_PROJECT_DIR/dist"
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
LOG_DIR="$PROJECT_ROOT/logs"
LOG_FILE="$LOG_DIR/deploy_$(date +%Y%m%d_%H%M%S).log"
# ---------- 运行时状态 ----------
COMMAND="${1:-deploy}"
SKIP_BUILD=0
AUTO_ROLLBACK=0
CLEAN_BUILD=0
DRY_RUN=0
DEPLOY_STARTED=0
# ---------- 工具函数 ----------
usage() {
awk '
NR == 1 { next }
/^# =+$/ { c++; if (c == 2) exit }
{ line = $0; sub(/^# ?/, "", line); print line }
' "$0"
}
log() {
echo -e "$@"
}
require_local_cmd() {
local cmd="$1"
if ! command -v "$cmd" >/dev/null 2>&1; then
log "❌ 缺少本地命令: $cmd"
exit 1
fi
}
run_remote() {
# 用法: run_remote <远程命令字符串>
# 远程命令会在目标服务器的 bash 中执行
local remote_cmd="$1"
if [[ "$DRY_RUN" == "1" ]]; then
log "🔍 [dry-run] ssh $SERVER_USER@$SERVER_IP \"$remote_cmd\""
return 0
fi
ssh -o ConnectTimeout=8 -o BatchMode=yes "$SERVER_USER@$SERVER_IP" "$remote_cmd"
}
verify_remote() {
log ""
log "=========================================="
log "📋 步骤 7: 验证生产环境"
log "=========================================="
local pages=("/" "/about" "/contact" "/products" "/services")
local failed=0
for page in "${pages[@]}"; do
local url="${DOMAIN}${page}"
local status
status=$(curl -fsS -o /dev/null -w '%{http_code}' -L --connect-timeout 8 --max-time 15 "$url" 2>/dev/null || echo "000")
if [[ "$status" == "200" ]]; then
log " ✅ $page ($status)"
else
log " ❌ $page ($status)"
failed=1
fi
done
# 资源级断言:只查 HTML 页会把「CSS/JS 全 404 的破站」判成部署成功
# (2026-10-08 事故:nginx web root 镜像缺失,5 个页面全 200 而站点无样式)。
log ""
log "📋 静态资源断言(从首页 HTML 实际引用的 URL 取样)"
local html assets asset status checked=0
html=$(curl -fsSL --max-time 15 "${DOMAIN}/" 2>/dev/null || echo "")
if [[ -z "$html" ]]; then
log " ❌ 首页 HTML 取回为空,无法取样资源"
failed=1
else
assets=$(printf '%s\n' "$html" | grep -o '/_next/static/[^"]*\.\(js\|css\)' | sort -u | head -5)
if [[ -z "$assets" ]]; then
log " ❌ 首页 HTML 里没出现 /_next/static 引用(构建异常)"
failed=1
fi
for asset in $assets "/favicon.ico"; do
checked=$((checked + 1))
status=$(curl -s -o /dev/null -w '%{http_code}' --max-time 15 "${DOMAIN}${asset}" 2>/dev/null || echo "000")
if [[ "$status" == "200" ]]; then
log " ✅ ${asset} ($status)"
else
log " ❌ ${asset} ($status)"
failed=1
fi
done
log " 取样数: $checked"
fi
if [[ "$failed" == "1" ]]; then
log "❌ 生产环境验证失败"
return 1
fi
log "✅ 生产环境验证通过"
}
# ---------- 命令实现 ----------
cmd_build() {
log "=========================================="
log "📋 构建静态站点"
log "=========================================="
cd "$PROJECT_ROOT"
# 生产构建必须注入 .env.production 中的前后端加密密钥。
# Next.js 加载 env 的优先级为 .env.local > .env.production,
# 若不显式注入,构建时会使用 .env.local 中的开发密钥,
# 导致前端 chunk 密钥与后端 ENCRYPTION_SECRET 不匹配,
# CMS 所有列表/仪表盘解密失败(The operation failed for an operation-specific reason)。
if [[ -f "$PROJECT_ROOT/.env.production" ]]; then
PROD_ENC_SECRET=$(grep '^NEXT_PUBLIC_ENCRYPTION_SECRET=' "$PROJECT_ROOT/.env.production" | head -1 | cut -d= -f2- | tr -d '"')
if [[ -n "$PROD_ENC_SECRET" ]]; then
export NEXT_PUBLIC_ENCRYPTION_SECRET="$PROD_ENC_SECRET"
log "✅ 已注入生产加密密钥到构建环境"
else
log "⚠️ .env.production 中未找到 NEXT_PUBLIC_ENCRYPTION_SECRET,请检查配置"
fi
else
log "⚠️ 未找到 .env.production,无法注入生产加密密钥"
fi
if [[ "$CLEAN_BUILD" == "1" ]]; then
npm run build:clean
else
npm run build
fi
if [[ ! -d "$DIST_DIR" ]]; then
log "❌ 构建失败:$DIST_DIR 目录不存在"
exit 1
fi
# standalone 构建不会把 public/ 输出到 dist 根目录;
# Nginx 以 dist 作为站点根目录,因此手动同步 public 静态资源(logo、favicon、fonts、images 等)
if [[ -d "$PROJECT_ROOT/public" ]]; then
cp -R "$PROJECT_ROOT/public/." "$DIST_DIR/"
log "✅ public 静态资源已同步到 $DIST_DIR"
fi
# standalone 构建的客户端静态资源位于 dist/static,而 HTML 引用 /_next/static/...;
# 复制到 dist/_next/static 供 Nginx 直接服务
if [[ -d "$DIST_DIR/static" ]]; then
mkdir -p "$DIST_DIR/_next"
cp -R "$DIST_DIR/static" "$DIST_DIR/_next/static"
log "✅ _next/static 已从 static 同步到 $DIST_DIR/_next/static"
fi
log "✅ 构建完成,产物大小: $(du -sh "$DIST_DIR" | cut -f1)"
}
cmd_deploy() {
log "=========================================="
log "🚀 Novalon 统一发布"
log " 目标: $SERVER_USER@$SERVER_IP:$REMOTE_DIST_DIR"
log " 域名: $DOMAIN"
log "=========================================="
if [[ "$SKIP_BUILD" != "1" ]]; then
cmd_build
elif [[ ! -d "$DIST_DIR" ]]; then
log "❌ $DIST_DIR 目录不存在,请先构建或去掉 --skip-build"
exit 1
fi
require_local_cmd ssh
require_local_cmd rsync
require_local_cmd curl
# 步骤 1: 检查本地产物
log ""
log "📋 步骤 1: 检查构建产物"
DIST_SIZE=$(du -sh "$DIST_DIR" | cut -f1)
log "✅ $DIST_DIR 目录存在,大小: $DIST_SIZE"
# 步骤 1.5: 生成 nginx web root 镜像
# 远端 nginx 的 root 就是本脚本上传的 dist/(nginx-static-production.conf:132,136-142 的
# location /_next/static/ 用 try_files $uri =404),而 next build 的布局是
# dist/static/**(无 _next 前缀)+ 独立的 public/**。不同步这份镜像,rsync --delete 就会
# 抹掉上一次部署留下的镜像 ⇒ HTML 全 200 而 CSS/JS/图标全 404(2026-10-08 线上事故根因)。
log ""
log "📋 步骤 1.5: 生成 nginx web root 镜像 (dist/_next/static + public → dist 根)"
if [[ ! -d "$DIST_DIR/static" ]]; then
log "❌ $DIST_DIR/static 不存在,产物未装配,终止部署"
exit 1
fi
rm -rf "$DIST_DIR/_next/static"
mkdir -p "$DIST_DIR/_next"
cp -R "$DIST_DIR/static" "$DIST_DIR/_next/static"
[[ -d "$PROJECT_ROOT/public" ]] && cp -R "$PROJECT_ROOT/public/." "$DIST_DIR/"
log "✅ 镜像完成: _next=$(du -sh "$DIST_DIR/_next" | cut -f1) dist=$(du -sh "$DIST_DIR" | cut -f1)"
# 步骤 2: 验证 SSH 连接
log ""
log "📋 步骤 2: 验证 SSH 连接"
if ! run_remote "exit"; then
log "❌ 无法连接到服务器 $SERVER_IP"
exit 1
fi
log "✅ SSH 连接验证成功"
# 步骤 3: 远程备份旧版本
log ""
log "📋 步骤 3: 备份服务器上的旧版本"
run_remote "
set -e
PROJECT_DIR='$REMOTE_PROJECT_DIR'
DIST_PATH='$REMOTE_DIST_DIR'
if [ -d \"\$DIST_PATH\" ]; then
TIMESTAMP=\$(date +%Y%m%d_%H%M%S)
BACKUP_PATH=\"\$PROJECT_DIR/dist_backup_\$TIMESTAMP\"
cp -r \"\$DIST_PATH\" \"\$BACKUP_PATH\"
echo \"✅ 备份完成: \$BACKUP_PATH\"
else
echo \"ℹ️ 首次部署,无需备份\"
fi
"
DEPLOY_STARTED=1
# 步骤 4: 清理旧备份(保留最近 N 份)
log ""
log "📋 步骤 4: 清理旧备份(保留最近 ${BACKUP_RETENTION} 份)"
run_remote "
set -e
PROJECT_DIR='$REMOTE_PROJECT_DIR'
cd \"\$PROJECT_DIR\" || exit 0
ls -dt ${REMOTE_PROJECT_DIR}/dist_backup_* 2>/dev/null | tail -n +$((BACKUP_RETENTION + 1)) | xargs rm -rf 2>/dev/null || true
echo \"✅ 清理完成\"
"
# 步骤 5: 上传 dist 目录
log ""
log "📋 步骤 5: 上传 dist 目录"
if [[ "$DRY_RUN" == "1" ]]; then
log "🔍 [dry-run] rsync -avz --delete \"$DIST_DIR/\" $SERVER_USER@$SERVER_IP:$REMOTE_DIST_DIR/"
else
ssh "$SERVER_USER@$SERVER_IP" "mkdir -p '$REMOTE_DIST_DIR'"
rsync -avz --delete "$DIST_DIR/" "$SERVER_USER@$SERVER_IP:$REMOTE_DIST_DIR/"
fi
log "✅ dist 目录已上传"
# 步骤 6: 设置权限并重载 Nginx
log ""
log "📋 步骤 6: 设置权限并重载 Nginx"
run_remote "
set -e
DIST_PATH='$REMOTE_DIST_DIR'
chown -R www-data:www-data \"\$DIST_PATH\" 2>/dev/null || true
chmod -R 755 \"\$DIST_PATH\"
echo \"✅ 权限设置完成\"
"
run_remote "
set -e
if docker exec $NGINX_CONTAINER nginx -t 2>/dev/null; then
docker exec $NGINX_CONTAINER nginx -s reload
echo \"✅ Nginx 重载成功\"
else
echo \"⚠️ Nginx 配置检测失败,重启容器...\"
docker restart $NGINX_CONTAINER
sleep 3
echo \"✅ Nginx 容器已重启\"
fi
"
# 步骤 6.5: 同步 public 并重建 Next.js 容器
# 混合渲染下,Nginx 提供新客户端资源,Next.js 容器也必须运行同一份构建,
# 否则会出现 /_next/static 404 或 Server Reference ID 不匹配。
log ""
log "📋 步骤 6.5: 重建 Next.js 容器 ($NEXTJS_CONTAINER)"
if [[ -d "$PROJECT_ROOT/public" ]]; then
if [[ "$DRY_RUN" == "1" ]]; then
log "🔍 [dry-run] rsync -az --delete \"$PROJECT_ROOT/public/\" $SERVER_USER@$SERVER_IP:$REMOTE_PROJECT_DIR/public/"
else
rsync -az --delete "$PROJECT_ROOT/public/" "$SERVER_USER@$SERVER_IP:$REMOTE_PROJECT_DIR/public/"
fi
fi
run_remote "
set -e
cd '$REMOTE_PROJECT_DIR'
if [ -f '$COMPOSE_FILE' ]; then
$COMPOSE_CMD -f '$COMPOSE_FILE' build
$COMPOSE_CMD -f '$COMPOSE_FILE' up -d
echo \"✅ Next.js 容器已重建,等待就绪...\"
READY=0
for i in \$(seq 1 30); do
if curl -fsS -o /dev/null --max-time 3 http://127.0.0.1:3000/ 2>/dev/null; then
READY=1
break
fi
sleep 2
done
if [ \"\$READY\" = \"1\" ]; then
echo \"✅ $NEXTJS_CONTAINER 就绪\"
else
echo \"❌ $NEXTJS_CONTAINER 未就绪,请检查容器日志\"
exit 1
fi
else
echo \"⚠️ 未找到 ${COMPOSE_FILE},跳过 Next.js 容器重建\"
fi
"
# 步骤 7: 验证生产环境
if ! verify_remote; then
if [[ "$AUTO_ROLLBACK" == "1" ]]; then
log ""
log "🔄 自动回滚到最近备份..."
cmd_rollback
fi
exit 1
fi
log ""
log "🎉 部署成功!"
log "📋 访问地址: $DOMAIN"
}
cmd_rollback() {
log "=========================================="
log "🔄 回滚到最近一次远程备份"
log "=========================================="
require_local_cmd ssh
require_local_cmd curl
if ! run_remote "exit"; then
log "❌ 无法连接到服务器 $SERVER_IP"
exit 1
fi
log "📋 查找最近备份..."
LATEST_BACKUP=$(run_remote "
ls -dt ${REMOTE_PROJECT_DIR}/dist_backup_* 2>/dev/null | head -1
" | tr -d '\r')
if [[ -z "$LATEST_BACKUP" ]]; then
log "❌ 未找到任何备份,无法回滚"
exit 1
fi
log "✅ 最近备份: $LATEST_BACKUP"
run_remote "
set -e
PROJECT_DIR='$REMOTE_PROJECT_DIR'
DIST_PATH='$REMOTE_DIST_DIR'
BACKUP_PATH='$LATEST_BACKUP'
rm -rf \"\$DIST_PATH\"
cp -r \"\$BACKUP_PATH\" \"\$DIST_PATH\"
chown -R www-data:www-data \"\$DIST_PATH\" 2>/dev/null || true
chmod -R 755 \"\$DIST_PATH\"
echo \"✅ 已从备份恢复: \$BACKUP_PATH\"
"
run_remote "
set -e
if docker exec $NGINX_CONTAINER nginx -t 2>/dev/null; then
docker exec $NGINX_CONTAINER nginx -s reload
echo \"✅ Nginx 重载成功\"
else
docker restart $NGINX_CONTAINER
sleep 3
echo \"✅ Nginx 容器已重启\"
fi
"
# 回滚必须连 Next.js 容器一起回:Dockerfile.prod 是把 dist/standalone + dist/static + public
# 拷进镜像的,只恢复宿主 dist/ 而让容器继续跑新代码,会得到「旧静态资源 + 新服务端」的
# Server Reference ID 不匹配(页面 200 但 hydration/资源引用错乱)。2026-10-08 复盘补上。
log "📋 用回滚后的产物重建 Next.js 容器 ($NEXTJS_CONTAINER)"
run_remote "
set -e
cd '$REMOTE_PROJECT_DIR'
if [ -f '$COMPOSE_FILE' ]; then
$COMPOSE_CMD -f '$COMPOSE_FILE' build
$COMPOSE_CMD -f '$COMPOSE_FILE' up -d
READY=0
for i in \$(seq 1 30); do
if curl -fsS -o /dev/null --max-time 3 http://127.0.0.1:3000/ 2>/dev/null; then
READY=1
break
fi
sleep 2
done
if [ \"\$READY\" = \"1\" ]; then
echo \"✅ $NEXTJS_CONTAINER 已按回滚产物重建并就绪\"
else
echo \"❌ $NEXTJS_CONTAINER 重建后未就绪,请检查容器日志\"
exit 1
fi
else
echo \"⚠️ 未找到 $COMPOSE_FILE,跳过容器重建(此时回滚仅覆盖 nginx 侧静态资源)\"
fi
"
# 回滚同样要满足资源级断言:只查 HTML 页会把破站判成回滚成功
if verify_remote; then
log ""
log "🎉 回滚成功!"
else
log "❌ 回滚后验证失败,请手动介入"
exit 1
fi
}
cmd_status() {
log "=========================================="
log "📋 生产环境发布状态"
log "=========================================="
require_local_cmd ssh
if ! run_remote "exit"; then
log "❌ 无法连接到服务器 $SERVER_IP"
exit 1
fi
run_remote "
echo \"--- Nginx 容器 ---\"
docker ps --filter name=$NGINX_CONTAINER --format '{{.Names}} {{.Status}}' || echo '❌ 容器未运行'
echo
echo \"--- 远程 dist 目录 ---\"
ls -ld '$REMOTE_DIST_DIR' 2>/dev/null || echo '❌ 目录不存在'
echo \"文件数: \$(find '$REMOTE_DIST_DIR' -type f 2>/dev/null | wc -l)\"
echo
echo \"--- 最近修改 ---\"
find '$REMOTE_DIST_DIR' -maxdepth 1 -type f -printf '%T@ %f\n' 2>/dev/null | sort -rn | head -5
echo
echo \"--- 可用备份 ---\"
ls -dt ${REMOTE_PROJECT_DIR}/dist_backup_* 2>/dev/null | head -${BACKUP_RETENTION} || echo '无备份'
"
}
on_error() {
local rc=$?
if [[ "$COMMAND" == "deploy" && "$AUTO_ROLLBACK" == "1" && "$DEPLOY_STARTED" == "1" ]]; then
log ""
log "❌ 部署失败(exit=$rc),执行自动回滚..."
cmd_rollback >&2 || true
fi
exit "$rc"
}
trap on_error ERR
# ---------- 参数解析 ----------
case "$COMMAND" in
build|deploy|rollback|status|help|-h|--help) ;;
*)
log "❌ 未知命令: $COMMAND"
usage
exit 1
;;
esac
if [[ "$COMMAND" == "help" || "$COMMAND" == "-h" || "$COMMAND" == "--help" ]]; then
usage
exit 0
fi
shift || true
while [[ $# -gt 0 ]]; do
case "$1" in
--skip-build) SKIP_BUILD=1; shift ;;
--auto-rollback) AUTO_ROLLBACK=1; shift ;;
--clean) CLEAN_BUILD=1; shift ;;
--dry-run) DRY_RUN=1; shift ;;
--server-ip) SERVER_IP="$2"; shift 2 ;;
--server-user) SERVER_USER="$2"; shift 2 ;;
--deploy-root) DEPLOY_ROOT="$2"; shift 2 ;;
--project-name) PROJECT_NAME="$2"; shift 2 ;;
--nginx-container) NGINX_CONTAINER="$2"; shift 2 ;;
--domain) DOMAIN="$2"; shift 2 ;;
--backup-retention) BACKUP_RETENTION="$2"; shift 2 ;;
--dist-dir) DIST_DIR="$2"; shift 2 ;;
-h|--help) usage; exit 0 ;;
*)
log "❌ 未知参数: $1"
usage
exit 1
;;
esac
done
REMOTE_PROJECT_DIR="$DEPLOY_ROOT/$PROJECT_NAME"
REMOTE_DIST_DIR="$REMOTE_PROJECT_DIR/dist"
# ---------- 日志 ----------
mkdir -p "$LOG_DIR"
exec > >(tee -a "$LOG_FILE") 2>&1
log "📋 部署日志: $LOG_FILE"
log ""
# ---------- 执行 ----------
case "$COMMAND" in
build) cmd_build ;;
deploy) cmd_deploy ;;
rollback) cmd_rollback ;;
status) cmd_status ;;
esac