Skip to content

U
ubains-module-test
提交 62d99bce authored 作者: PGY's avatar PGY
浏览文件
操作

feat(文档): 更新定时任务配置说明文档

上级 e190f249
显示空白字符变更
内嵌 并排
正在显示 包含 475 行增加 和 466 行删除
自动化部署脚本/x86架构/预定系统/定时脚本/clean_deleted_ubains_v2.sh deleted 100644 → 0
浏览文件 @ e190f249
#!/bin/bash
# ================= 配置区域 =================
TARGET_KEY="ubains-INFO-AND-ERROR"
MIN_SIZE=$((1024*1024*1024)) # 1GB (单位：字节)
LOG_FILE="/var/log/scripts/auto_clean_deleted_ubains.log"
MAX_LOG_SIZE=$((5*1024*1024)) # 5MB 日志大小限制
LOG_RETENTION_DAYS=7 # 日志保留天数
CONTAINER_NAME="ujava2" # 容器名称
# ===========================================
# 日志函数
log() {
echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" | tee -a "$LOG_FILE"
}
# 日志轮转
rotate_logs() {
if [ -f "$LOG_FILE" ]; then
FILE_SIZE=$(stat -c%s "$LOG_FILE")
if [ "$FILE_SIZE" -ge "$MAX_LOG_SIZE" ]; then
mv "$LOG_FILE" "$LOG_FILE.$(date '+%Y%m%d%H%M%S')"
touch "$LOG_FILE"
log "日志文件超过 5MB，已自动轮转。"
fi
fi
# 修改为在日志文件所在目录查找备份文件
find "$(dirname "$LOG_FILE")" -name "auto_clean_deleted_ubains.log.*" -mtime +$LOG_RETENTION_DAYS -exec rm -f {} \;
}
rotate_logs
log "==============================================="
log "开始扫描：检测 deleted 大文件并自动清理 (内核直读版)"
log "匹配关键字: $TARGET_KEY"
log "大于尺寸: 1GB"
log "==============================================="
FOUND=0
NEED_RESTART=0
# 遍历所有进程的 fd 目录，寻找匹配关键字且标记为 deleted 的文件
for fd_path in /proc/[0-9]*/fd/*; do
# 检查是否为符号链接且指向包含关键字的已删除文件
if [ -L "$fd_path" ]; then
target_file=$(readlink "$fd_path" 2>/dev/null)
if [[ "$target_file" == *"(deleted)"* ]] && [[ "$target_file" == *"$TARGET_KEY"* ]]; then
FOUND=1
# 提取 PID 和 FD
pid=$(echo "$fd_path" | cut -d'/' -f3)
fd=$(echo "$fd_path" | cut -d'/' -f5)
# 获取进程名
proc_name="unknown"
[ -f "/proc/$pid/comm" ] && proc_name=$(cat "/proc/$pid/comm")
# 获取文件大小 (字节) - 使用 stat -L 获取链接指向的实际文件状态
size_bytes=$(stat -L -c %s "$fd_path" 2>/dev/null || echo 0)
size_mb=$((size_bytes / 1024 / 1024))
log "-----------------------------------------------"
log "发现匹配文件："
log "进程: $proc_name"
log "PID: $pid"
log "FD: $fd"
log "文件: $target_file"
log "大小: $size_mb MB"
if [ "$size_bytes" -ge "$MIN_SIZE" ]; then
log "⚠ 文件超过1GB，执行自动处理。"
log "➡ 杀死进程 PID: $pid"
kill -9 "$pid" 2>/dev/null
sleep 1
NEED_RESTART=1
else
log "⏩ 文件不足 1GB，跳过。"
fi
fi
fi
done
if [ "$FOUND" -eq 0 ]; then
log "未发现匹配的 deleted 文件。"
fi
if [ "$NEED_RESTART" -eq 1 ]; then
log "➡ 检测到大文件进程已处理，统一重启 docker 容器：$CONTAINER_NAME"
# 检查 docker 命令是否存在
if command -v docker >/dev/null 2>&1; then
docker restart "$CONTAINER_NAME" >> "$LOG_FILE" 2>&1
log "✔ Docker 容器重启完成。"
else
log "❌ 错误: 未找到 docker 命令，请手动重启容器。"
fi
else
log "无需重启 docker 容器。"
fi
log "🎉 执行结束。"
log "==============================================="
自动化部署脚本/x86架构/预定系统/定时脚本/配置说明 deleted 100644 → 0
浏览文件 @ e190f249
# 预定系统定时任务配置说明
## 一、目录结构说明
- **脚本存放目录**：`/opt/scripts/`
- **日志文件目录**：`/var/log/scripts/`
- **日志文件命名规则**：`脚本名.log`
- **MySQL备份目录**：`/opt/mysql/YYYYMMDD/`
- **Nginx日志备份目录**：`/opt/nginx/logs/`
## 二、部署步骤
1. **上传脚本文件**：将所有定时任务脚本上传至服务器的 `/opt/scripts` 目录下
2. **设置脚本权限**：
```bash
chmod +x /opt/scripts/*.sh
```
3. **创建日志目录**（如果不存在）：
```bash
sudo mkdir -p /var/log/scripts/
sudo chown $(whoami):$(whoami) /var/log/scripts/
```
4. **创建备份目录**（如不存在）：
```bash
sudo mkdir -p /opt/mysql /opt/nginx/logs
sudo chown $(whoami):$(whoami) /opt/mysql /opt/nginx/logs
```
## 三、定时任务配置
执行以下命令编辑 crontab：
```bash
crontab -e
```
添加以下定时任务配置：
```
# ==================== 预定系统定时任务配置 ====================
# 每日凌晨1点备份MySQL数据库
# 功能：备份umysql容器内指定的10个数据库，自动清理30天前的备份
0 1 * * * /opt/scripts/backup_mysql_databases.sh
# 每日凌晨2点备份MySQL日志
# 功能：备份MySQL日志文件(.log/.slow)，保留原始权限，自动清理过期备份
0 2 * * * /opt/scripts/backup_mysql_logs.sh
# 每日凌晨3点备份Nginx日志
# 功能：备份Nginx访问日志和错误日志，压缩后清空原文件并通知Nginx重新打开日志
0 3 * * * /opt/scripts/backup_nginx_logs.sh
# 每日凌晨4点检查并清理被占用的已删除文件
# 功能：查找link count为0但仍被进程占用的文件，发送SIGHUP信号释放句柄
# 说明：提供两种清理脚本，分别针对普通文件和预定ubains相关文件，避免误杀进程
0 4 * * * /opt/scripts/cleanup_deleted_files.sh
0 4 * * * /opt/scripts/clean_deleted_ubains_v2.sh
# 每5分钟监测EMQX服务状态
# 功能：检查uemqx容器运行状态、EMQX进程存在性和服务可用性，异常时自动重启
*/5 * * * * /opt/scripts/monitor_emqx_service.sh
# 每5分钟监测外部API服务状态
# 功能：监测ubains-meeting-api和malan服务进程，目录存在性，异常时自动启动
*/5 * * * * /opt/scripts/monitor_external_api_services.sh
# 每5分钟监测内部API服务状态
# 功能：检查平台API可用性、容器内meeting2.0服务和宿主机6060端口malan服务
*/5 * * * * /opt/scripts/monitor_inner_api_services.sh
# 每5分钟监测MySQL服务状态
# 功能：检查umysql容器、MySQL连接可用性和SQL执行能力，异常时自动重启
*/5 * * * * /opt/scripts/monitor_mysql_service.sh
# 每5分钟监测Redis服务状态
# 功能：检查uredis容器、Redis连接和认证状态，支持密码认证，异常时自动重启
*/5 * * * * /opt/scripts/monitor_redis_service.sh
# ==================== 定时任务结束 ====================
```
## 四、脚本功能详解
### 数据库相关脚本
#### backup_mysql_databases.sh - MySQL数据库备份脚本
- **功能描述**：备份umysql容器内指定的10个核心业务数据库
- **备份数据库列表**：
- devops, devops_voice, huazhao2, nacos_mysql, offline
- ubains, wifi, voice, ubains_nacos_config, ubains_sso
- **特色功能**：
- 容器内临时目录处理（带PID防冲突）
- 自动创建日期目录结构
- 30天自动清理过期备份
- 容器密码自动获取
- 完整的日志记录机制
#### backup_mysql_logs.sh - MySQL日志备份脚本
- **功能描述**：备份MySQL各种日志文件，包括慢查询日志和错误日志
- **备份文件类型**：.log, .slow, error.log等日志文件
- **特色功能**：
- 权限保存和恢复机制
- 自动压缩备份文件
- 保留原始日志文件
- 30天自动清理策略
### 服务监测脚本
#### monitor_emqx_service.sh - EMQX消息队列服务监测
- **监测维度**：
- uemqx容器运行状态检查
- 容器内EMQX进程存在性验证
- EMQX服务可用性检测（使用emqx_ctl status命令）
- **恢复机制**：
- 容器未运行时自动重启
- 服务状态异常时重启容器
- 重启后验证服务恢复情况
- **特色功能**：
- 多层次状态检查
- 精确的服务状态识别
- 自动化的恢复流程
#### monitor_mysql_service.sh - MySQL数据库服务监测
- **监测维度**：
- umysql容器运行状态
- MySQL连接可用性测试
- SQL执行能力验证
- **恢复机制**：
- 容器未运行时自动重启
- 密码自动获取和验证
- 功能完整性测试
- **特色功能**：
- 容器密码动态获取
- 多层次健康检查
- 完整的功能验证
#### monitor_redis_service.sh - Redis缓存服务监测
- **监测维度**：
- uredis容器运行状态
- Redis连接和认证状态检查
- PING命令响应验证
- **恢复机制**：
- 无密码和有密码双重测试
- 容器重启和数据清理
- 重启失败时的数据目录清理重试
- **重要配置**：
```
REDIS_PASSWORD="dNrprU&2S" # Redis认证密码
```
- **特色功能**：
- 支持有密码/无密码环境
- 渐进式恢复策略
- 数据目录清理机制
#### monitor_external_api_services.sh - 外部API服务监测
- **监测服务**：
- ubains-meeting-api服务
- malan服务
- **监测方式**：
- 进程存在性检查
- 服务目录存在性验证
- 启动脚本执行状态
- **恢复机制**：
- 服务缺失时自动启动
- 脚本执行失败时重试
#### monitor_inner_api_services.sh - 内部API服务监测
- **监测对象**：
- 平台API可用性（自动获取服务器IP）
- 容器内meeting2.0服务（支持ujava*模糊匹配）
- 宿主机6060端口malan服务
- **特色功能**：
- IP地址自动发现
- 容器名称模糊匹配（ujava2/ujava3/ujava6等）
- 分级恢复策略
- 调试模式支持
- **重要配置**：
```
CONTAINER_NAME="ujava2" # 支持模糊匹配
MALAN_DIR="/var/www/malan" # Malan服务目录
MALAN_PORT="6060" # Malan服务端口
DEBUG_MODE="true" # 调试模式开关
```
### 系统维护脚本
#### backup_nginx_logs.sh - Nginx日志备份脚本
- **处理文件**：access.log, error.log
- **特色功能**：
- 日志轮转和压缩
- Nginx信号通知（USR1）重新打开日志
- 权限保持机制
- 自动清理过期备份
#### cleanup_deleted_files.sh - 已删除文件清理脚本
- **处理对象**：被进程占用的已删除文件
- **处理方式**：SIGHUP信号释放文件句柄
- **安全机制**：避免强制kill进程，温和释放资源
#### clean_deleted_ubains_v2.sh - 预定系统专属文件清理脚本
- **特殊功能**：
- 专门处理ubains相关的已删除大文件（>1GB）
- 关键字匹配："ubains-INFO-AND-ERROR"
- 内核直读方式扫描
- 日志轮转和大小限制（5MB）
- 7天日志保留策略
- **重要配置**：
```
TARGET_KEY="ubains-INFO-AND-ERROR" # 匹配关键字
MIN_SIZE=$((1024*1024*1024)) # 1GB最小尺寸
MAX_LOG_SIZE=$((5*1024*1024)) # 5MB日志大小限制
LOG_RETENTION_DAYS=7 # 日志保留天数
```
## 五、配置参数说明
### 全局配置参数
| 参数名 | 默认值 | 说明 |
|--------|--------|------|
| LOG_FILE | /var/log/scripts/脚本名.log | 日志文件路径 |
| RETENTION_DAYS | 30 | 备份文件保留天数 |
| CONTAINER_NAME | 各脚本不同 | 目标容器名称 |
### 服务特定配置
| 脚本 | 容器名 | 特殊配置 | 说明 |
|------|--------|----------|------|
| backup_mysql_databases.sh | umysql | DB_USER="root" | 数据库用户名 |
| monitor_emqx_service.sh | uemqx | - | EMQX消息队列容器 |
| monitor_mysql_service.sh | umysql | - | MySQL数据库容器 |
| monitor_redis_service.sh | uredis | REDIS_PASSWORD="dNrprU&2S" | Redis认证密码 |
| monitor_inner_api_services.sh | ujava* | DEBUG_MODE="true" | 调试模式开关 |
## 六、注意事项
1. **日志输出**：所有脚本已在内部实现日志输出功能，无需在 crontab 中重定向输出
2. **权限要求**：
- 脚本执行用户需要docker执行权限
- 日志目录需要写入权限
- 备份目录需要读写权限
- 部分脚本可能需要sudo权限
3. **服务依赖**：
- 确保Docker服务正常运行
- 相关容器（umysql、uemqx、uredis、ujava*）需要预先创建
- Nginx服务需要配置相应的日志路径
4. **监控日志**：
- 定期检查 `/var/log/scripts/` 目录下的日志文件
- 关注脚本执行时间和错误信息
- 监控备份文件生成情况
5. **备份保留策略**：
- 数据库备份：保留30天
- 日志备份：保留30天
- 清理脚本日志：保留7天
- 可通过修改脚本中的RETENTION_DAYS参数调整
6. **密码安全管理**：
- Redis密码在monitor_redis_service.sh中硬编码
- 建议定期更换密码并在脚本中同步更新
- 考虑使用环境变量或加密存储替代硬编码
7. **容器名称适配**：
- 支持容器名称模糊匹配（ujava*）
- 脚本会自动查找匹配的容器实例
- 可根据实际环境修改CONTAINER_NAME配置
8. **系统资源监控**：
- 定期检查磁盘空间使用情况
- 监控内存和CPU使用率
- 注意大文件清理对系统性能的影响
## 七、故障排查
### 常见问题诊断
1. **检查脚本权限**：
```bash
ls -la /opt/scripts/
# 确保所有脚本都有执行权限
```
2. **检查定时任务是否生效**：
```bash
crontab -l
# 确认定时任务已正确添加
```
3. **查看实时日志**：
```bash
tail -f /var/log/scripts/脚本名.log
# 实时监控脚本执行情况
```
4. **手动执行脚本测试**：
```bash
/opt/scripts/脚本名.sh
# 验证脚本功能是否正常
```
5. **检查日志目录权限**：
```bash
ls -ld /var/log/scripts/
# 确保当前用户有写入权限
```
6. **检查容器状态**：
```bash
docker ps | grep -E "(umysql|uemqx|uredis|ujava)"
# 确认相关容器正在运行
```
7. **检查备份目录**：
```bash
ls -la /opt/mysql/
ls -la /opt/nginx/logs/
# 确认备份文件正常生成
```
### 错误处理指南
| 错误类型 | 可能原因 | 解决方案 |
|----------|----------|----------|
| 权限拒绝 | 用户无docker权限 | 将用户添加到docker组或使用sudo |
| 容器未找到 | 容器名称不匹配 | 检查并修改CONTAINER_NAME配置 |
| 连接失败 | 服务未启动或密码错误 | 检查服务状态和认证配置 |
| 磁盘空间不足 | 备份文件过多 | 清理旧备份或增加磁盘空间 |
| 脚本执行超时 | 系统负载过高 | 调整定时任务执行时间间隔 |
## 八、维护建议
1. **定期检查**：
- 每日检查关键服务监测脚本的执行情况
- 每周审查备份文件完整性和可用性
- 每月评估系统资源使用情况
2. **备份验证**：
- 定期验证备份文件的完整性和可恢复性
- 测试关键数据的恢复流程
- 建立备份恢复的标准操作程序
3. **日志管理**：
- 监控日志文件大小，避免磁盘空间不足
- 定期分析日志中的错误和警告信息
- 建立日志分析和报警机制
4. **性能优化**：
- 关注脚本执行时间和系统资源消耗
- 根据系统负载调整定时任务执行频率
- 优化大文件处理和清理策略
5. **安全更新**：
- 及时更新脚本以适应系统变更
- 定期审查和更新密码配置
- 加强日志文件的访问控制
6. **文档维护**：
- 保持配置说明文档与实际脚本同步更新
- 记录系统变更和配置调整历史
- 建立完善的运维知识库
\ No newline at end of file
自动化部署脚本/x86架构/预定系统/定时脚本/配置说明.md 0 → 100644
浏览文件 @ 62d99bce
# 预定系统定时任务配置说明（x86 架构）
> 版本：V1.0
> 更新日期：2026-03-17
> 适用范围：预定系统 x86 架构全套定时监控与维护脚本
> 部署路径：`/opt/scripts/`
> 日志路径：`/var/log/scripts/`
---
## 📁 脚本文件清单
### 一、服务监控类脚本（每 10 分钟执行）
| 序号 | 脚本名称 | 监控对象 | 日志文件 | 功能描述 |
|-----|---------|---------|---------|---------|
| 1 | `monitor_emqx_service.sh` | EMQX 消息队列 | `/var/log/scripts/monitor_emqx_service.log` | 容器状态 + 进程检查 + 服务验证（emqx_ctl status） |
| 2 | `monitor_mysql_service.sh` | MySQL数据库 | `/var/log/scripts/monitor_mysql_service.log` | 容器状态 + 连接测试 + SQL验证（mysqladmin ping） |
| 3 | `monitor_redis_service.sh` | Redis缓存 | `/var/log/scripts/monitor_redis_service.log` | 容器状态 + 认证识别 + PING验证 |
| 4 | `monitor_external_api_services_v2.sh` | 外部API服务 | `/var/log/scripts/monitor_external_api_services_v2.log` | 进程监控 + 目录验证 + 自动启动 |
| 5 | `monitor_inner_api_services.sh` | 内部API服务 | `/var/log/scripts/monitor_inner_api_services.log` | API检查 + 容器服务 + 端口监控 |
### 二、数据备份类脚本（每日执行）
| 序号 | 脚本名称 | 备份对象 | 日志文件 | 执行时间 | 保留周期 |
|-----|---------|---------|---------|---------|---------|
| 1 | `backup_mysql_databases.sh` | MySQL数据库 | `/var/log/scripts/backup_mysql_databases.log` | 每日 01:00 | 30 天 |
| 2 | `backup_mysql_logs.sh` | MySQL日志 | `/var/log/scripts/backup_mysql_logs.log` | 每日 02:00 | 30 天 |
| 3 | `backup_nginx_logs.sh` | Nginx日志 | `/var/log/scripts/backup_nginx_logs.log` | 每日 03:00 | 30 天 |
### 三、系统维护类脚本（每日执行）
| 序号 | 脚本名称 | 维护对象 | 日志文件 | 执行时间 | 功能描述 |
|-----|---------|---------|---------|---------|---------|
| 1 | `check_deleted_file_ubains.sh` | 已删除的文件 | `/var/log/scripts/check_deleted_file_ubains.log` | 手动触发 | 检测已删除文件 |
| 2 | `auto_clean_deleted_ubains_v3.sh` | 已删除大文件 | `/var/log/scripts/auto_clean_deleted_ubains.log` | 每日 04:00 | 清理>1GB 的 deleted 文件 |
---
## ⚙️ 统一配置规范
### 1. 环境配置
```bash
# 基础环境变量
CONTAINER_NAME="ujava2" # Java 应用容器
APP_PATH="/var/www/java/external-meeting-api" # 应用路径
APP_START_SCRIPT="${APP_PATH}/run.sh" # 应用启动脚本
# 数据库容器
MYSQL_CONTAINER="umysql"
REDIS_CONTAINER="uredis"
EMQX_CONTAINER="uemqx"
# 日志配置
LOG_DIR="/var/log/scripts/" # 统一日志目录
LOG_FORMAT="[YYYY-MM-DD HH:MM:SS] 日志内容"
MAX_LOG_SIZE="5MB" # 日志轮转阈值
LOG_RETENTION_DAYS=7 # 日志保留天数
```
### 2. 监控配置
#### 2.1 EMQX服务监控
```bash
TARGET_KEY="ubains-INFO-AND-ERROR" # 日志关键字
CHECK_INTERVAL="*/10 * * * *" # 每 10 分钟
HEALTH_CHECK="emqx_ctl status" # 健康检查命令
```
#### 2.2 MySQL服务监控
```bash
DB_USER="root" # 数据库用户
CHECK_METHOD="mysqladmin ping" # 连接检查
SQL_TEST="SELECT 1" # SQL 测试语句
```
#### 2.3 Redis服务监控
```bash
AUTH_ENABLED=true # 是否启用认证
CHECK_METHOD="redis-cli ping" # PING 检查
EXPECTED_RESPONSE="PONG" # 期望响应
```
### 3. 备份配置
#### 3.1 MySQL数据库备份
```bash
HOST_BACKUP_DIR="/opt/mysql" # 宿主机备份目录
RETENTION_DAYS=30 # 备份保留 30 天
TARGET_DBS=( # 备份数据库列表
"devops" "devops_voice" "huazhao2"
"nacos_mysql" "offline" "ubains"
"wifi" "voice" "ubains_nacos_config"
"ubains_sso"
)
COMPRESSION="gzip" # 压缩格式
```
#### 3.2 MySQL日志备份
```bash
LOG_PATH="/var/log/mysql" # MySQL日志路径
BACKUP_FORMAT="tar.gz" # 备份格式
CLEAN_OLD_BACKUP=true # 清理旧备份
```
#### 3.3 Nginx日志备份
```bash
NGINX_LOG_PATH="/var/log/nginx" # Nginx日志路径
ROTATE_METHOD="copytruncate" # 轮转方式
COMPRESS_AFTER_ROTATE=true # 轮转后压缩
```
### 4. 清理配置
#### 4.1 已删除文件清理
```bash
MIN_SIZE=$((1024*1024*1024)) # 最小清理尺寸：1GB
TARGET_KEY="ubains-INFO-AND-ERROR" # 匹配关键字
ACTION="kill_process_and_restart" # 处理方式
```
---
## 🕐 Crontab 定时任务配置
### 完整配置示例
```
# 编辑 crontab
crontab -e
# 预定系统定时任务配置
# ============================================
# ========== 服务监控类（每 10 分钟） ==========
*/10 * * * * /opt/scripts/monitor_emqx_service.sh
*/10 * * * * /opt/scripts/monitor_mysql_service.sh
*/10 * * * * /opt/scripts/monitor_redis_service.sh
*/10 * * * * /opt/scripts/monitor_external_api_services_v2.sh
*/10 * * * * /opt/scripts/monitor_inner_api_services.sh
# ========== 数据备份类（每日凌晨） ==========
0 1 * * * /opt/scripts/backup_mysql_databases.sh
0 2 * * * /opt/scripts/backup_mysql_logs.sh
0 3 * * * /opt/scripts/backup_nginx_logs.sh
# ========== 系统维护类（每日凌晨） ==========
0 4 * * * /opt/scripts/auto_clean_deleted_ubains_v3.sh
# ============================================
```
### 执行时间安排图
```
时间轴 (24 小时)
├─ 00:00 - 01:00 → 监控任务（每 10 分钟）
├─ 01:00 - 01:30 → MySQL数据库备份 ★
├─ 01:30 - 02:00 → 监控任务（每 10 分钟）
├─ 02:00 - 02:30 → MySQL日志备份 ★
├─ 02:30 - 03:00 → 监控任务（每 10 分钟）
├─ 03:00 - 03:30 → Nginx日志备份 ★
├─ 03:30 - 04:00 → 监控任务（每 10 分钟）
├─ 04:00 - 04:30 → 已删除文件清理 ★
└─ 04:30 - 24:00 → 监控任务（每 10 分钟）
★ = 重量级任务，错峰执行
```
---
## 🛠️ 部署步骤
### 1. 文件准备
```bash
# 创建脚本目录
sudo mkdir -p /opt/scripts
# 上传所有脚本文件至 /opt/scripts/ 目录
# 或使用 git 克隆
cd /opt/scripts
git clone <repository_url> .
```
### 2. 权限设置
```bash
# 设置所有脚本可执行权限
sudo chmod +x /opt/scripts/*.sh
# 设置日志目录权限
sudo mkdir -p /var/log/scripts
sudo chmod 755 /var/log/scripts
```
### 3. 依赖检查
```bash
# 检查必需命令是否可用
command -v docker >/dev/null 2>&1 && echo "✓ Docker 已安装"
command -v gzip >/dev/null 2>&1 && echo "✓ Gzip 已安装"
command -v mysqladmin >/dev/null 2>&1 && echo "✓ MySQL 客户端已安装"
command -v redis-cli >/dev/null 2>&1 && echo "✓ Redis 客户端已安装"
```
### 4. 定时任务配置
```bash
# 备份现有 crontab
crontab -l > ~/crontab.backup.$(date +%Y%m%d%H%M%S)
# 编辑 crontab
crontab -e
# 粘贴上述定时任务配置并保存
```
### 5. 验证测试
```bash
# 手动执行单个脚本验证
sudo /opt/scripts/monitor_emqx_service.sh
# 查看日志输出
tail -f /var/log/scripts/monitor_emqx_service.log
# 检查 cron 服务状态
sudo systemctl status cron
```
---
## 📊 监控与告警
### 1. 日志监控
```bash
# 实时查看所有脚本日志
tail -f /var/log/scripts/*.log
# 查看错误日志
grep "❌\|ERROR\|错误" /var/log/scripts/*.log
# 统计今日日志量
wc -l /var/log/scripts/*.log
```
### 2. 执行状态检查
```bash
# 检查 cron 任务执行记录
grep CRON /var/log/syslog | grep "/opt/scripts/"
# 查看最近一次执行时间
ls -lt /var/log/scripts/*.log | head -5
```
### 3. 资源使用监控
```bash
# 检查磁盘空间
df -h /opt/mysql
df -h /var/log
# 检查备份文件大小
du -sh /opt/mysql/*
```
### 4. 告警机制建议
```bash
# 添加钉钉通知函数（可选）
dingtalk_notify() {
local message="$1"
curl -X POST "https://oapi.dingtalk.com/robot/send?access_token=YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d "{\"msgtype\":\"text\",\"text\":{\"content\":\"$message\"}}"
}
# 在关键错误处调用
if [ 容器启动失败 ]; then
dingtalk_notify "⚠️ 警告：ujava2 容器启动失败，请检查！"
fi
```
---
## 🔧 故障排查
### 常见问题及解决方案
#### 1. 脚本无法执行
```bash
# 检查权限
ls -l /opt/scripts/*.sh
# 解决：添加执行权限
chmod +x /opt/scripts/script_name.sh
```
#### 2. 日志文件无写入
```bash
# 检查日志目录权限
ls -ld /var/log/scripts
# 解决：修改权限
sudo chown -R $USER:$USER /var/log/scripts
```
#### 3. Docker 命令无权限
```bash
# 将用户加入 docker 组
sudo usermod -aG docker $USER
# 重新登录或执行
newgrp docker
```
#### 4. Cron 任务未执行
```bash
# 检查 cron 服务
sudo systemctl status cron
# 启动服务
sudo systemctl start cron
# 设置开机自启
sudo systemctl enable cron
```
#### 5. 备份空间不足
```bash
# 清理过期备份（手动）
find /opt/mysql -name "*.sql.gz" -mtime +30 -delete
# 或调整保留天数（修改脚本配置）
RETENTION_DAYS=15 # 改为 15 天
```
---
## 📈 性能优化建议
### 1. 执行时间优化
- **错峰执行**：备份任务已安排在业务低峰期（凌晨 1-4 点）
- **负载均衡**：避免多个重量级任务同时执行
- **并发控制**：监控类脚本轻量级，可同时执行
### 2. 日志管理优化
```bash
# 添加日志轮转配置（/etc/logrotate.d/scripts）
cat > /etc/logrotate.d/scripts << EOF
/var/log/scripts/*.log {
daily
rotate 7
compress
delaycompress
missingok
notifempty
create 644 root root
}
EOF
```
### 3. 资源预留
- **内存要求**：≥10G（参考 Java 服务部署规范）
- **磁盘空间**：备份目录预留至少 100GB
- **CPU 核心**：≥4 核（支持并发监控）
---
## 🔐 安全性保障
### 1. 密码安全管理
```bash
# 从环境变量获取敏感信息（推荐）
export MYSQL_ROOT_PASSWORD="your_password"
# 或在脚本中使用 docker exec 获取
docker exec umysql printenv MYSQL_ROOT_PASSWORD
```
### 2. 权限最小化
```bash
# 仅授予必要的操作权限
chmod 755 /opt/scripts/*.sh # 脚本可执行
chmod 644 /var/log/scripts/*.log # 日志只读
chmod 700 /opt/mysql # 备份目录私有
```
### 3. 操作审计
```bash
# 记录所有关键操作
log() {
echo "[$(date '+%Y-%m-%d %H:%M:%S')] [$(whoami)] [$$] $*" | tee -a "$LOG_FILE"
}
```
---
## 📝 附录
### A. 容器清单
| 容器名 | 服务类型 | 端口 | 说明 |
|-------|---------|------|------|
| ujava2 | Java 应用 | 8080 | 主应用容器 |
| umysql | MySQL | 3306 | 数据库容器 |
| uredis | Redis | 6379 | 缓存容器 |
| uemqx | EMQX | 1883,8083 | 消息队列容器 |
### B. 相关文档
- [_PRD_预定系统定时脚本需求文档概览.md](../../../Docs/PRD/自动化部署脚本/_PRD_预定系统定时脚本需求文档概览.md)
- [_PRD_预定系统_EMQX服务监控需求文档.md](../../../Docs/PRD/自动化部署脚本/_PRD_预定系统_EMQX服务监控需求文档.md)
- [_PRD_预定系统_MySQL服务监控需求文档.md](../../../Docs/PRD/自动化部署脚本/_PRD_预定系统_MySQL服务监控需求文档.md)
- [_PRD_预定系统_Redis服务监控需求文档.md](../../../Docs/PRD/自动化部署脚本/_PRD_预定系统_Redis服务监控需求文档.md)
- [_PRD_预定系统_已删除文件清理需求文档.md](../../../Docs/PRD/自动化部署脚本/_PRD_预定系统_已删除文件清理需求文档.md)
### C. 快速参考卡片
```
# ========== 快速命令参考 ==========
# 1. 手动执行脚本
/opt/scripts/script_name.sh
# 2. 查看实时日志
tail -f /var/log/scripts/script_name.log
# 3. 检查容器状态
docker ps | grep -E "ujava2|umysql|uredis|uemqx"
# 4. 查看 cron 执行记录
grep CRON /var/log/syslog | tail -20
# 5. 检查备份文件
ls -lh /opt/mysql/$(date +%Y%m%d)/
# 6. 紧急重启所有容器
docker restart ujava2 umysql uredis uemqx
# ===================================
```
---
## 📞 技术支持
如遇到问题，请按以下步骤收集信息：
1. **日志文件**：`/var/log/scripts/*.log`
2. **容器状态**：`docker ps -a`
3. **系统日志**：`/var/log/syslog`（cron 相关）
4. **磁盘空间**：`df -h`
5. **Cron 配置**：`crontab -l`
联系技术支持时请提供以上信息。
---
**文档结束**
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑！
请 注册 或者 后发表评论