supervisor+gunicorn部署python web项目

有了Nginx，对于Tomcat没有必要详细了解。

有了supervisor，再也没有必要把一个程序设置成服务、驻留进程，supervisor真是一个相见恨晚的好工具。

在Tomcat中，所有的webapp默认共享8080端口；在Python世界中，每一个web程序都要占用一个端口，要想让这些web程序共享80端口，就需要使用Nginx进行反向代理，Nginx相当于一个路由器用来转发请求。Nginx跟Tomcat、Gunicorn之间的关系是相当的松耦合，Nginx根本不负责管理这些服务器，Nginx只是一个请求转发器，当请求来临，判断一下请求的类型、重写一下请求、将请求转发向合适的处理者。即便是Tomcat、Gnicorn崩了，Nginx也是不关心。Nginx只知道向某个端口转发请求。

最简单的运行python web的方式

最简单的python web运行方式是使用nohup myCmd & 命令运行，nohup表示no hang up，关闭远程登录之后程序不挂起继续执行，&表示后台执行。

对于django，使用命令python manage.py runserver 0.0.0.0:8000

对于flask，使用命令python mine.py

使用supervisor

supervisor是用Python语言编的进程管理、监控工具，只适用于Linux。

supervisor功能虽然强大，但常用功能也就那么一点点，实在没有必要对它特别了解。

知道常用配置足矣。

安装supervisor可以采用pip install的方式，但是可能出错（supervisor与python版本的问题）。

supervisor不仅是python包，也是一个应用程序，可以通过sudo apt-get install supervisor命令进行安装，这是最佳实践。

如果一个python工具不是编程调用，那就使用apt-get进行安装

这样安装还有一个好处，可以自动把supervisor设置成一个服务，从而可以开机自启动。

下面介绍与supervisor相关的几个概念：

echo_supervisord_conf命令：打印supervisor常用配置，可以重定向命令将配置输出到文本文件echo_supervisord_conf > haha.conf
supervisord：supervisor的后台守护进程，跟mysqld、ftpd等服务一样，它是一个TCP客户端，监听某个固定端口。
supervisorctl：command tools，是supervisor控制台，这个控制台可以远程控制服务器上的supervisord，它们之间的通信方式为XML-RPC
supervisorctl常用命令：help查看全部命令

当修改supervisord.conf之后，需要在supervisorctl中使用reload命令重新加载配置

supervisord命令加载配置的顺序：

如果使用-c命令指定配置文件位置，那么就加载那个文件，否则按如下顺序查找配置文件
$CWD/supervisord.conf
$CWD/etc/supervisord.conf
/etc/supervisord.conf

配置文件最佳实践：

将每一个应用创建一个conf文件，放在/etc/supervisor/conf.d目录下，主配置文件/etc/supervisord.conf中默认包含了conf.d目录下的配置文件。

像这种一个主配置文件，允许自定义从配置文件的方式很常见，很多软件都是这样配置的。

/etc/supervisord.conf主配置文件包含了conf.d/*.conf

[include]

files = /etc/supervisor/conf.d/*.conf

用supervisor管理gunicorn时，需要将gunicorn的deamon参数置为false。

[program:usercenter]

directory = /home/leon/projects/usercenter ; 程序的启动目录

command = gunicorn -c gunicorn.py wsgi:app  ; 启动命令，可以看出与手动在命令行启动的命令是一样的

autostart = true     ; 在 supervisord 启动的时候也自动启动

startsecs = 5        ; 启动 5 秒后没有异常退出，就当作已经正常启动了

autorestart = true   ; 程序异常退出后自动重启

startretries = 3     ; 启动失败自动重试次数，默认是 3

user = leon          ; 用哪个用户启动

redirect_stderr = true  ; 把 stderr 重定向到 stdout，默认 false

stdout_logfile_maxbytes = 20MB  ; stdout 日志文件大小，默认 50MB

stdout_logfile_backups = 20     ; stdout 日志文件备份数

; stdout 日志文件，需要注意当指定目录不存在时无法正常启动，所以需要手动创建目录（supervisord 会自动创建日志文件）

stdout_logfile = /data/logs/usercenter_stdout.log

; 可以通过 environment 来添加需要的环境变量，一种常见的用法是修改 PYTHONPATH

; environment=PYTHONPATH=$PYTHONPATH:/path/to/somewhere

更改完supervisor配置之后，使用sudo service supervisor restart命令重启supervisor服务。输入sudo service supervisor命令，按几下tab可以看到更多可用命令。使用sudo service supervisor force-reload 重新加载配置。

在supervisorctl中可以start、stop、restart+程序名称来控制这个程序。supervisorctl是一个交互式supervisor管理工具。sudo supervisorctl stop 服务名可以停止程序。sudo supervisorctl reload可以重新加载配置。sudo supervisorctl status可以查看服务运行状态。

修改主配置文件supervisord.conf中的inet_http_server部分可以通过网页方式访问supervisor，监控服务器状态。

查看日志

在服务器上，查看日志是唯一能够看到程序运行细节的方式。大部分程序的默认日志都放在/var/log/目录下（像Nginx、supervisor等工具的日志都在这里）。如果配置完supervisor之后，发现没有达到想要的效果，有可能是配置不正确，至于哪里不正确，可以去日志/var/log/supervisor里看一下。

我们在/etc/supervisor/conf.d/xxx.conf 中配置了stdout和stderr，去对应路径下tail -f，然后尝试sudo service supervisor restart重启服务，肯定能够定位错误。

更多配置内容请使用echo_supervisord_conf|more命令慢慢查看吧。

使用gunicorn

gunicorn也是只适用于Linux，不适用于windows。

gunicorn也是采用apt-get方式安装，gunicorn当然也是一个应用，不用管它是用python2开发的还是python3开发的，直接sudo apt-get install肯定好使。

最简单的方式启动django应用：

cd到myweb/myweb目录下（myweb是django项目名称），直接运行gunicorn -b0.0.0.0:8000 wsgi:application

解释：

-b参数用来绑定监听端口，默认是绑定到localhost，改成0.0.0.0就变成了监听全部主机的端口，这样才能够外网访问。
wsgi为python文件名，application为文件中的一个变量

将gunicorn后台运行有多种方式：

使用supervisor管理之，这时gunicorn一定不是守护进程
使用nohup gunicorn wsgi:application&不挂起地执行
使用gunicorn的--deamon参数，使之作为deamon来运行
将gunicorn设置成一个服务

一旦使用了supervisor，就再也没有必要添加更多的服务、守护进程了，用supervisor就足够了。

将一个程序设置成服务，需要如下步骤：

编辑 sudo nano /etc/init/gunicorn.conf

description "The gunicorn service"

start on runlevel [2345]

stop on runlevel [!2345]

respawn

setuid root

setgid www-data

env PATH= /var/www/venv/bin

chdir /var/www/

exec gunicorn -w 4 -b 127.0.0.1:8080 wsgi:application

如上，设置好用户、当前路径、全局变量、要执行的命令。

sudo service gunicorn start就可以将gunicorn作为服务运行了

详细文档

supervisor官方文档

 gunicorn官方文档