快速开始Python/WSGI应用程序
快速开始Python—wsig应用程序
安装 uwsgi
- 安装
pip install uwsgi
uwsgi --version # 查看 uwsgi 版本
- 测试 uwsgi 是否正常
新建一个测试文件 helloworld.py
def application(env, start_response):
start_response('200 OK', [('Content-Type', 'text/html')])
return [b'hello world',]
- 启动并监听 9090 端口
uwsgi --http :9090 --wsgi-file helloworld.py
- 添加并发性和监视调优
uwsgi 默认是单进程单线程启动的
添加多进程使用 --processes 选项， 添加多线程使用 --threads 选项
uwsgi --http :9090 --wsgi-file helloworld.py --master --processes 4 --threads 2
# 表示启动 4 个进程，每个进程 2 个线程；一个主进程，当进程挂掉后从新生成新的进程
监测是一个重要的任务。在生产环境中知道发生了什么是至关重要的
stats 子系统允许你以 json 格式导出 uwsgi 的内部统计信息
uwsgi --http :9090 --wsgi-file helloworld.py --master --processes 4 --threads 2 --stats 127.0.0.1:9091
# 添加监测，通过 127.0.0.1:9091 访问 json 格式的统计信息
# 把 stats 绑定到一个私有地址，否则所有人都可以访问这个统计信息
uwsgitop 一个类似 top 的监控 uwsgi 的工具
pip install uwsgitop
- 把 uwsgi 放到web服务器后端(nginx， apache等)
uwsgi可以使用 HTTP, FastCGI, SCGI, uwsgi 协议，其中性能最好的是 uwsgi，nginx 支持 uwsgi 协议，apache 在添加对应的模块后也可以支持 uwsgi 协议
一个常见的 nginx 配置如下：
location / {
include uwsgi_params;
uwsgi_pass 127.0.0.1:3031;
}
# 使用 uwsgi 协议将每个请求转发到绑定 3031 端口的服务器
使用 uwsgi 协议启动 uwsgi 服务器
uwsgi --socket 127.0.0.1:3031 --wsgi-file helloworld.py --master --processes 4 --threads 2 -stats 127.0.0.1:9191
如果你的代理前端服务器使用的是 http 协议，你必须让 uwsgi 也使用 http 协议
uwsgi --http-socket 127.0.0.1:3031 --wsgi-file helloworld.py --master --processes 4 --threads 2 --stats 127.0.0.1:9091
# --http 和 --http-socket 不一样，--http 自带一个代理
- 开机自动启动 uwsgi
在使用脚本来启动 uwsgi 之前，看是否可以使用其他进程管理程序来启动 uwsgi，比如:
Upstart, Systemd
supervisord, god, monit, circus
uwsgi 可以很好的与以上的进程管理器集成，如果有大量的应用需要部署，建议使用 uWSGI Emperor
- 部署 django
假设 django 项目路径是: /home/foobar/myproject
uwsgi --socket 127.0.0.1:3031 --chdir /home/foobar/myproject/ --wsgi-file myproject/wsgi.py --master --processes 4 --theads 2 --stats 127.0.0.1:9191
--chdir 切换到 django 的项目路径下，这是 django 正确加载模块所必须的
以上这个很长的命令行命令可以写在一个 uwsgi 的 .ini 格式的配置文件中，比如 foo.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 foo.ini
如果使用的是旧版本的django(< 1.4)，需要多加一下配置
uwsgi --socket 127.0.0.1:3031 --chdir /home/foobar/myproject/ --pythonpath .. --env DJANGO_SETTINGS_MODULE=myproject.settings --module "django.core.handlers.wsgi:WSGIHandler()" --processes 4 --threads 2 --stats 127.0.0.1:9191
[uwsgi]
socket = 127.0.0.1:3031
chdir = /home/foobar/myproject/
pythonpath = ..
env = DJANGO_SETTINGS_MODULE=myproject.settings
module = django.core.handlers.wsgi:WSGIHandler()
processes = 4
threads = 2
stats = 127.0.0.1:9191
旧版本的 django(< 1.4) 需要设置 env，module， pythonpath(允许获取到 myproject.settings 模块)
- 部署 flask
- 关于线程的说明
如果没有使用多线程启动 uwsgi，那么在应用里面生成的线程不会运行
可以使用 --enable-threads 选项，enable-threads = true .ini文件配置项，在不使用多线程启动 uwsgi 时支持应用内的多线程运行
- python 虚拟环境
uwsgi 支持 python 虚拟环境内查找 python 模块，只需要添加配置项 virtualenv = <path>
- 安全和可用性
安全性
不要使用 root 用户运行 uwsgi，可以使用 uid 和 gid 移除特权
[uwsgi]
https = :9090,foobar.crt,fooar.key
uid = foo
gid = bar
chdir = path_to_web2py
module = wsgihandler
master = true
processes = 8
如果要使用特权端口(如 443)，可以使用共享 socket
[uwsgi]
shared-socket = :443
https = 0, foobar.crt, foobar.key
uid = foo
gid = bar
chdir = path_to_web2py
module = wsgihandler
master = true
processes = 8
可以性
请求阻塞问题，可以设置一个 harakiri 定时器，在指定时间后销毁被阻塞的 worker
[uwsgi]
shared-socket = :443
https = =0,foobar.crt,foobar.key
uid = foo
gid = bar
chdir = path_to_web2py
module = wsgihandler
master = true
processes = 8
harakiri = 30
如果一个请求阻塞了 30 秒，那么这个 worker 会被销毁
可以通过 stats 子系统实时查看每个worker，thread 或者 async 工作情况
- 线程卸载
uwsgi offloading 子系统在特定匹配模式或可以使用纯C线程时，可以很快的释放掉 worker，比如：从文件系统发送静态文件，从网络发送数据等
意思是：worker把请求中的特定操作(发送文件，发送数据等)分配给其他的进程线程，从而使得 worker 可以被尽快释放，处理跟多的请求
添加 --offload-threads <n> 选项启用，(建议每个CPU启用 1 个线程)
- 多 python 版本支持
最好的方法是内置一个独立于语言的特性的二进制文件，并为每个Python版本提供一个按需加载的插件
编译时使用 PROFILE=nolang
make PROFILE=nolang
编译python 插件
PYTHON=python3.4 ./uwsgi --build-plugin "plugins/python python34"
PYTHON=python2.7 ./uwsgi --build-plugin "plugins/python python27"
PYTHON=python2.6 ./uwsgi --build-plugin "plugins/python python26"
会得到3个插件：python34_plugin.so, python27_plugin.so, python26_plugin.so
将这些复制到您想要的目录中，默认情况下，uWSGI在当前工作目录中搜索插件。
现在可以在 uwsgi 配置文件中使用这些插件，添加在最顶端
[uwsgi]
plugins-dir = <path_to_your_plugin_directory>
plugin = python26
2019-2-20 by achxku@163.com
