AlliotTech / drf-template

Django REST Framework项目初始化模板

项目概述

本项目为DRF初始化模板，具体实现了以下功能

• 完整的序列化器、视图、路由示例。
• 集成Apscheduler定时任务模块与接口
• 实现开发生产环境区分，密钥与代码拆分。
• 开发模式使用sqlite(或MySQL，按需修改envs目录对应文件配置)。生产模式使用mysql+redis。
• 使用docker实现自动打包与发布。

接口文档

• 部署后查看：

  接口文档

• 文件查看：

  接口文档

• 在线查看

  链接: https://www.apifox.cn/apidoc/shared-34bb4a27-bf7b-432d-9d51-0a767a259e6e

  访问密码 : 4UoQc75S

开发模式运行项目

uvicorn方式

• 命令行启动

# 安装pip库依赖
pip install -r requirements.txt
# 运行Django项目
uvicorn DRF.asgi:application --reload
# 运行定时任务
python manage.py crontab

• pycharm开发模式

manager.py方式

• 命令行启动

# 安装pip库依赖
pip install -r requirements.txt
# 运行Django项目
uvicorn python manage.py runserver 0.0.0.0:8000
# 运行定时任务
python manage.py crontab

生产模式运行项目

MySQL部署

[root@aliyun opt]# mkdir -p /opt/docker/mysql
[root@aliyun opt]# cd /opt/docker/mysql/
[root@aliyun mysql]# docker run --name mysql -p 3306:3306 -v $PWD/conf:/etc/mysql/conf.d -v $PWD/logs:/logs -v $PWD/data:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=123.com -d --restart=always mysql

# 创建数据库
mysql> CREATE DATABASE drf DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
Query OK, 1 row affected, 2 warnings (0.01 sec)

mysql> show databases;

redis部署(可选)

如果使用redis缓存，envs/.env.prod配置如下 #CACHE_URL=rediscache://redis:6379/0?client_class=django_redis.client.DefaultClient&password=123.com

[root@aliyun docker]# docker run --name redis -p 6379:6379 -d --restart=always redis --requirepass 123.com
fe24cb38242ed2f1c8c7340fa1ce05f39c8fc351a7a96506c43dff41ca0774bb
[root@aliyun docker]# docker exec -it redis redis-cli
127.0.0.1:6379> auth CuiLiang@0302
OK

后端API部署

docker build -t drf:v1 . 
docker run --name drf -d -p 8888:8888 --restart always --link mysql --link redis drf:v1

nginx配置

server {
    server_name  ~^.*$;
    location / {
        proxy_pass http://drf:8000;
        proxy_set_header Host $host;
	    proxy_set_header X-Real-IP $remote_addr;
	    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

nginx部署

docker run --name nginx -d -p 80:80 -v $PWD/nginx.conf:/etc/nginx/conf.d/drf.conf --restart always --link drf nginx

注意事项

执行数据库迁移

docker exec -it drf bash
python manage.py makemigrations
python manage.py migrate

收集admin静态资源文件（生产模式执行）

docker exec -it drf bash
python manage.py collectstatic

默认用户名/密码

用户名admin 密码123.com