部署方案模板 · 脚本模板 · 排查提示词
一、部署方案模板
# {项目} {版本} 部署方案
## 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 |
二、脚本模板
#!/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 装不上 |