Python 安装 uWSGI
1、通过 pip 命令:
pip install uwsgi
2、下载安装脚本:
curl http://uwsgi.it/install | bash -s default /tmp/uwsgi
将 uWSGI 二进制安装到 /tmp/uwsgi ,你可以修改它。
3、源代码安装:
wget http://projects.unbit.it/downloads/uwsgi-latest.tar.gz
tar zxvf uwsgi-latest.tar.gz
cd uwsgi-latest
make
安装完成后,在当前目录下,你会获得一个 uwsgi 二进制文件。
第一个 WSGI 应用
让我们从一个简单的 "Hello World" 开始,创建文件 foobar.py,代码如下:
def application(env, start_response):
start_response('200 OK', [('Content-Type','text/html')])
return [b"Hello World"]
uWSGI Python 加载器将会搜索的默认函数 application 。
接下来我们启动 uWSGI 便可以运行一个 HTTP 服务器,将程序部署在HTTP端口 9090 上:
uwsgi --http :9090 --wsgi-file foobar.py
在浏览器内输入:http://127.0.0.1:9090,查看是否有"Hello World"输出,若没有输出,请检查你的安装过程。
添加并发和监控
默认情况下,uWSGI 启动一个单一的进程和一个单一的线程。
你可以用 --processes 选项添加更多的进程,或者使用 --threads 选项添加更多的线程 ,也可以两者同时使用。
uwsgi --http :9090 --wsgi-file foobar.py --master --processes 4 --threads 2
以上命令将会生成 4 个进程, 每个进程有 2 个线程。
如果你要执行监控任务,可以使用 stats 子系统,监控的数据格式是 JSON:
uwsgi --http :9090 --wsgi-file foobar.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191
我们可以安装 uwsgitop(类似 Linux top 命令) 来查看监控数据:
pip install uwsgitop
然后输入:uwsgitop http://127.0.0.1:9191
或者通过如下命令启动uWSGI:
uwsgi --http :9090 --wsgi-file hello.py --master --processes 4 --threads 2 --stats /tmp/stats.socket
然后输入:uwsgitop /tmp/stats.socket
都可以获得下面这样的实时监视状态:
其中每个字段的介绍如下:
Field |
Description |
WID |
Worker ID |
% |
Worker usage |
PID |
Worker PID |
REQ |
Worker从最近一次启动算起执行的请求次数 |
RPS |
每秒请求次数 |
EXC |
异常次数 |
SIG |
被管理的uWSGI信号 |
STATUS |
Worker是忙碌状态还是空闲状态 |
AVG |
平均请求时间 |
RSS |
Worker RSS(Resident Set Size,参阅linux内存管理) |
VSZ |
Worker VSZ(Virtual Memory Size,参阅linux内存管理) |
TX |
worker传输了多少数据 |
ReSpwn |
重启次数(Respawn count) |
HC |
Harakiri 次数(Harakiri是可以设置一个请求超过多少秒后会被中断) |
RunT |
Worker运行了多长时间 |
LastSpwn |
最后一次启动时间 |
结合 Nginx Web 服务器使用
你可以阅读 Nginx 安装配置 了解更多内容。
我们可以将 uWSGI 和 Nginx Web 服务器结合使用,实现更高的并发性能。
一个常用的nginx配置如下:
location / {
include uwsgi_params;
uwsgi_pass 127.0.0.1:3031;
}
以上代码表示使用 nginx 接收的 Web 请求传递给端口为 3031 的 uWSGI 服务来处理。
现在,我们可以生成 uWSGI 来本地使用 uwsgi 协议:
uwsgi --socket 127.0.0.1:3031 --wsgi-file foobar.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191
如果你的 Web 服务器使用 HTTP,那么你必须告诉 uWSGI 本地使用 http 协议 (这与会自己生成一个代理的–http不同):
uwsgi --http-socket 127.0.0.1:3031 --wsgi-file foobar.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191
如上,在浏览器内输入:http://127.0.0.1:9191。查看是否有"Hello World"输出,若没有输出,请检查你的安装过程。
WSGI 部署 Django
Django 是最常使用的 Python web 框架,假设 Django 项目位于 /home/foobar/myproject:
uwsgi --socket 127.0.0.1:3031 --chdir /home/foobar/myproject/ --wsgi-file myproject/wsgi.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191
--chdir 用于指定项目路径。
我们可以把以上的命令弄成一个 yourfile.ini 配置文件:
[uwsgi]
socket = 127.0.0.1:3031
chdir = /home/foobar/myproject/
wsgi-file = myproject/wsgi.py
processes = 4
threads = 2
stats = 127.0.0.1:9191
接下来你只需要执行以下命令即可:
uwsgi yourfile.ini
uwsgi 配置+Nginx配置
uwsgi支持ini、xml等多种配置方式,本文以 ini 为例, 在/etc/目录下新建uwsgi9090.ini,添加如下配置:
[uwsgi]
socket = 127.0.0.1:9090 //传递给为 3031 的 uWSGI 服务来处理
master = true //主进程
vhost = true //多站模式
no-site = true //多站模式时不设置入口模块和文件
workers = 2 //子进程数
reload-mercy = 10
vacuum = true //退出、重启时清理文件
max-requests = 1000
limit-as = 512
buffer-size = 30000
pidfile = /var/run/uwsgi9090.pid //pid文件,用于下面的脚本启动、停止该进程
daemonize = /website/uwsgi9090.log
找到nginx的安装目录(如:/usr/local/nginx/),打开conf/nginx.conf文件,修改server配置:
server {
listen 80; //远端端口
server_name localhost;
location / {
include uwsgi_params;
uwsgi_pass 127.0.0.1:9090; //必须和uwsgi中的设置一致,转发到本地处理端口
uwsgi_param UWSGI_SCRIPT demosite.wsgi; //入口文件,即wsgi.py相对于项目根目录的位置,“.”相当于一层目录
uwsgi_param UWSGI_CHDIR /demosite; //项目根目录
index index.html index.htm;
client_max_body_size 35m;
}
}
你可以阅读 Nginx 安装配置 了解更多内容。
设置完成后,在终端运行:
uwsgi --ini /etc/uwsgi9090.ini &
/usr/local/nginx/sbin/nginx
在浏览器输入:http://127.0.0.1,你就可以看到 django 的 "It work" 了。
然后输入:uwsgitop http://127.0.0.1:9191
或者通过如下命令启动uWSGI:
uwsgi --http :9090 --wsgi-file hello.py --master --processes 4 --threads 2 --stats /tmp/stats.socket
然后输入:uwsgitop /tmp/stats.socket
都可以获得下面这样的实时监视状态:
其中每个字段的介绍如下:
Field |
Description |
WID |
Worker ID |
% |
Worker usage |
PID |
Worker PID |
REQ |
Worker从最近一次启动算起执行的请求次数 |
RPS |
每秒请求次数 |
EXC |
异常次数 |
SIG |
被管理的uWSGI信号 |
STATUS |
Worker是忙碌状态还是空闲状态 |
AVG |
平均请求时间 |
RSS |
Worker RSS(Resident Set Size,参阅linux内存管理) |
VSZ |
Worker VSZ(Virtual Memory Size,参阅linux内存管理) |
TX |
worker传输了多少数据 |
ReSpwn |
重启次数(Respawn count) |
HC |
Harakiri 次数(Harakiri是可以设置一个请求超过多少秒后会被中断) |
RunT |
Worker运行了多长时间 |
LastSpwn |
最后一次启动时间 |