diff --git a/backend/DEPLOY.md b/backend/DEPLOY.md new file mode 100644 index 0000000..aa10a6c --- /dev/null +++ b/backend/DEPLOY.md @@ -0,0 +1,125 @@ +# 打包与自动部署说明 + +本文档说明如何编译、打包并自动部署 **admin 后端(miao-admin-2.2.jar)** 与 **admin 后台前端** 到远程服务器(含备份后上传、重启)。 + +--- + +## 一、环境与前置条件 + +- **本机**:已安装 JDK 8、Maven、Node.js、npm;项目根目录为 `single-shop-22`,其下包含 `backend`、`frontend`。 +- **SSH 免密**:已配置本机到目标服务器的 SSH 公钥(推荐使用 `id_ed25519_crmeb_deploy`,或通过环境变量指定密钥)。 +- **部署配置**:`backend/deploy.conf` 中配置了各环境(如 by80、miao50)的服务器地址、目录、jar 名等。 + +--- + +## 二、by80 环境一键部署(推荐) + +部署目标:Spring Profile **miao80**,产出 **miao-admin-2.2.jar** + admin 后台静态,上传到 by80 配置的服务器。 + +### 1. 配置 SSH 免密(一次性) + +在项目外任意目录执行(将 `root` 和 `123.56.214.80` 换成实际用户与主机): + +```bash +ssh-copy-id -i ~/.ssh/id_ed25519_crmeb_deploy.pub root@123.56.214.80 +``` + +提示输入 **远程服务器 root 密码**(不要用 `sudo`,否则会提示的是本机密码)。成功后即可免密 SSH/SCP。 + +### 2. 执行自动部署脚本 + +在 **backend 目录** 下执行: + +```bash +cd /path/to/single-shop-22/backend +./shell/deploy-admin-by80.sh +``` + +使用其他密钥时: + +```bash +SSH_IDENTITY=~/.ssh/你的私钥 ./shell/deploy-admin-by80.sh +``` + +### 3. 脚本会依次执行 + +| 步骤 | 说明 | +|------|------| +| 1. 编译后端 | `mvn clean package -pl crmeb-admin -am -DskipTests`,生成 `crmeb-admin/target/miao-admin-2.2.jar` | +| 2. 编译前端 | 在 `frontend` 目录执行 `npm run build:prod`(带 Node 17+ OpenSSL 兼容),生成 `frontend/dist` | +| 3. 远程备份 | 备份远程已有 jar 到 `REMOTE_DIR_JAR/backups/`,后台静态打包为 `jfadmin_backup_yyyyMMdd_HHmmss.tar.gz` | +| 4. 上传 jar | 将 `miao-admin-2.2.jar` 上传到 `REMOTE_DIR_JAR`(by80 默认 `/www/wwwroot/crmeb`) | +| 5. 上传后台静态 | 将 `frontend/dist` 通过 tar 管道上传到 `REMOTE_DIR_ADMIN`(by80 默认 `/www/wwwroot/jfadmin.bosenyuan.com`) | +| 6. 远程重启 | 在远程执行 `pkill -f miao-admin-2.2.jar` 后使用 `--spring.profiles.active=miao80`、`--server.port=30032` 启动 jar | + +--- + +## 三、部署配置(deploy.conf) + +配置位于 **backend/deploy.conf**,按段落区分环境(如 by80、miao50)。by80 段示例: + +- `SERVER_HOST`:服务器 IP(如 123.56.214.80) +- `SERVER_USER`:SSH 用户(如 root) +- `SERVER_PORT`:SSH 端口(如 22) +- `REMOTE_DIR_JAR`:jar 上传目录(如 /www/wwwroot/crmeb) +- `REMOTE_DIR_ADMIN`:admin 后台静态站点目录(如 /www/wwwroot/jfadmin.bosenyuan.com) +- `ADMIN_JAR_NAME`:admin jar 文件名(如 miao-admin-2.2.jar) +- `ADMIN_LOCAL_PORT`:admin 服务端口(如 30032) + +修改后无需改脚本,脚本会从该文件读取对应段配置。 + +--- + +## 四、仅编译/打包(不部署) + +### 仅后端(miao-admin-2.2.jar) + +```bash +cd backend +mvn clean package -pl crmeb-admin -am -DskipTests +# 产出:backend/crmeb-admin/target/miao-admin-2.2.jar +``` + +运行时指定 profile:`java -jar miao-admin-2.2.jar --spring.profiles.active=miao80 --server.port=30032`。 + +### 仅前端(admin 后台) + +```bash +cd frontend +export NODE_OPTIONS="${NODE_OPTIONS:-} --openssl-legacy-provider" # Node 17+ 需要 +npm run build:prod +# 产出:frontend/dist +``` + +--- + +## 五、远程服务器上手动重启 admin + +若自动重启未生效,可 SSH 登录后手动操作: + +```bash +ssh -i ~/.ssh/id_ed25519_crmeb_deploy root@123.56.214.80 + +cd /www/wwwroot/crmeb +pkill -f miao-admin-2.2.jar || true +sleep 2 +nohup java -jar miao-admin-2.2.jar --spring.profiles.active=miao80 --server.port=30032 > admin.log 2>&1 & + +# 检查是否启动 +pgrep -f miao-admin-2.2.jar && echo "Admin 已启动" || tail -50 admin.log +``` + +--- + +## 六、其他环境(如 miao50) + +miao50 使用脚本 **backend/shell/deploy-admin-miao50.sh**,逻辑类似:编译 admin、上传 jar、远程重启(profile=miao50)。配置来自 deploy.conf 中 miao50 段。若需同时部署前端静态,可参考 by80 脚本在 miao50 脚本中增加备份与上传 `frontend/dist` 的步骤。 + +--- + +## 七、故障排查 + +- **SSH Permission denied**:检查是否已执行 `ssh-copy-id`,且未使用 `sudo`;或指定正确 `SSH_IDENTITY`。 +- **前端构建报错 OpenSSL / digital envelope**:在运行 `npm run build:prod` 前设置 `export NODE_OPTIONS="--openssl-legacy-provider"`(脚本已包含)。 +- **远程找不到 rsync**:当前 by80 脚本已改为使用 tar 管道上传前端,不依赖远程 rsync。 +- **jar 未启动**:SSH 登录服务器查看 `admin.log` 及 `pgrep -f miao-admin-2.2.jar`。 diff --git a/backend/deploy.conf b/backend/deploy.conf index bbbf122..76bf113 100644 --- a/backend/deploy.conf +++ b/backend/deploy.conf @@ -6,7 +6,8 @@ by80: SERVER_HOST=123.56.214.80 SERVER_USER=root SERVER_PORT=22 -REMOTE_DIR=/www/wwwroot/crmeb +REMOTE_DIR_JAR=/www/wwwroot/crmeb +REMOTE_DIR_ADMIN=/www/wwwroot/jfadmin.bosenyuan.com FRONT_LOCAL_PORT=30031 FRONT_JAR_NAME=miao-front-2.2.jar ADMIN_LOCAL_PORT=30032 diff --git a/backend/shell/deploy-admin-by80.sh b/backend/shell/deploy-admin-by80.sh new file mode 100755 index 0000000..9215c5c --- /dev/null +++ b/backend/shell/deploy-admin-by80.sh @@ -0,0 +1,97 @@ +#!/bin/bash +# 编译前后端,使用 spring profile miao80 打包 miao-admin-2.2.jar, +# 备份远程原有文件后通过 SSH 上传并重启(admin jar + admin 后台静态) +# 一次性配置免密: ssh-copy-id -i ~/.ssh/id_ed25519_crmeb_deploy.pub root@123.56.214.80 +# 或指定密钥: SSH_IDENTITY=~/.ssh/your_key ./shell/deploy-admin-by80.sh +# 使用: ./shell/deploy-admin-by80.sh(在 backend 目录下) + +set -e +SSH_IDENTITY="${SSH_IDENTITY:-$HOME/.ssh/id_ed25519_crmeb_deploy}" +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +BACKEND_DIR="$(cd "$SCRIPT_DIR/.." && pwd)" +ROOT_DIR="$(cd "$BACKEND_DIR/.." && pwd)" +FRONTEND_DIR="$ROOT_DIR/frontend" +DEPLOY_CONF="$BACKEND_DIR/deploy.conf" + +# 解析 by80 段配置(deploy.conf 中 by80 段到 miao50 段之间的 KEY=value) +get_conf() { + sed -n '1,/^miao50:/p' "$DEPLOY_CONF" | grep -E "^${1}=" | tail -1 | cut -d= -f2- +} +SERVER_HOST=$(get_conf SERVER_HOST) +SERVER_USER=$(get_conf SERVER_USER) +SERVER_PORT=$(get_conf SERVER_PORT) +REMOTE_DIR_JAR=$(get_conf REMOTE_DIR_JAR) +REMOTE_DIR_ADMIN=$(get_conf REMOTE_DIR_ADMIN) +ADMIN_JAR_NAME=$(get_conf ADMIN_JAR_NAME) +ADMIN_LOCAL_PORT=$(get_conf ADMIN_LOCAL_PORT) + +[[ -z "$SERVER_HOST" ]] && SERVER_HOST=123.56.214.80 +[[ -z "$REMOTE_DIR_JAR" ]] && REMOTE_DIR_JAR=/www/wwwroot/crmeb +[[ -z "$REMOTE_DIR_ADMIN" ]] && REMOTE_DIR_ADMIN=/www/wwwroot/jfadmin.bosenyuan.com +[[ -z "$ADMIN_JAR_NAME" ]] && ADMIN_JAR_NAME=miao-admin-2.2.jar +[[ -z "$ADMIN_LOCAL_PORT" ]] && ADMIN_LOCAL_PORT=30032 +[[ -z "$SERVER_USER" ]] && SERVER_USER=root +[[ -z "$SERVER_PORT" ]] && SERVER_PORT=22 + +JAR_PATH="$BACKEND_DIR/crmeb-admin/target/$ADMIN_JAR_NAME" +REMOTE_JAR="$REMOTE_DIR_JAR/$ADMIN_JAR_NAME" +[[ -f "$SSH_IDENTITY" ]] && SSH_OPTS=(-o "IdentityFile=$SSH_IDENTITY") || SSH_OPTS=() +SSH_CMD=(ssh "${SSH_OPTS[@]}" -o StrictHostKeyChecking=accept-new -p "$SERVER_PORT" "$SERVER_USER@$SERVER_HOST") +SCP_CMD=(scp "${SSH_OPTS[@]}" -o StrictHostKeyChecking=accept-new -P "$SERVER_PORT") + +BACKUP_SUFFIX="backup_$(date +%Y%m%d_%H%M%S)" + +echo "=== 1. 编译后端 (crmeb-admin, profile=miao80) ===" +cd "$BACKEND_DIR" +mvn clean package -pl crmeb-admin -am -DskipTests -q +echo "已生成: $JAR_PATH" +[[ ! -f "$JAR_PATH" ]] && { echo "错误: jar 未生成"; exit 1; } + +echo "" +echo "=== 2. 编译前端 (admin 后台) ===" +cd "$FRONTEND_DIR" +# Node.js 17+ OpenSSL 兼容 +export NODE_OPTIONS="${NODE_OPTIONS:-} --openssl-legacy-provider" +npm run build:prod +echo "已生成: $FRONTEND_DIR/dist" +[[ ! -d "$FRONTEND_DIR/dist" ]] && { echo "错误: dist 未生成"; exit 1; } + +echo "" +echo "=== 3. 远程备份原有文件 ===" +"${SSH_CMD[@]}" "bash -s" << REMOTE_BACKUP +set -e +mkdir -p "$REMOTE_DIR_JAR/backups" +if [ -f "$REMOTE_JAR" ]; then + cp -a "$REMOTE_JAR" "$REMOTE_DIR_JAR/backups/${ADMIN_JAR_NAME}.${BACKUP_SUFFIX}" + echo "已备份 jar: $REMOTE_DIR_JAR/backups/${ADMIN_JAR_NAME}.${BACKUP_SUFFIX}" +fi +if [ -d "$REMOTE_DIR_ADMIN" ] && [ "\$(ls -A $REMOTE_DIR_ADMIN 2>/dev/null)" ]; then + BACKUP_TAR="$REMOTE_DIR_ADMIN/../jfadmin_${BACKUP_SUFFIX}.tar.gz" + tar -czf "\$BACKUP_TAR" -C "$REMOTE_DIR_ADMIN" . + echo "已备份后台静态: \$BACKUP_TAR" +fi +REMOTE_BACKUP + +echo "" +echo "=== 4. 上传 miao-admin-2.2.jar 到 $REMOTE_DIR_JAR ===" +"${SCP_CMD[@]}" "$JAR_PATH" "$SERVER_USER@$SERVER_HOST:$REMOTE_DIR_JAR/" +echo "jar 上传完成." + +echo "" +echo "=== 5. 上传 admin 后台静态 (dist) 到 $REMOTE_DIR_ADMIN ===" +# 先清空远程目录再上传,避免残留旧文件(远程可能无 rsync,统一用 tar 管道) +"${SSH_CMD[@]}" "mkdir -p $REMOTE_DIR_ADMIN && (rm -rf ${REMOTE_DIR_ADMIN}/* ${REMOTE_DIR_ADMIN}/.??* 2>/dev/null; true)" +(cd "$FRONTEND_DIR/dist" && tar cf - .) | "${SSH_CMD[@]}" "mkdir -p $REMOTE_DIR_ADMIN && cd $REMOTE_DIR_ADMIN && tar xf -" +echo "后台静态上传完成." + +echo "" +echo "=== 6. 远程重启 admin 服务 (profile=miao80, port=$ADMIN_LOCAL_PORT) ===" +"${SSH_CMD[@]}" "cd $REMOTE_DIR_JAR && \ + (pkill -f $ADMIN_JAR_NAME || true) && \ + sleep 2 && \ + nohup java -jar $ADMIN_JAR_NAME --spring.profiles.active=miao80 --server.port=$ADMIN_LOCAL_PORT > admin.log 2>&1 & \ + sleep 3 && \ + (pgrep -f $ADMIN_JAR_NAME && echo 'Admin 进程已启动' || echo '请检查 admin.log 启动是否失败')" + +echo "" +echo "=== 部署完成 ===" diff --git a/frontend/.env.development b/frontend/.env.development index d63fbf8..e7a6fcd 100644 --- a/frontend/.env.development +++ b/frontend/.env.development @@ -7,6 +7,8 @@ ENV = 'development' # VUE_APP_BASE_API = 'https://jfadmin.suzhouyuqi.com' # VUE_APP_BASE_API = 'http://jfanyueadmin.szxingming.com' # VUE_APP_BASE_API = 'http://jfadmin.wenjinhui.com' +# VUE_APP_BASE_API = 'http://jfadmin-bsy.bosenyuan.com' + # vue-cli uses the VUE_CLI_BABEL_TRANSPILE_MODULES environment variable, # to control whether the babel-plugin-dynamic-import-node plugin is enabled. diff --git a/frontend/.env.production b/frontend/.env.production index d399c7d..c581cd8 100644 --- a/frontend/.env.production +++ b/frontend/.env.production @@ -3,7 +3,9 @@ ENV = 'production' # base api # VUE_APP_BASE_API = '/prod-api' -# VUE_APP_BASE_API = 'http://127.0.0.1:8080' -# VUE_APP_BASE_API = 'https://jf.suzhouyuqi.com' -# VUE_APP_BASE_API = 'http://jfadmin.xiashengjun.com' -VUE_APP_BASE_API = 'http://jfanyueadmin.szxingming.com' +# VUE_APP_BASE_API = 'http://127.0.0.1:8080' +# VUE_APP_BASE_API = 'https://jf.suzhouyuqi.com' +# VUE_APP_BASE_API = 'http://jfadmin.xiashengjun.com' +# VUE_APP_BASE_API = 'http://jfanyueadmin.szxingming.com' +VUE_APP_BASE_API = 'http://jfadmin-bsy.bosenyuan.com' + diff --git a/frontend/DEPLOY.md b/frontend/DEPLOY.md new file mode 100644 index 0000000..26e07c7 --- /dev/null +++ b/frontend/DEPLOY.md @@ -0,0 +1,80 @@ +# 前端打包与自动部署发布 + +本文档说明 **admin 后台前端** 的打包、以及如何自动部署发布到远程服务器(含与后端一起一键发布)。 + +--- + +## 一、环境要求 + +- **Node.js**、**npm** 已安装。 +- **Node 17+** 需设置 OpenSSL 兼容(见下方打包命令)。 +- 部署到远程前需完成 **SSH 免密**(见 [backend/DEPLOY.md](../backend/DEPLOY.md))。 + +--- + +## 二、前端打包 + +在 **frontend 目录** 下执行: + +```bash +cd frontend + +# Node 17+ 如遇 digital envelope 报错,先执行: +export NODE_OPTIONS="${NODE_OPTIONS:-} --openssl-legacy-provider" + +npm run build:prod +``` + +- **产出目录**:`frontend/dist` +- **用途**:admin 后台静态资源,将 `dist` 内容部署到站点根目录(如 Nginx 或 CDN)。 + +--- + +## 三、自动部署发布(推荐) + +前端与后端一起发布时,使用 **backend 的一键部署脚本**,会自动完成:前端打包 → 后端打包 → 远程备份 → 上传 jar 与 `dist` → 重启服务。 + +在项目 **backend 目录** 下执行: + +```bash +cd backend +./shell/deploy-admin-by80.sh +``` + +脚本会: + +1. 编译后端,生成 `miao-admin-2.2.jar` +2. **在 frontend 目录执行 `npm run build:prod`**,生成 `dist` +3. 远程备份原有 jar 与后台静态 +4. 上传 jar 到 `REMOTE_DIR_JAR`,上传 **dist 到 REMOTE_DIR_ADMIN** +5. 远程重启 admin 服务(Spring Profile miao80) + +即:**前端无需单独操作,一次执行即可完成前端打包 + 自动部署发布**。 +SSH 配置、deploy.conf、故障排查见:**[backend/DEPLOY.md](../backend/DEPLOY.md)**。 + +--- + +## 四、部署配置(前端相关) + +配置在 **backend/deploy.conf**,by80 段示例: + +| 配置项 | 说明 | 示例 | +|--------|------|------| +| **REMOTE_DIR_ADMIN** | 前端 dist 发布目录(admin 后台站点根目录) | `/www/wwwroot/jfadmin.bosenyuan.com` | + +脚本通过 **tar 管道** 将 `frontend/dist` 内容上传到该目录,不依赖远程安装 rsync。 + +--- + +## 五、仅打包不发布 + +若只需在本地生成 `dist`、不执行上传与重启: + +```bash +cd frontend +export NODE_OPTIONS="${NODE_OPTIONS:-} --openssl-legacy-provider" +npm run build:prod +# 产出:frontend/dist +``` + +完整自动部署步骤、备份与重启说明见 **[backend/DEPLOY.md](../backend/DEPLOY.md)**。