Python程序(Django/Flask)部署方式

使用Django可以追溯到15年，但是这还是第一次使用Nginx+uWSGI的方式对其进行部署，以前要么是小项目直接runserver，要么用nginx做http转发，但是使用Nginx+uWSGI明显是部署Django最好的方式了。至于为什么一定要用这样的方式，这篇文章讲得比较好《部署Django项目背后的原理：为什么需要Nginx和Gunicron这些东西》

使用Nginx+uWsgi部署Django/Python应用

部署步骤

首先，要保证你的应用能使用python manage.py runserver命令启动起来
安装uWSGI，pip install uwsgi
测试让uWSGI直接运行项目于http上，uwsgi --http :8000 --module mysite.wsgi，这里的mysite.wsgi即是你的项目目录下的wsgi.py文件，实际的目录应该是mysite/mysite/wsgi.py
安装nginx，参考Nginx教程

配置nginx，参考上面的nginx教程，进行配置，主要是添加如下一个server:

upstream django {
	# server unix:///pathto/mysite/mysite/mysite.sock;
	server 127.0.0.1:8000;	# 这个时候就相当于一个端口转发
}

server {
	listen 80;
	charset utf-8;

	location / {
		uwsgi_pass django;

    # 设置nginx与uwsgi之间的超时时间，默认是60秒
    uwsgi_send_timeout 180;
    uwsgi_connect_timeout 180;
    uwsgi_read_timeout 180;

    # 下面的配置可以保存成文件然后include，有些nginx版本自带了/etc/nginx/uwsgi_params的，直接在这里include uwsgi_params即可
    
		uwsgi_param  QUERY_STRING       $query_string;
		uwsgi_param  REQUEST_METHOD     $request_method;
		uwsgi_param  CONTENT_TYPE       $content_type;
		uwsgi_param  CONTENT_LENGTH     $content_length;

		uwsgi_param  REQUEST_URI        $request_uri;
		uwsgi_param  PATH_INFO          $document_uri;
		uwsgi_param  DOCUMENT_ROOT      $document_root;
		uwsgi_param  SERVER_PROTOCOL    $server_protocol;
		uwsgi_param  REQUEST_SCHEME     $scheme;
		uwsgi_param  HTTPS              $https if_not_empty;

		uwsgi_param  REMOTE_ADDR        $remote_addr;
		uwsgi_param  REMOTE_PORT        $remote_port;
		uwsgi_param  SERVER_PORT        $server_port;
		uwsgi_param  SERVER_NAME        $server_name;
	}
  
  # 代理静态文件，需要注意的是，admin等插件的静态文件是在库里面的，需要使用python manage.py collectstatic命令将所有静态文件移动到/static/下面
  location /static/ {
    alias /pathto/mysite/static/;
  }
}

然后重启nginx，就能访问刚才用uwsgi命令启动的8000端口的服务了

使用socket的方式启动应用程序，usgi --socket :8000 --module mysite.wsgi，然后在nginx配置的upstream那里将原来的端口方式修改成socket的方式：server unix:///pathto/mysite/mysite/mysite.sock;其中mysite.sock，然后重启nginx查看是否仍然能正常访问。

将socket的启动参数写入到文件，这里我是直接把配置文件放到项目目录下的，方便以后启动:

# /usr/local/bin/uwsgi --ini /data/mysite/mysite/uwsgi.ini --daemonize /var/log/uwsgi.log  启动命令

# uwsgi.ini file
[uwsgi]

# Django-related settings
# the base directory (full path)
chdir           = /data/mysite

# Django's wsgi file
module          = mysite.wsgi

# the virtualenv (full path)
# home            = /path/to/virtualenv

# process-related settings
# master
master          = true
# maximum number of worker processes进程数量一般与CPU数量相等
processes       = 8
threads 		= 32	# 默认一个进程是一个线程，可以直接提高线程的数量

# the socket (use the full path to be safef
socket          = /path/to/swy-api.sock	// 随便放哪里，也可以放在项目目录下

# ... with appropriate permissions - may be needed
chmod-socket    = 666		# 修改权限，以防出现connect() to unix:///path/to/your/mysite/mysite.sock failed (13: Permission
denied)错误
# clear environment on exit
vacuum          = true

py-autoreload = 1		# python代码变更后自动重启，线上更新代码后不要依赖于这个重启，最好supervisor重启所有进程，否则可能有些进程没生效
buffer-size = 65535		# 针对莫名其妙出现502错误的一个可能的解决方法

综上，其实是和php-fpm部署的方式类似，使用wsgi协议启动应用，然后nginx直接获取其socket就行了。

使用supervisor管理uwsgi

如果仅仅用上面的方式来启动应用，应用有修改后，py-autoreload会自动重启应用，但是如果想要批量管理进程，例如批量开启或重启或关闭就有点麻烦了，并且程序挂了也没有自动重启机制，所以这里要用到supervisor。按照使用Supervisor管理进程安装supervisor并生成配置文件后，在配置文件中添加以下的program即可

[program:uwsgi]
command=/usr/local/bin/uwsgi --ini /path/to/uwsgi.ini
user=root
startsecs=0
stopwaitsecs=0
autostart=true
autorestart=true
stdout_logfile=/var/log/supervisor/uwsgi.stdout.log
stderr_logfile=/var/log/supervisor/uwsgi.stderr.log
redirect_stderr=true

使用Gunicorn部署Django应用

需要注意的是不能使用gunicorn ... > /log这样的方式来重定向输出，而是应该直接指定日志文件的方式，例如gunicorn --worker-class=gevent --capture-output --access-logfile=/var/log/python/python-safe-risk-web.log --error-logfile=/var/log/python/python-safe-risk-web.log -w 4 -b 0.0.0.0:5000 run:app，还要设置环境变量PYTHONUNBUFFERED=1
主程序run.py里面一定要暴露出app才能用run:app运行，把app放到__main__里面是不行的

部署步骤及参数设置

安装依赖: pip install gunicorn gevent
测试能否正常运行程序gunicorn -w4 -b0.0.0.0:8000 myproject.wsgi:application

还有一种方式是以文件的方式加载配置文件:

# vim test.coonf
import os

bind = ["127.0.0.1:8000", "unix:///tmp/myproject.sock"]
workers = 4	# 相当于进程数，一般设置为2*CPU+1
worker_connections = 1000	# 每个work的连接数
threads = 2	# 每个worker有2个线程
chdir = os.path.dirname(os.path.realpath(__file__))
raw_env = ["DJANGO_SETTINGS_MODULE=myproject.settings"]
accesslog = "/var/log/myproject_access.log"
errorlog = "/var/log/myproject_error.log"
daemon = False
pidfile = "/tmp/myproject_server.pid"
worker_class = "gevent"
timeout = 30	# 默认30秒断开连接并且会终止worker并重启它
reload = False	# 修改代码是否自动重启work，默认为Fa

然后直接执行gunicorn --config=test.conf myproject.wsgi:application

最后再像uWsgi那样配合supervisor和Nginx即可

TroubleShooting

莫名其妙出现502错误，但是程序没有挂也确实没有错误日志: 可以尝试设置uwsgi的buffer-size=65535缓存值，默认是4096，如果不行就在nginx上面设

扩展阅读

uwsgitop：可以像top命令那样打印uwsgi各个进程的实时状态