django入门进阶10部署上线(nginx,uwsgi,supervisor)

完善的django项目上线,有很多种上线的方法,比如apache, uwsgi, nginx等。这里只介绍2种,一种是django自带的,另外一种则是nginx + uwsgi完成介绍。

django服务

python manage.py runserver,验证可正常访问

uwsgi安装和服务验证

安装:pip Install uwsgi
测试代码

1
2
3
4
5
def application(env, start_response):  
start_response('200 OK', [('Content-Type','text/html')])
return [b"Hello World"]
```
执行下面命令行:

uwsgi –plugin python –http :8001 –wsgi-file test.py

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
重新访问 localhost:8001  
就可以看到 成功的显示了 'Hello world'

如果报错:error while loading shared libraries: libpcre.so.1: cannot open shared object file: No such file or directory
解决方式:
```
sudo apt-get install libpcre3 libpcre3-dev # 安装需要的包
find / -name libpcre.so.3 # 找到libpcre.so.3(一般在根目录/lib/x86_64-linux-gnu下)
找到 /lib/x86_64-linux-gnu/libpcre.so.3
sudo ln -s /lib/x86_64-linux-gnu/libpcre.so.3 /usr/lib/libpcre.so.1 # 做软链接即可
```

## uwsgi对接django配置ini
```
[uwsgi]
#使用nginx连接时使用
#socket=127.0.0.1:8080 #正式上线后使用此模式,速度稍有优势
#直接做web服务器使用
http=127.0.0.1:8080 #联调阶段优先使用http模式,方便定点测试
#项目目录
chdir=/home/shuan/dailiyfresh #这里可能需要多次尝试,如果报错can't find module **,大概率这里问题
#项目中wsgi.py文件的目录,相对于项目目录
wsgi-file=dailiyfresh/wsgi.py #这里尽可能使用绝对路径避免踩坑
# 指定启动的工作进程数
processes=4
# 指定工作进程中的线程数
threads=2
master=True
# 保存启动之后主进程的pid
pidfile=uwsgi.pid
# 设置uwsgi后台运行,用uwsgi.log保存日志信息
daemonize=uwsgi.log
# 设置虚拟环境的路径
virtualenv=/home/shuan/.virtualenvs/bj18_py3# conda 环境路径
```

启动:uwsgi --ini uwsgi.ini
停止:uwsgi --stop uwsgi.pid

启动后访问8080查看是否启动成功。

## uwsgi对接supervisor
安装supervisor:pip install supervisor
生成初始配置文件:echo_supervisord_conf > /etc/supervisord.conf
```
[program:zqxt]
command=/usr/bin/uwsgi(视环境情况 which uwsgi,本例用pip安装应该是conda环境里的uwsgi地址) --ini uwsgi_conf.ini #可终端单独执行此命令,确保正确
directory=/path/to/zqxt#同uwsgi_conf的chdir,项目目录
startsecs=0
stopwaitsecs=0
autostart=true #测试阶段改为false,让错误暴露出来
autorestart=true #测试阶段改为false,让错误暴露出来
```

修改:supervisor_conf

redirect_stderr = true ; 把 stderr 重定向到 stdout,默认 false
stdout_logfile_maxbytes = 20MB ; stdout 日志文件大小,默认 50MB
stdout_logfile = /data/log/plantool_stdout.log
stderr_logfile = /data/log/plantool_err.log

1
2

修改wsgi_conf.ini

#daemonize=/var/log/uwsgi8011.log # 守护进程一定要注释掉(关键)

1
2

功能测试

启用config配置:supervisord -c /etc/supervisord.conf
supervisorctl status //查看所有进程的状态
supervisorctl stop es //停止es
supervisorctl start es //启动es
supervisorctl restart es //重启es
supervisorctl update //配置文件修改后使用该命令加载新的配置
supervisorctl reload //重新启动配置中的所有程序

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
启动只是启动conf配置,需要supervisorctl start 才是真正启动(也就是说,使用supervisorctl前必须先执行supervisord)  

下面这一段描述问题在于supervisord当做开启服务的了,其实不是,supervisord之后使用supervisorctl才是真正开启服务.

再次启动,查看 supervisorctl status,状态为退出(exited),可见出了问题,查看错误日志plantool_err.log
![](/images/20200617222414858_704663041.jpg)
thunder lock:search ,没有效信息,所以这个可能是正常状态的日志。
猜--socket导致问题,搜索也没发现有效信息,可能也是对的。

## nginx对接uwsgi
先确保nginx安装成功
nginx安装后:http://localhost,如果显示nginx欢迎页,说明nginx默认配置ok

修改nginx配置(大概意思)
```
server {
listen 80 ;
charset utf-8;

client_max_body_size 75M;

location /api { # 后台api接口
proxy_pass 127.0.0.1:8080;
}
location /media {
alias /path/to/project/media;
}

location /static {
alias /path/to/project/static;
}

location / { # html资源文件
root /path/to/template;
index index.html;
}
}
```
先测试后端接口:127.0.0.1:8080/api/,ok
再测试转发接口:127.0.0.1:80/api/,是否正确转发.
最后再测试html,静态文件(static),媒体文件(media)等.

可能问题:报错nginx: [emerg] getgrnam("nginx") failed:https://blog.csdn.net/qq_39556759/article/details/78406813
解决方法:
vim /aplication/nginx/conf/nginx.conf
去掉user nobody之前的#号(也就是说启用user 的配置项)

可能问题:访问Html,css,js资源文件,报错,13: Permission denied
前端,templates/index.html,无权限
![](/images/20200617223550501_1586767656.jpg)

权限不足的解决方案:
一、由于启动用户和nginx工作用户不一致所致(user配置项配置错误)
01,查看nginx的启动用户,发现是nobody,而非root启动的
命令:ps aux | grep "nginx: worker process" | awk'{print $1}'
![](/images/20200617223616418_598504767.jpg)
02,将nginx.config的user改为和启动用户一致,
命令:vi conf/nginx.conf
![](/images/20200617223645514_2144286197.jpg)

这一步,根据个人经验,**应该修改为"/html/or/templates/目录拥有者的用户"和组信息**,比如
当前为用户john(/templates/拥有者,负责启动nginx的人,是否有root权限无所谓),则通过"id john"查看所属组,比如 work组
则配置:"user john work",**效果是启动后的nginx子进程显示的启动者是john**(而实际nginx启动者可能是别人,有root权限的其他人)
这一步可能需要多做尝试,本人这一步卡了好久,尝试了很多组合,最后才发现正确配置(主要是网上教程差异很大,拜版本不同所赐,踩坑颇多)

user www-data #nginx -t 测试通过,启动后访问权限不足
user nobody # nginx -t 测试不通过,
user john # nginx -t 测试不通过,(john无root权限,无法启动nginx,但是templates目录拥有者)
user yyyy # nginx -t 测试不通过,(yyyy有root权限,且是nginx服务启动者)
删除:user 这一行 # nginx -t 测试通过,启动后访问权限不足

user work john # nginx -t 测试不通过,
user work yyyy # nginx -t 测试不通过,
user john work # nginx -t 测试通过,启动后访问ok

1
2
3
4


二、templates权限问题,**如果nginx没有web目录的操作权限,也会出现403错误**。
解决办法:修改web目录的读写权限,或者是把nginx的启动用户改成目录的所属用户,重启Nginx即可解决

chmod -R 777 /data
chmod -R 777 /data/www/

1
2
3
4
5
6
7
8
9
10
11
12
13

## 验证无问题后的进一步改进

01,nginx的转发(到uwsgi),从http转发模式改为socket转发模式(nginx.conf,uwsgi.conf)(对接阶段使用http,方便独立的正确性验证。正式环境改为socket模式,保证速度以及减少端口占用。)
02,supervisord.conf配置的autostart和autorestart改为true。确保进程死机后自动重启。
03,检查各路径配置,是否有私有路径(别人无法访问的路径),可能导致别人无法启动项目。

## 其他注意事项
### 启用django后台管理admin模块
启用admin后会发现无法进入登录界面(部分资源无法加载static/admin/simple-ui/xxxx)
原因:问题admin/下的静态资源无法访问。
大部分项目前后端完全分离,所以templates和static一般都是前端组提供,我们想当然就用了,而实际上django_admin模块内部也包含部分静态资源,当使用django内置服务器时可以检索到,但如果部署到线上则必须将admin内静态文件导出,整合到统一的templates目录中(让nginx检索到)。
解决:

python manage collectstatic # 自动收集静态文件到django_setting配置的STATIC_ROOT中
cp STATIC_ROOT templates/static
chmod -R 777 xxx

```

uswgi安装失败

pip install uswgi 失败
报如下错误:lto1: fatal error: bytecode stream generated with LTO version 6.0 instead of the expected 4.1
原因:这是由于gcc版本不一致导致的,网上看到很多解决办法都是改变gcc版本,但改变gcc版本会影响到其他的程序。
解决:可以用conda的方式安装uwsgi,conda install -c conda-forge uwsgi

libiconv.so 动态库找不到的问题
解决:conda install -c conda-forge libiconv

参考

linux下部署Django uwsgi: error while loading shared libraries: libpcre.so.1: cannot open shared object file: No such file or directory:https://www.cnblogs.com/erhangboke/p/11673156.html
初次使用uwsgi:no python application found, check your startup logs for errors:https://www.cnblogs.com/loveyangaddddd/p/8119720.html
uWSGI出现错误:no python application found, check your startup logs for errors:https://blog.csdn.net/weixin_40576010/article/details/89000128
supervisor管理uwsgi:https://www.cnblogs.com/supery007/p/9368242.html
Django 部署(Nginx):https://code.ziqiangxuetang.com/django/django-nginx-deploy.html
使用supervisor作为uWSGI的守护进程:luchanghong.lofter.com/post/f04c0_242345
Supervisor使用详解:https://www.jianshu.com/p/0b9054b33db3
解决Nginx出现403 forbidden (13: Permission denied)报错的四种方法:https://www.cnblogs.com/williamjie/p/9604594.html
nginx 错误集锦:https://www.jianshu.com/p/3de849802a89
Nginx之proxy_pass指令url反斜杠作用:https://blog.csdn.net/sleepIII/article/details/100787652
uwsgi + django(anaconda)服务器配置 lto 版本错误解决:https://blog.csdn.net/king_way/article/details/80821139

django系列
django入门进阶01学习笔记01
django入门进阶02学习笔记02
django入门进阶03学习笔记03
django入门进阶04学习笔记04
django入门进阶05快捷复习手册
django入门进阶06静态文件和模板
django入门进阶07用户模块与权限系统
django入门进阶08数据库事务
django入门进阶09中间件
django入门进阶10部署上线(nginx,uwsgi,supervisor)
django入门进阶11websocket
django入门进阶12信号
django入门进阶13异常之makemigrations

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×