通常项目会部署在虚拟环境,虚拟环境的使用可以参考这里,点击前往
当然你也可以直接部署,这里不多说。
一、安装uWSGI
1.通过pip安装
pip install uwsgi
这里只说明了一种安装方式,其他安装方式可以参考官网,点击跳转。
二、第一个WSGI程序
# 创建一个名为test.py 的文件
# test.py
def application(env, start_response):
start_response('200 OK', [('Content-Type','text/html')])
return [b"Hello World"] # python3版本
#return ["Hello World"] # python2版本
# 在HTTP端口9090上进行部署
uwsgi --http:8000 --wsgi-file test.py
选项说明:
- --http : 使用协议http,端口9090
- --wsgi-file test.py : 加载指定的文件test.py
现在再去访问,我这里的地址为http://192.168.10.165:8000/就可以看到Hello World 信息
如果是这样,工作流程为 网络客户端 <--> uWSGI <--> Python
三、添加并发和查看uwsgi状态
每一个处于监听(Listen)状态的端口,都有自己的监听队列.监听队列的长度,与如下两方面有关:
somaxconn参数和使用该端口的程序中listen()函数
可以通过echo >/proc/sys/net/core/somaxconn 命令来修改系统的监听队列长度。并且在/etc/sysctl.conf文件中添加net.core.somaxconn = 1024 并sysctl -p生效。
通过 添加--listen num参数增加队列长度。
默认情况下,uWSGI以单进场和单线程开始的,你可以使用--processes添加更多的进程,--threads添加更多的线程
uwsgi --http :9090 --wsgi-file test.py --master --processes 4 --threads 2
查看uwsgi状态:
统计子系统允许将uWSGI的内部统计信息导出为JSON
uwsgi --http :9090 --wsgi-file test.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191
请求您的应用程序,然后Telnet到端口9191,你会得到很多关系uwsgi的相关信息。
使用“uwsgitop”工具可以来监控实例
需要使用pip install uwsgitop 来安装uwsgitop
注意:将统计套接字绑定到私人地址(除非你知道你在做什么),否则每个人都可以访问它!
uwsgi的使用还有其他很多的选项,查看更多点击这里。
四、uwsgi + Django配置
现在我们希望uWSGI做同样的事情,但是运行Django站点而不是test.py 模块。
首先我们来创建一个django 站点,并启动测试该站点是否可以正常访问:
source bin/activate # 进去python虚拟环境
pip install django # 安装django
django-admin startproject mysite # 新建站点
cd mysite/
vim mysite/settings.py # 配置ALLOWED_HOSTS为‘["*"]’,方便其他主机访问站点,也可以不修改
python manage.py runserver 0.0.0.0:8000 # 启动并测试可用性
在测试站点可以正常运行后,关闭站点,下面来使用uwsgi来运行django项目:
uwsgi --http :8000 --module mysite.wsgi
- --module mysite.wsgi : 加载指定的wsgi模块
- --http : add an http router/server on the specified address
- --socket: bind to the specified UNIX/TCP socket using default protocol
通过浏览器访问页面,如果页面出现,意味着uWSGI能够从你的virtualenv服务于你的django项目,并且正常运行,此时的工作流程为:
网络客户端 <--> uWSGI <--> Django
注意:
此时如果你的django需要访问静态文件,是访问不到的,需要利用uWSGI进行静态文件的配置,这里不作说明,因为一般也不需要uWSGI来处理站点的静态文件,
一般使用网络服务器来处理这些静态文件会更好,更高效。
通常不会让浏览器直接与uWSIG会话,这个是网络服务器的工作(这里为Nginx),uWSGI将作为一个中间件。
五、Nginx环境和静态文件配置
1.首先搭建Nginx环境
yum install nginx
/etc/init.d/nginx start # start nginx
nginx的配置问题这里不过多说明,避免与默认配置冲突,我选择新建vhost文件夹,在vhost下添加配置,然后导入到主配置文件中,这里使用8000端口。
新建一个Nginx的配置(mysite_nginx.conf)放入vhost中:(记得在Nginx主配置文件中导入该配置)
# mysite_nginx.conf # the upstream component nginx needs to connect to
upstream django {
# server unix:///path/to/your/mysite/mysite.sock; # for a file socket
server 127.0.0.1:8001; # for a web port socket (we'll use this first)
} # configuration of the server
server {
# the port your site will be served on
listen 8000;
# the domain name it will serve for
server_name .example.com; # substitute your machine's IP address or FQDN
charset utf-8; # max upload size
client_max_body_size 75M; # adjust to taste # Django media
location /media {
alias /path/to/your/mysite/media; # your Django project's media files - amend as required
} location /static {
alias /path/to/your/mysite/static; # your Django project's static files - amend as required
} # Finally, send all non-media requests to the Django server.
location / {
uwsgi_pass django;
include /path/to/your/mysite/uwsgi_params; # the uwsgi_params file you installed
}
}
# 这里的配置需要进行修改,路径为你项目路径
这个conf文件告诉nginx从文件系统提供媒体和静态文件,以及处理需要Django干预的请求。对于大型部署来说,让一台服务器处理静态/媒体文件以及另一个处理Django应用程序的
做法被认为是很好的做法,但是现在这样做会很好。
为了方便对文件的查看和修改,建议把配置文件建立一个软连接到项目目录下。
sudo ln -s /etc/nginx/sites-enabled/mysite_nginx.conf /path/to/your/mysite/
2.部署静态文件
在运行Nginx之前,必须在静态文件夹中收集所有的django静态文件,需要编辑mysite/settings.py 添加:
STATIC_ROOT = os.path.join(BASE_DIR, "static/")
# and then run
python manage.py collectstatic
这里需要注意一点,配置的静态文件夹和django的静态文件夹不能为一个。
3.检查静态文件配置
在启动Nginx是会报错,那是因为配置文件在的 include /path/to/your/mysite/uwsgi_params;
需要导入这个文件, 这个文件一般在Nginx uwsgi发行版的目录中,或从这里获取https://github.com/nginx/nginx/blob/master/conf/uwsgi_params
启动后检查是否可以获取静态文件。
六、Nginx + uWSGI + test.py
1.使用uWSGI启动一个socket ,使nginx可以转发到uWSGI
uwsgi --socket:8001 --wsgi-file test.py
- socket:8001 : 使用协议uwsgi,端口8001
nginx同时被配置为与该WSGI在该端口上通信,并与外界在8000端口进行通信
这是当前的堆栈:
web客户端 <--> web服务器 <--> 套接字 <--> uWSGI <--> pyhton(test.py)
2.使用Unix套接字实现
编辑mysite_nginx.conf,使用套接字来实现:
server unix:///path/to/your/mysite/mysite.sock; # for a file socket
# server 127.0.0.1:8001; # for a web port socket (we'll use this first)
这个socket
选项告诉uWSGI使用哪个文件进行套接字连接。
如果不行:
检查Nginx错误日志 nginx/error.log 如果你看到
connect() to unix:///path/to/your/mysite/mysite.sock failed (13: Permissiondenied)
那么可能你需要管理套接字的权限,以便运行nginx使用它。
uwsgi --socket mysite.sock --wsgi-file test.py --chmod-socket=666 # (verypermissive)
uwsgi --socket mysite.sock --wsgi-file test.py --chmod-socket=664 # (moresensible)
你可能还需要将用户添加到nginx的组里,以便nginx可以正确的读取和写入套接字
七、Nginx + uWSGI + Django
来运行我们的Django应用程序:
uwsgi --socket mysite.sock --module mysite.wsgi --chmod-socket=664 # 或者是666
现在uWSGI和nginx不仅仅是一个“Hello World ” ,而是个Django项目。
通过ini配置文件运行uWSGI
uwsgi支持通过各种的配置文件来启动服务,这里说一个ini配置文件
创建一个名为mysite_uwsgi.ini:
# mysite_uwsgi.ini file
[uwsgi] # Django-related settings
# the base directory (full path)
chdir = /path/to/your/project
# Django's wsgi file
module = project.wsgi
# the virtualenv (full path)
home = /path/to/virtualenv # process-related settings
# master
master = true
# maximum number of worker processes
processes = 10
# the socket (use the full path to be safe
socket = /path/to/your/project/mysite.sock
# ... with appropriate permissions - may be needed
# chmod-socket = 664 # 或者666
# clear environment on exit
vacuum = true
并运行uwsgi:
uwsgi --ini mysite_uwsgi.ini # the --ini option is used to specify a file
测试站点是否正常,成功。。
退出Python虚拟环境使用:
deactivate
八、皇帝模式来管理uWSGI
uWSGI可以运行在'皇帝'模式。在这种模式下,它会关注uWSGI配置文件的目录,并为每个配置文件生成一个实例('vassals')。
每当修改配置文件时,皇帝将自动重新启动附庸。
# create a directory for the vassals
sudo mkdir /etc/uwsgi
sudo mkdir /etc/uwsgi/vassals
# symlink from the default config directory to your config file
sudo ln -s /path/to/your/mysite/mysite_uwsgi.ini /etc/uwsgi/vassals/
# run the emperor
uwsgi --emperor /etc/uwsgi/vassals --uid nginx --gid nginx
-
emperor
:在哪里寻找附庸(配置文件) -
uid
:进程一旦启动的用户ID -
gid
:进程一旦启动的组ID