config挂载
This commit is contained in:
@@ -1,372 +0,0 @@
|
||||
# Docker环境数据库初始化指南
|
||||
|
||||
## 📋 概述
|
||||
|
||||
本指南说明如何为Docker环境准备数据库初始化脚本，参考 `schoolNewsServ/.bin/mysql/sql/reInit.sh` 的实现。
|
||||
|
||||
## 🎯 初始化流程
|
||||
|
||||
### MySQL容器启动流程
|
||||
|
||||
```
|
||||
Docker容器启动
|
||||
↓
|
||||
执行 /docker-entrypoint-initdb.d/ 中的脚本（按字母顺序）
|
||||
↓
|
||||
01-init-database.sql → 创建数据库和初始化标记表
|
||||
↓
|
||||
02-create-tables.sql → 创建所有业务表
|
||||
↓
|
||||
03-init-data.sql → 导入初始数据
|
||||
↓
|
||||
数据库就绪
|
||||
```
|
||||
|
||||
## 📂 文件说明
|
||||
|
||||
### 现有文件
|
||||
|
||||
| 文件 | 说明 | 状态 |
|
||||
|------|------|------|
|
||||
| `01-init-database.sql` | 创建数据库和_db_init_status表 | ✅ 已存在 |
|
||||
| `README.md` | 数据库初始化说明 | ✅ 已存在 |
|
||||
|
||||
### 需要准备的文件
|
||||
|
||||
| 文件 | 说明 | 来源 |
|
||||
|------|------|------|
|
||||
| `02-create-tables.sql` | 所有表结构 | 从 createTable*.sql 合并 |
|
||||
| `03-init-data.sql` | 初始数据 | 从 init*.sql 合并 |
|
||||
|
||||
## 🔧 准备方法
|
||||
|
||||
### 方式1: 使用自动脚本（推荐）
|
||||
|
||||
```bash
|
||||
cd docker/init-db
|
||||
chmod +x prepare-sql.sh
|
||||
./prepare-sql.sh
|
||||
```
|
||||
|
||||
脚本会自动：
|
||||
1. 备份现有SQL文件
|
||||
2. 合并所有createTable*.sql到02-create-tables.sql
|
||||
3. 合并所有init*.sql到03-init-data.sql
|
||||
4. 添加Docker特定配置（爬虫路径等）
|
||||
5. 生成统计信息
|
||||
|
||||
### 方式2: 手动复制
|
||||
|
||||
#### 步骤1: 准备表结构
|
||||
|
||||
```bash
|
||||
cd schoolNewsServ/.bin/mysql/sql
|
||||
|
||||
# 合并所有createTable*.sql
|
||||
cat createTableUser.sql \
|
||||
createTablePermission.sql \
|
||||
createTablePermissionControl.sql \
|
||||
createTableResource.sql \
|
||||
createTableCourse.sql \
|
||||
createTableLearning.sql \
|
||||
createTableUserCenter.sql \
|
||||
createTableAI.sql \
|
||||
createTableSystem.sql \
|
||||
createTableAchievement.sql \
|
||||
createTableCrontab.sql \
|
||||
createTableMessage.sql \
|
||||
createTableSensitive.sql \
|
||||
> ../../docker/init-db/02-create-tables.sql
|
||||
```
|
||||
|
||||
#### 步骤2: 准备初始数据
|
||||
|
||||
```bash
|
||||
# 合并所有init*.sql
|
||||
cat initMenuData.sql \
|
||||
initAllData.sql \
|
||||
initCrontabMetaData.sql \
|
||||
> ../../docker/init-db/03-init-data.sql
|
||||
```
|
||||
|
||||
#### 步骤3: 添加Docker配置
|
||||
|
||||
在 `03-init-data.sql` 末尾添加：
|
||||
|
||||
```sql
|
||||
-- Docker环境爬虫配置
|
||||
INSERT IGNORE INTO tb_sys_config (config_key, config_value, config_desc, created_at)
|
||||
VALUES
|
||||
('crawler.pythonPath', '/usr/bin/python3', 'Docker容器内Python路径', NOW()),
|
||||
('crawler.basePath', '/app/crawler', 'Docker容器内爬虫脚本路径', NOW());
|
||||
```
|
||||
|
||||
## 🔍 脚本内容说明
|
||||
|
||||
### initAll.sql 结构
|
||||
|
||||
基于 `schoolNewsServ/.bin/mysql/sql/initAll.sql`:
|
||||
|
||||
```sql
|
||||
-- 1. 创建数据库
|
||||
SOURCE createDB.sql;
|
||||
|
||||
-- 2-14. 创建各模块表
|
||||
SOURCE createTableUser.sql;
|
||||
SOURCE createTablePermission.sql;
|
||||
SOURCE createTablePermissionControl.sql;
|
||||
SOURCE createTableResource.sql;
|
||||
SOURCE createTableCourse.sql;
|
||||
SOURCE createTableLearning.sql;
|
||||
SOURCE createTableUserCenter.sql;
|
||||
SOURCE createTableAI.sql;
|
||||
SOURCE createTableSystem.sql;
|
||||
SOURCE createTableAchievement.sql;
|
||||
SOURCE createTableCrontab.sql;
|
||||
SOURCE createTableMessage.sql;
|
||||
SOURCE createTableSensitive.sql;
|
||||
|
||||
-- 15-17. 插入初始数据
|
||||
SOURCE initMenuData.sql;
|
||||
SOURCE initAllData.sql;
|
||||
SOURCE initCrontabMetaData.sql;
|
||||
```
|
||||
|
||||
### 各模块说明
|
||||
|
||||
| 模块 | 表数量 | 说明 |
|
||||
|------|--------|------|
|
||||
| User | 3+ | 用户、部门、角色 |
|
||||
| Permission | 10+ | 菜单、权限、角色权限 |
|
||||
| Resource | 5+ | 资源、标签、分类 |
|
||||
| Course | 3+ | 课程、章节、课件 |
|
||||
| Learning | 5+ | 学习记录、笔记 |
|
||||
| UserCenter | 3+ | 个人中心、收藏、评论 |
|
||||
| AI | 5+ | AI智能体、对话 |
|
||||
| System | 5+ | 系统配置、日志 |
|
||||
| Achievement | 5+ | 成就系统 |
|
||||
| Crontab | 3+ | 定时任务 |
|
||||
| Message | 3+ | 消息通知 |
|
||||
| Sensitive | 1+ | 敏感词 |
|
||||
|
||||
## ⚠️ 重要注意事项
|
||||
|
||||
### 1. SOURCE语句不支持
|
||||
|
||||
Docker的mysql镜像初始化**不支持** `SOURCE` 语句：
|
||||
|
||||
```sql
|
||||
-- ❌ 不支持
|
||||
SOURCE createTableUser.sql;
|
||||
|
||||
-- ✅ 需要合并成一个文件
|
||||
-- 将所有SQL内容直接写入
|
||||
CREATE TABLE tb_user (...);
|
||||
CREATE TABLE tb_role (...);
|
||||
```
|
||||
|
||||
### 2. 幂等性设计
|
||||
|
||||
确保脚本可以重复执行：
|
||||
|
||||
```sql
|
||||
-- 使用IF NOT EXISTS
|
||||
CREATE TABLE IF NOT EXISTS tb_user (...);
|
||||
|
||||
-- 使用INSERT IGNORE
|
||||
INSERT IGNORE INTO tb_sys_config VALUES (...);
|
||||
|
||||
-- 检查执行状态
|
||||
SET @executed = (SELECT COUNT(*) FROM _db_init_status WHERE script_name = '02-create-tables.sql');
|
||||
```
|
||||
|
||||
### 3. 执行顺序
|
||||
|
||||
文件按字母顺序执行，因此命名很重要：
|
||||
|
||||
```
|
||||
01-init-database.sql (首先执行)
|
||||
02-create-tables.sql (其次执行)
|
||||
03-init-data.sql (最后执行)
|
||||
```
|
||||
|
||||
### 4. 字符集配置
|
||||
|
||||
确保使用UTF-8MB4：
|
||||
|
||||
```sql
|
||||
CREATE TABLE tb_xxx (
|
||||
...
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
|
||||
```
|
||||
|
||||
## 🧪 测试验证
|
||||
|
||||
### 1. 检查SQL文件
|
||||
|
||||
```bash
|
||||
# 查看文件大小
|
||||
ls -lh docker/init-db/*.sql
|
||||
|
||||
# 检查SQL语法
|
||||
cd docker/init-db
|
||||
mysql --help | grep "Default options"
|
||||
```
|
||||
|
||||
### 2. 本地测试
|
||||
|
||||
```bash
|
||||
# 在本地MySQL测试
|
||||
mysql -uroot -p123456 < docker/init-db/01-init-database.sql
|
||||
mysql -uroot -p123456 < docker/init-db/02-create-tables.sql
|
||||
mysql -uroot -p123456 < docker/init-db/03-init-data.sql
|
||||
```
|
||||
|
||||
### 3. Docker环境测试
|
||||
|
||||
```bash
|
||||
# 删除旧数据
|
||||
docker-compose down -v
|
||||
|
||||
# 启动MySQL
|
||||
docker-compose up -d mysql
|
||||
|
||||
# 查看初始化日志
|
||||
docker logs school-news-mysql 2>&1 | grep -E "init|sql"
|
||||
|
||||
# 检查数据库
|
||||
docker exec school-news-mysql mysql -uroot -p123456 -e "SHOW DATABASES;"
|
||||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e "SHOW TABLES;"
|
||||
|
||||
# 检查默认用户
|
||||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||||
"SELECT username, nickname FROM tb_sys_user WHERE username='admin';"
|
||||
```
|
||||
|
||||
### 4. 验证初始化状态
|
||||
|
||||
```bash
|
||||
# 查看初始化记录
|
||||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||||
"SELECT * FROM _db_init_status ORDER BY executed_at;"
|
||||
|
||||
# 统计表数量
|
||||
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';"
|
||||
```
|
||||
|
||||
## 🔄 更新数据库结构
|
||||
|
||||
### 场景1: 本地开发添加了新表
|
||||
|
||||
1. 在 `schoolNewsServ/.bin/mysql/sql/` 中创建SQL文件
|
||||
2. 更新 `initAll.sql` 添加SOURCE语句
|
||||
3. 重新运行 `prepare-sql.sh`
|
||||
4. 重新构建Docker镜像
|
||||
|
||||
### 场景2: 修改现有表结构
|
||||
|
||||
1. 创建迁移脚本 `04-migration-xxx.sql`
|
||||
2. 放入 `docker/init-db/` 目录
|
||||
3. 脚本会自动执行（按字母顺序）
|
||||
|
||||
示例迁移脚本：
|
||||
|
||||
```sql
|
||||
-- 04-migration-add-column.sql
|
||||
USE school_news;
|
||||
|
||||
-- 检查是否已执行
|
||||
SET @executed = (SELECT COUNT(*) FROM _db_init_status WHERE script_name = '04-migration-add-column.sql');
|
||||
|
||||
-- 添加新列
|
||||
ALTER TABLE tb_user ADD COLUMN IF NOT EXISTS new_column VARCHAR(255);
|
||||
|
||||
-- 记录执行
|
||||
INSERT IGNORE INTO _db_init_status (script_name) VALUES ('04-migration-add-column.sql');
|
||||
```
|
||||
|
||||
## 📊 默认数据说明
|
||||
|
||||
### 默认用户
|
||||
|
||||
| 用户名 | 密码 | 角色 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| admin | admin123 | 管理员 | 超级管理员账号 |
|
||||
|
||||
### 默认角色
|
||||
|
||||
| 角色 | 说明 |
|
||||
|------|------|
|
||||
| admin | 管理员，拥有所有权限 |
|
||||
| freedom | 自由角色，基础权限 |
|
||||
|
||||
### 默认部门
|
||||
|
||||
| 部门 | 说明 |
|
||||
|------|------|
|
||||
| root_department | 超级部门 |
|
||||
| default_department | 默认部门 |
|
||||
|
||||
### 系统配置
|
||||
|
||||
| 配置项 | 值 | 说明 |
|
||||
|--------|-----|------|
|
||||
| crawler.pythonPath | /usr/bin/python3 | Python路径 |
|
||||
| crawler.basePath | /app/crawler | 爬虫脚本路径 |
|
||||
|
||||
## 🛠️ 故障排查
|
||||
|
||||
### 问题1: 初始化脚本未执行
|
||||
|
||||
**症状**: 数据库创建了但表不存在
|
||||
|
||||
**排查**:
|
||||
```bash
|
||||
# 查看MySQL日志
|
||||
docker logs school-news-mysql
|
||||
|
||||
# 检查脚本权限
|
||||
ls -l docker/init-db/*.sql
|
||||
```
|
||||
|
||||
**解决**: 确保SQL文件有读权限
|
||||
|
||||
### 问题2: SQL语法错误
|
||||
|
||||
**症状**: 容器启动失败
|
||||
|
||||
**排查**:
|
||||
```bash
|
||||
# 查看详细错误
|
||||
docker logs school-news-mysql 2>&1 | grep ERROR
|
||||
```
|
||||
|
||||
**解决**: 检查SQL语法，在本地测试
|
||||
|
||||
### 问题3: 重复执行导致错误
|
||||
|
||||
**症状**: 主键冲突等错误
|
||||
|
||||
**解决**: 使用幂等设计
|
||||
```sql
|
||||
-- 使用INSERT IGNORE
|
||||
INSERT IGNORE INTO ...
|
||||
|
||||
-- 使用ON DUPLICATE KEY UPDATE
|
||||
INSERT INTO ... ON DUPLICATE KEY UPDATE ...
|
||||
|
||||
-- 检查执行状态
|
||||
IF NOT EXISTS (SELECT ...)
|
||||
```
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- [数据库初始化README](README.md)
|
||||
- [reInit.sh源文件](../../schoolNewsServ/.bin/mysql/sql/reInit.sh)
|
||||
- [MySQL Docker文档](https://hub.docker.com/_/mysql)
|
||||
|
||||
---
|
||||
|
||||
**更新时间**: 2025-11-24
|
||||
**基于**: schoolNewsServ/.bin/mysql/sql/reInit.sh
|
||||
Reference in New Issue
Block a user