镜像制作
This commit is contained in:
334
docker/init-db/README.md
Normal file
334
docker/init-db/README.md
Normal file
@@ -0,0 +1,334 @@
|
||||
# 数据库初始化脚本说明
|
||||
|
||||
## 📋 概述
|
||||
|
||||
本目录包含数据库初始化脚本，用于Docker容器首次启动时自动初始化数据库。
|
||||
|
||||
**基于**: `schoolNewsServ/.bin/mysql/sql/reInit.sh` 的实现逻辑
|
||||
|
||||
## 📂 脚本文件
|
||||
|
||||
| 文件 | 说明 | 状态 |
|
||||
|------|------|------|
|
||||
| `01-init-database.sql` | 创建数据库和初始化标记表 | ✅ 已就绪 |
|
||||
| `02-create-tables.sql` | 创建所有业务表（50+张） | ⚠️ 需准备 |
|
||||
| `03-init-data.sql` | 导入初始数据（用户、菜单等） | ⚠️ 需准备 |
|
||||
| `prepare-sql.sh` | 自动准备脚本 | ✅ 已就绪 |
|
||||
| `数据库初始化指南.md` | 详细说明文档 | ✅ 已就绪 |
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 方式1: 使用自动脚本（推荐）
|
||||
|
||||
```bash
|
||||
cd docker/init-db
|
||||
chmod +x prepare-sql.sh
|
||||
./prepare-sql.sh
|
||||
```
|
||||
|
||||
脚本会自动：
|
||||
1. ✅ 从 `schoolNewsServ/.bin/mysql/sql/` 读取所有SQL文件
|
||||
2. ✅ 合并所有 `createTable*.sql` 到 `02-create-tables.sql`
|
||||
3. ✅ 合并所有 `init*.sql` 到 `03-init-data.sql`
|
||||
4. ✅ 添加Docker环境特定配置（爬虫路径等）
|
||||
5. ✅ 生成统计信息
|
||||
|
||||
### 方式2: 手动准备
|
||||
|
||||
参见 [数据库初始化指南.md](数据库初始化指南.md)
|
||||
|
||||
## 📊 脚本执行顺序
|
||||
|
||||
MySQL容器会按照文件名的字母顺序自动执行此目录下的`.sql`文件：
|
||||
|
||||
```
|
||||
容器启动
|
||||
↓
|
||||
01-init-database.sql
|
||||
├─ 创建数据库 school_news
|
||||
└─ 创建初始化标记表 _db_init_status
|
||||
↓
|
||||
02-create-tables.sql
|
||||
├─ 创建用户模块表（3+张）
|
||||
├─ 创建权限模块表（10+张）
|
||||
├─ 创建资源模块表（5+张）
|
||||
├─ 创建学习模块表（8+张）
|
||||
├─ 创建AI模块表（5+张）
|
||||
├─ 创建系统模块表（5+张）
|
||||
├─ 创建成就模块表（5+张）
|
||||
├─ 创建定时任务模块表（3+张）
|
||||
├─ 创建消息模块表（3+张）
|
||||
└─ 创建敏感词模块表（1+张）
|
||||
↓
|
||||
03-init-data.sql
|
||||
├─ 导入菜单和权限数据
|
||||
├─ 导入默认用户和角色
|
||||
├─ 导入系统配置
|
||||
└─ 导入Docker环境配置（爬虫路径）
|
||||
↓
|
||||
数据库就绪 ✓
|
||||
```
|
||||
|
||||
## 🎯 初始化特性
|
||||
|
||||
### 幂等性设计
|
||||
|
||||
所有脚本支持重复执行，不会导致错误：
|
||||
|
||||
```sql
|
||||
-- 表创建使用IF NOT EXISTS
|
||||
CREATE TABLE IF NOT EXISTS tb_user (...);
|
||||
|
||||
-- 数据插入使用INSERT IGNORE
|
||||
INSERT IGNORE INTO tb_sys_config VALUES (...);
|
||||
|
||||
-- 使用_db_init_status表跟踪执行状态
|
||||
INSERT IGNORE INTO _db_init_status (script_name) VALUES ('02-create-tables.sql');
|
||||
```
|
||||
|
||||
### 避免重复初始化
|
||||
|
||||
系统使用 `_db_init_status` 表来跟踪已执行的脚本：
|
||||
|
||||
```bash
|
||||
# 查看已执行的脚本
|
||||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||||
"SELECT * FROM _db_init_status ORDER BY executed_at;"
|
||||
```
|
||||
|
||||
## 🗄️ 数据库结构
|
||||
|
||||
### 模块组成
|
||||
|
||||
| 模块 | 表数量 | 说明 |
|
||||
|------|--------|------|
|
||||
| 用户管理 | 3+ | 用户、部门、角色 |
|
||||
| 权限管理 | 10+ | 菜单、权限、角色权限映射 |
|
||||
| 资源管理 | 5+ | 资源、标签、分类、评论 |
|
||||
| 课程管理 | 3+ | 课程、章节、课件 |
|
||||
| 学习管理 | 5+ | 学习记录、笔记、错题 |
|
||||
| 个人中心 | 3+ | 收藏、历史、个人信息 |
|
||||
| AI智能体 | 5+ | AI对话、知识库 |
|
||||
| 系统配置 | 5+ | 配置、日志、文件管理 |
|
||||
| 成就系统 | 5+ | 成就、徽章、等级 |
|
||||
| 定时任务 | 3+ | 任务、执行记录、元数据 |
|
||||
| 消息通知 | 3+ | 消息、通知、模板 |
|
||||
| 敏感词 | 1+ | 敏感词过滤 |
|
||||
|
||||
**总计**: 50+ 张表
|
||||
|
||||
### 默认数据
|
||||
|
||||
#### 默认用户
|
||||
- **用户名**: admin
|
||||
- **密码**: admin123
|
||||
- **角色**: 管理员（拥有所有权限）
|
||||
|
||||
#### 系统配置
|
||||
- `crawler.pythonPath`: /usr/bin/python3
|
||||
- `crawler.basePath`: /app/crawler
|
||||
|
||||
## 🔄 重新初始化
|
||||
|
||||
### 完全重新初始化（会删除所有数据）
|
||||
|
||||
```bash
|
||||
# 停止并删除容器和数据卷
|
||||
cd docker
|
||||
docker-compose down -v
|
||||
|
||||
# 重新启动
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
### 只重置初始化标记
|
||||
|
||||
```bash
|
||||
# 清空标记表，下次重启时重新执行脚本
|
||||
docker exec school-news-mysql mysql -uroot -p123456 -e \
|
||||
"TRUNCATE TABLE school_news._db_init_status;"
|
||||
|
||||
# 重启MySQL容器
|
||||
docker-compose restart mysql
|
||||
```
|
||||
|
||||
## 🧪 验证初始化
|
||||
|
||||
### 1. 查看初始化日志
|
||||
|
||||
```bash
|
||||
docker logs school-news-mysql 2>&1 | grep -i "init\|sql"
|
||||
```
|
||||
|
||||
### 2. 检查数据库和表
|
||||
|
||||
```bash
|
||||
# 检查数据库
|
||||
docker exec school-news-mysql mysql -uroot -p123456 -e "SHOW DATABASES;"
|
||||
|
||||
# 检查表数量
|
||||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||||
"SELECT COUNT(*) AS table_count FROM information_schema.tables WHERE table_schema='school_news';"
|
||||
|
||||
# 查看所有表
|
||||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e "SHOW TABLES;"
|
||||
```
|
||||
|
||||
### 3. 验证默认数据
|
||||
|
||||
```bash
|
||||
# 检查默认用户
|
||||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||||
"SELECT username, nickname, status FROM tb_sys_user WHERE username='admin';"
|
||||
|
||||
# 检查系统配置
|
||||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||||
"SELECT config_key, config_value FROM tb_sys_config WHERE config_key LIKE 'crawler.%';"
|
||||
|
||||
# 检查菜单数量
|
||||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||||
"SELECT COUNT(*) AS menu_count FROM tb_sys_menu;"
|
||||
```
|
||||
|
||||
### 4. 检查初始化状态
|
||||
|
||||
```bash
|
||||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||||
"SELECT script_name, executed_at, status FROM _db_init_status ORDER BY executed_at;"
|
||||
```
|
||||
|
||||
## ⚠️ 注意事项
|
||||
|
||||
### 1. SOURCE语句不支持
|
||||
|
||||
Docker的mysql镜像**不支持** `SOURCE` 语句，需要将所有SQL合并到一个文件：
|
||||
|
||||
```sql
|
||||
-- ❌ 不支持
|
||||
SOURCE createTableUser.sql;
|
||||
|
||||
-- ✅ 需要合并
|
||||
-- 将createTableUser.sql的内容直接复制过来
|
||||
CREATE TABLE tb_user (...);
|
||||
```
|
||||
|
||||
### 2. 文件执行顺序
|
||||
|
||||
文件按字母顺序执行，命名规范：
|
||||
|
||||
```
|
||||
01-xxx.sql (最先执行)
|
||||
02-xxx.sql (其次执行)
|
||||
03-xxx.sql (最后执行)
|
||||
04-xxx.sql (可选：迁移脚本)
|
||||
```
|
||||
|
||||
### 3. 字符集配置
|
||||
|
||||
确保使用UTF8MB4字符集：
|
||||
|
||||
```sql
|
||||
CREATE TABLE tb_xxx (
|
||||
...
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
|
||||
```
|
||||
|
||||
### 4. 安全性
|
||||
|
||||
生产环境必须：
|
||||
- ✅ 修改默认密码
|
||||
- ✅ 使用强密码策略
|
||||
- ✅ 限制数据库访问权限
|
||||
- ✅ 定期备份数据
|
||||
|
||||
## 🗂️ 数据持久化
|
||||
|
||||
数据库数据持久化在Docker数据卷中：
|
||||
|
||||
```yaml
|
||||
volumes:
|
||||
mysql-data:
|
||||
driver: local
|
||||
```
|
||||
|
||||
### 查看和管理数据卷
|
||||
|
||||
```bash
|
||||
# 查看所有数据卷
|
||||
docker volume ls
|
||||
|
||||
# 查看数据卷详情
|
||||
docker volume inspect docker_mysql-data
|
||||
|
||||
# 备份数据卷
|
||||
docker run --rm -v docker_mysql-data:/data -v $(pwd):/backup \
|
||||
alpine tar czf /backup/mysql-backup.tar.gz /data
|
||||
|
||||
# 恢复数据卷
|
||||
docker run --rm -v docker_mysql-data:/data -v $(pwd):/backup \
|
||||
alpine tar xzf /backup/mysql-backup.tar.gz -C /
|
||||
```
|
||||
|
||||
## 🐛 故障排查
|
||||
|
||||
### 问题1: 脚本未执行
|
||||
|
||||
**症状**: 数据库创建了但没有表
|
||||
|
||||
**排查**:
|
||||
```bash
|
||||
# 查看MySQL日志
|
||||
docker logs school-news-mysql
|
||||
|
||||
# 检查SQL文件
|
||||
ls -l docker/init-db/*.sql
|
||||
```
|
||||
|
||||
**解决**:
|
||||
- 确保SQL文件有读权限
|
||||
- 检查SQL语法是否正确
|
||||
|
||||
### 问题2: 初始化失败
|
||||
|
||||
**症状**: 容器启动失败或反复重启
|
||||
|
||||
**排查**:
|
||||
```bash
|
||||
# 查看错误日志
|
||||
docker logs school-news-mysql 2>&1 | grep -i error
|
||||
|
||||
# 进入容器检查
|
||||
docker exec -it school-news-mysql bash
|
||||
```
|
||||
|
||||
**解决**:
|
||||
- 检查SQL语法错误
|
||||
- 确保表之间的依赖关系正确
|
||||
- 验证数据格式是否正确
|
||||
|
||||
### 问题3: 重复执行导致错误
|
||||
|
||||
**解决**: 使用幂等性设计
|
||||
- 使用 `CREATE TABLE IF NOT EXISTS`
|
||||
- 使用 `INSERT IGNORE`
|
||||
- 使用 `_db_init_status` 表跟踪
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- [数据库初始化指南](数据库初始化指南.md) - 详细的准备和使用说明
|
||||
- [reInit.sh](../../schoolNewsServ/.bin/mysql/sql/reInit.sh) - 原始初始化脚本
|
||||
- [Docker README](../README.md) - Docker部署文档
|
||||
|
||||
## 💡 最佳实践
|
||||
|
||||
1. ✅ **自动化** - 使用 `prepare-sql.sh` 自动准备SQL文件
|
||||
2. ✅ **幂等性** - 确保脚本可以重复执行
|
||||
3. ✅ **版本控制** - SQL文件纳入Git管理（注意敏感信息）
|
||||
4. ✅ **文档同步** - 表结构变更同步更新SQL文件
|
||||
5. ✅ **定期备份** - 重要数据定期备份
|
||||
6. ✅ **测试验证** - 在测试环境充分验证后再部署生产
|
||||
|
||||
---
|
||||
|
||||
**更新时间**: 2025-11-24
|
||||
**基于**: schoolNewsServ/.bin/mysql/sql/reInit.sh v1.1.0
|
||||
Reference in New Issue
Block a user