前言
django,nginx,uWSGI对于一个python程序员来说并不陌生,我们一般项目都用到这三者,今天我们就学习django使用uwsgi和nginx启动。
django: 一个基于python的开源web框架,请确保自己熟悉它的框架目录结构。
uWSGI: 一个基于自有的uwsgi协议、wsgi协议和http服务协议的web网关。
nginx: 是一个高性能的http和反web服务器,同时也提供了IMAP/POP3/SMTP服务
快速建django项目
# 创建一个虚拟环境
virtualenv uwsgi-tutorial
cd uwsgi-tutorial
# 进入虚拟环境 deactivate 退出虚拟环境
source bin/activate
pip install django==2.1.7 # 下载django
django-admin startproject FirstProject # 创建名为FirstProject的项目 项目名大写
python manage.py startapp app_name # 进入项目, 创建一个app
python manage.py runserver 0.0.0.0:8080 #运行django
安装和使用uwsgi
安装uwsgi
# 需要root权限安装,否则运行时会提示找不到uwsgi命令;
# 或者到Python执行文件所在目录找到uwsgi命令,通过绝对路径执行uwsgi命令
pip install uwsgi
配置uwsgi.ini文件
在Django的项目目录下与manage.py同级,新建uwsgi.ini文件,配置内容如下:
[uwsgi]
;对外提供 http 服务的端口
;http = :1002
;使用nginx连接时使用,Django程序所在服务器地址
socket=0.0.0.0:1003
; 通过该端口可以监控 uwsgi 的负载情况
;stats = 0.0.0.0:1004
;PYTHONHOME = /home/xx/documents/MonitorCenter/MonitorCenter/venv/bin/python3
;home=/home/xx/documents/MonitorCenter/MonitorCenter
;项目目录
chdir=/home/xx/documents/MonitorCenter/MonitorCenter
;项目中wsgi.py文件的目录,相对于项目目录
wsgi-file=MonitorCenter/wsgi.py
; 进程数
processes=4
; 线程数
threads=10
enable-threads=true
; uwsgi服务器的角色
master=True
; 存放进程编号的文件
pidfile=uwsgi.pid
; 日志文件,因为uwsgi可以脱离终端在后台运行,日志看不见。我们以前的runserver是依赖终端的
daemonize=MonitorCenter/log/uwsgi.log
; 指定依赖的虚拟环境
;virtualenv=/home/python/.virtualenvs/django_py3
# 设置socket的监听队列大小(默认:100)。
listen=120
# 设置用于uwsgi包解析的内部缓存区大小。默认是4k
buffer-size=32768
;设置每个工作进程处理请求的上限,达到上限时,将回收(重启)该进程。可以预防内存泄漏
max-requests=500
; 服务停止时自动移除unix Socket和pid文件
vacuum=true
注意:如果启动uWSGI但是项目访问不了,尝试把listen设置100或者注释掉试试
参数说明
master = true
#启动主进程,来管理其他进程,其它的uwsgi进程都是这个master进程的子进程,如果kill这个master进程,相当于重启所有的uwsgi进程。
chdir = /web/www/mysite
#在app加载前切换到当前目录, 指定运行目录
module = mysite.wsgi
# 加载一个WSGI模块,这里加载mysite/wsgi.py这个模块
py-autoreload=1
#监控python模块mtime来触发重载 (只在开发时使用)
lazy-apps=true
#在每个worker而不是master中加载应用
socket = /test/myapp.sock
#指定socket文件,也可以指定为127.0.0.1:9000,这样就会监听到网络套接字
processes = 2 #启动2个工作进程,生成指定数目的worker/进程
buffer-size = 32768
#设置用于uwsgi包解析的内部缓存区大小为64k。默认是4k。
daemonize = /var/log/myapp_uwsgi.log
# 使进程在后台运行,并将日志打到指定的日志文件或者udp服务器
log-maxsize = 5000000 #设置最大日志文件大小
disable-logging = true #禁用请求日志记录
vacuum = true #当服务器退出的时候自动删除unix socket文件和pid文件。
listen = 120 #设置socket的监听队列大小(默认:100)
pidfile = /var/run/uwsgi.pid #指定pid文件
enable-threads = true
#允许用内嵌的语言启动线程。这将允许你在app程序中产生一个子线程
reload-mercy = 8
#设置在平滑的重启(直到接收到的请求处理完才重启)一个工作子进程中,等待这个工作结束的最长秒数。这个配置会使在平滑地重启工作子进程中,如果工作进程结束时间超过了8秒就会被强行结束(忽略之前已经接收到的请求而直接结束)
max-requests = 5000
#为每个工作进程设置请求数的上限。当一个工作进程处理的请求数达到这个值,那么该工作进程就会被回收重用(重启)。你可以使用这个选项来默默地对抗内存泄漏
limit-as = 256
#通过使用POSIX/UNIX的setrlimit()函数来限制每个uWSGI进程的虚拟内存使用数。这个配置会限制uWSGI的进程占用虚拟内存不超过256M。如果虚拟内存已经达到256M,并继续申请虚拟内存则会使程序报内存错误,本次的http请求将返回500错误。
harakiri = 60
#一个请求花费的时间超过了这个harakiri超时时间,那么这个请求都会被丢弃,并且当前处理这个请求的工作进程会被回收再利用(即重启)
常见命令
uwsgi --ini uwsgi.ini # 启动
uwsgi --stop uwsgi.pid # 停止
uwsgi --reload uwsgi.pid # 重启
安装nginx
安装nginx前准备工作
- 检查gcc: gcc -v查看是否存在,不存在用 yum -y install gcc 安装
- yum list installed | grep "pcre" 检查 pcre、pcre-devel是否安装,没有安装则: yum install -y pcre pcre-devel
- 安装openssl: yum install -y openssl openssl-devel
确认以上都有的情况下我们安装nginx
$ vi /etc/yum.repos.d/nginx.repo
[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/centos/7/$basearch/
gpgcheck=0
enabled=1
$ yum -y install nginx
$ systemctl enable nginx # 开机启动
配置nginx
upstream blog_app {
# nginx通过socket在环回接口地址的9001端口与本地的uWSGI进程通信
# 支持ip:port模式以及socket file模式
#server unix:/opt/mywebapp/uwsgi_conf/uwsgi.sock;
server 127.0.0.1:1003;
}
server {
listen 9090;
server_name 127.0.0.1;
access_log /var/log/nginx/access.log;
charset utf-8;
location / {
# nginx转发动态请求到uWSGI
include uwsgi_params;
uwsgi_pass blog_app;
}
# 如果写成/static/,nginx无法找到项目静态文件路径
location /static {
alias /path/静态文件地址;
}
}
启动nginx就可以访问了,在运行nginx时候我碰到一个问题
启动nginx报错,报错如下:
Job for nginx.service failed because the control process exited with error code. See "systemctl status nginx.service" and "journalctl -xe" for details
其实这个错误运行 systemctl status nginx -l 查看就会告诉你哪里错误,比如我这里:
常用命令
启动nginx:systemctl start nginx
重启nginx:systemctl restart nginx
停止nginx:systemctl stop nginx
加入开机启动:systemctl enable nginx
查看nginx的状态:systemctl status nginx
nginx,uWSGI,django三者的关系图
runserver和uWSGI启动的区别
runserver: 调试 Django 时经常用到的运行方式,它使用Django自带的WSGI Server 运行,主要在测试和开发中使用,并且 runserver 开启的方式也是单进程(多线程)
uWSGI: Web服务器,它实现了WSGI协议、uwsgi、http 等协议。注意uwsgi是一种通信协议,而uWSGI是实现uwsgi协议和WSGI协议的 Web 服务器。uWSGI具有超快的性能、低内存占用和多app管理等优点,并且搭配着Nginx就是一个生产环境了,能够将用户访问请求与应用 app 隔离开,实现真正的部署。支持的并发量更高,方便管理多进程,发挥多核的优势,提升性能。
推荐链接
uWSGI+django+nginx的工作原理流程与部署历程
基于Centos+uWSGI+Nginx部署Django项目