168 lines
3.6 KiB
Markdown
168 lines
3.6 KiB
Markdown
# 基于角色的系统 - Docker部署指南
|
||
|
||
## 项目概述
|
||
这是一个基于Django的基于角色的系统，使用MySQL数据库和Redis进行WebSocket通信。
|
||
|
||
## Docker部署步骤
|
||
|
||
### 前置要求
|
||
- 安装 [Docker](https://docs.docker.com/get-docker/)
|
||
- 安装 [Docker Compose](https://docs.docker.com/compose/install/)
|
||
|
||
### 部署步骤
|
||
|
||
1. **配置Docker镜像源**（解决网络问题）
|
||
|
||
编辑Docker Desktop设置，添加国内镜像源：
|
||
```json
|
||
{
|
||
"registry-mirrors": [
|
||
"https://hub-mirror.c.163.com",
|
||
"https://docker.mirrors.ustc.edu.cn",
|
||
"https://registry.docker-cn.com",
|
||
"https://reg-mirror.qiniu.com"
|
||
]
|
||
}
|
||
```
|
||
|
||
应用设置并重启Docker Desktop。
|
||
|
||
2. **准备环境变量**
|
||
|
||
复制示例环境变量文件并根据需要修改：
|
||
```bash
|
||
cp .env.example .env
|
||
```
|
||
|
||
3. **构建镜像**
|
||
|
||
```bash
|
||
docker-compose build
|
||
```
|
||
|
||
如果遇到网络问题，尝试预先拉取基础镜像：
|
||
```bash
|
||
docker pull python:3.11-slim
|
||
```
|
||
|
||
4. **启动容器**
|
||
|
||
```bash
|
||
docker-compose up -d
|
||
```
|
||
|
||
如果MySQL端口冲突（通常是本地已有MySQL服务），修改`docker-compose.yml`中的端口映射：
|
||
```yaml
|
||
ports:
|
||
- "3307:3306" # 使用3307替代3306
|
||
```
|
||
|
||
5. **执行数据库迁移**
|
||
|
||
```bash
|
||
docker-compose exec web python manage.py migrate
|
||
```
|
||
|
||
6. **创建测试用户**
|
||
|
||
```bash
|
||
docker-compose exec web python manage.py create_test_users
|
||
```
|
||
|
||
这将创建以下用户：
|
||
- 4个管理员用户（admin1-admin4，密码：admin123）
|
||
- 7个组长用户（leader1-leader7，密码：leader123）
|
||
|
||
执行后会显示每个用户的Token，可用于API认证。
|
||
|
||
7. **创建超级用户（可选）**
|
||
|
||
```bash
|
||
docker-compose exec web python manage.py createsuperuser
|
||
```
|
||
|
||
8. **查看日志（如需调试）**
|
||
|
||
```bash
|
||
docker-compose logs -f
|
||
```
|
||
|
||
查看特定服务日志：
|
||
```bash
|
||
docker-compose logs web # 查看web应用日志
|
||
docker-compose logs db # 查看数据库日志
|
||
```
|
||
|
||
### 访问应用
|
||
|
||
应用将在以下地址运行：`http://localhost:8000`
|
||
|
||
### 容器管理命令
|
||
|
||
```bash
|
||
# 查看容器状态
|
||
docker-compose ps
|
||
|
||
# 停止服务
|
||
docker-compose down
|
||
|
||
# 重新启动服务
|
||
docker-compose up -d
|
||
|
||
# 重建镜像并启动
|
||
docker-compose up -d --build
|
||
|
||
# 完全重置（包括数据卷）
|
||
docker-compose down -v
|
||
```
|
||
|
||
## 数据库访问
|
||
|
||
### 本地访问MySQL
|
||
- 主机: localhost
|
||
- 端口: 3307（如果修改了端口映射）
|
||
- 用户名: root
|
||
- 密码: Ooin2025!
|
||
- 数据库名: rolebasedfilemanagement
|
||
|
||
### 从容器内连接
|
||
```bash
|
||
docker-compose exec db mysql -u root -p rolebasedfilemanagement
|
||
```
|
||
|
||
## 数据备份与恢复
|
||
|
||
### 备份数据库
|
||
|
||
```bash
|
||
docker-compose exec db mysqldump -u root -p rolebasedfilemanagement > backup.sql
|
||
```
|
||
|
||
### 恢复数据库
|
||
|
||
```bash
|
||
docker-compose exec -T db mysql -u root -p rolebasedfilemanagement < backup.sql
|
||
```
|
||
|
||
## 故障排除
|
||
|
||
### 依赖问题
|
||
如果遇到缺少依赖项的错误，编辑`requirements.txt`添加缺失的包，然后重新构建：
|
||
```bash
|
||
docker-compose down
|
||
docker-compose build
|
||
docker-compose up -d
|
||
```
|
||
|
||
### 端口冲突
|
||
如果遇到端口冲突，修改`docker-compose.yml`中的端口映射，将冲突的端口修改为未使用的端口。
|
||
|
||
### 网络问题
|
||
如果无法下载Docker镜像，配置国内镜像源，或使用VPN解决网络连接问题。
|
||
|
||
## 注意事项
|
||
|
||
- 在生产环境中，请确保修改默认密码和密钥
|
||
- 生产环境应启用HTTPS
|
||
- 定期备份数据库和媒体文件
|
||
- 对于生产部署，建议配置Nginx作为反向代理 |