# 部署方案模板 · 脚本模板 · 排查提示词 ## 一、部署方案模板 ```markdown # {项目} {版本} 部署方案 ## 1 变更范围 | 类型 | 内容 | |---|---| | 新增文件 | | | 修改配置 | | | 数据库 DDL | | | 数据库 DML | | | **不涉及** | | ## 2 前置检查 | 检查项 | 命令 | 期望结果 | |---|---|---| | 磁盘空间 | `df -h /opt` | 可用 > 5G | | JDK 版本 | `java -version` | 17.x | | 端口占用 | `ss -lntp \| grep 8080` | 无输出 | | 数据库连通 | `mysql -h x -u x -p -e "select 1"` | 返回 1 | ## 3 部署步骤 | # | 步骤 | 命令 | 耗时 | 失败处理 | |---|---|---|---|---| | 1 | 备份当前版本 | `tar -czf $BACKUP_DIR/app-$(date +%F).tar.gz $APP_HOME` | 1min | 停止部署 | | 2 | 停止应用 | `systemctl stop demo` | 10s | 查进程是否卡死 | | 3 | 替换包 | `\cp -f demo.jar $APP_HOME/` | 5s | — | | 4 | 执行 DDL | `mysql < v1.2.0.sql` | 30s | 用备份回滚 | | 5 | 启动 | `systemctl start demo` | 30s | 看启动日志 | | 6 | 健康检查 | `curl -f localhost:8080/actuator/health` | — | 触发回滚 | ## 4 回滚预案 | 触发条件 | 回滚动作 | 耗时 | 数据影响 | |---|---|---|---| | 启动失败超过 2 次 | 恢复上一版本包 + 重启 | 2min | 无 | | 健康检查连续 3 次失败 | 同上 | 2min | 无 | | DDL 执行失败 | 恢复数据库备份 | 10min | 该时段数据丢失 | | 上线后 1 小时内错误率 > 5% | 应用回滚 + 数据订正评估 | 5min | 需评估 | ## 5 验证清单 | # | 验证项 | 方法 | 通过标准 | |---|---|---|---| | 1 | 应用健康 | `/actuator/health` | status=UP | | 2 | 关键接口 | curl 登录接口 | 返回 code=0 | | 3 | 页面可访问 | 浏览器打开首页 | 无 502/504 | | 4 | 定时任务 | 查看日志 | 无异常 | | 5 | 日志无报错 | `tail -200` | 无 ERROR | ``` ## 二、脚本模板 ```bash #!/usr/bin/env bash # 用途:{项目} {版本} 应用部署 # 作者:{姓名} 日期:2026-11-12 # 回滚:./rollback.sh {上一版本号} set -euo pipefail APP_NAME=demo APP_HOME=/opt/app/${APP_NAME} BACKUP_DIR=/data/backup/${APP_NAME} VERSION=v1.2.0 PORT=8080 log(){ echo "[$(date '+%F %T')] $*"; } die(){ log "ERROR: $*"; exit 1; } [ -d "$APP_HOME" ] || die "目录不存在:$APP_HOME" mkdir -p "$BACKUP_DIR" log "1/5 备份当前版本" tar -czf "${BACKUP_DIR}/${APP_NAME}-$(date +%F_%H%M).tar.gz" -C "$APP_HOME" . || die "备份失败,中止" log "2/5 停止应用" systemctl stop "$APP_NAME" || true log "3/5 部署新版本" install -m 644 "${APP_NAME}-${VERSION}.jar" "${APP_HOME}/${APP_NAME}.jar" || die "替换失败" log "4/5 启动应用" systemctl start "$APP_NAME" log "5/5 健康检查" for i in $(seq 1 10); do if curl -fs "http://127.0.0.1:${PORT}/actuator/health" >/dev/null; then log "部署成功:${VERSION}"; exit 0 fi sleep 3 done log "健康检查失败,请执行 ./rollback.sh <上一版本>" exit 1 ``` ## 三、排查提示词 ``` 环境问题排查。已知信息: - 操作系统:CentOS 7.9 - 现象:浏览器访问 https://xxx 报 502 - 拓扑:Nginx → 本机 8080(Spring Boot) - 最近变更:昨天升级了 JDK 请按网络层 → 服务层 → 依赖层 → 应用层给我排查路径。 每层给出:判断命令、正常表现、异常表现、下一步动作。 不要直接让我重启服务。 ``` ## 四、数据变更提示词 ``` 我需要把 leave_apply 表中 approve_status=0 且 create_time 早于 2026-01-01 的记录标记为作废。 约束: 1. 先给我 SELECT 语句,包含 count 和抽样 20 条 2. 给我备份语句(建备份表) 3. 更新语句必须分批,每批 1000 行,每批之间有 sleep 4. 给我验证语句,确认更新前后行数一致 5. 不要直接给我一条 UPDATE 表结构:<粘贴> 数据量级:约 30 万行,符合条件的约 2 万行 ``` ## 五、常见环境问题速查 | 现象 | 优先排查 | 常见原因 | |---|---|---| | 502 Bad Gateway | 后端进程在不在、端口听没听 | 应用没起来 / 端口占错 | | 504 超时 | 后端处理耗时、Nginx 超时配置 | 慢 SQL / 超时设置过短 | | 连接被拒 | 防火墙、SELinux、监听地址 | 只监听了 127.0.0.1 | | 证书报错 | 证书有效期、证书链、域名匹配 | 中间证书缺失 | | 中文乱码 | 数据库字符集、连接串参数 | 用了 latin1 | | 依赖缺失 | 内网源、离线包 | 无外网时 yum 装不上 |