2020最新nginx+gunicorn+supervisor部署基于flask开发的项目的生产环境的详细攻略

本攻略基于ubuntu1804的版本，服务器用的华为云的服务器，python3（python2已经在2020完全中止维护了，因此转到python3是必须的）欢迎加个人QQ6398903，或QQ群讨论相关技术php

1、准备项目所须要的模块

你须要把开发环境下用到的包信息所有导出
`` pip freeze > requirements.txt
而后，把requirements.txt文件上传服务器

css

2、准备生产环境的python虚拟环境

毕竟生产环境，也可能运行多个python项目，因此须要准备好python的虚拟环境
ubuntu1804默认只有python3哈，安装虚拟环境须要先安装venv
``sudo apt install python3-venv
建立一个目录用于存放虚拟环境

html

mkdir -p /opt/python/
sudo python3 -m venv myprj     #最后是项目的名字
. /opt/python/myprj/bin/activate    #激活虚拟环境， 别忘记了前面的点【.】激活以后命令行前面又虚拟环境的名字，说明成功
pip install --upgrade pip    #先升级一下Pip
pip intall -r requirements.txt   # 一次安装所有的python模块

3、安装gunicorn

gunicorn是基于wsgi（web 服务网关接口）web服务器，与flask是绝配（通常django用uwsgi）java

pip install gevent   #若是你的项目中没有用到gevent，那么安装gunicorn以前，须要安装一下
pip install gunicorn 
deactivate     #退出虚拟环境

能够直接使用gunicorn命令来启动程序，例如
``gunicorn -w 4 -b 127.0.0.1:5000 main:app
【注意】上面的命令，须要在激活虚拟环境的状况下，到项目目录中运行，项目启动文件是main.py 里面又变量名是app的flask的实例
特别要注意，main.py里面要有

python

if __name__ == "__main__":
    app.run()

不然，gunicorn启动项目时，会报错
下面是经常使用命令说明：
nginx

-c CONFIG, --config=CONFIG
# 设定配置文件。
-b BIND, --bind=BIND
# 设定服务须要绑定的端口。建议使用HOST:PORT
-w WORKERS, --workers=WORKERS
# 设置工做进程数。建议服务器每个核心能够设置2-4个。
-k MODULE
# 选定异步工做方式使用的模块。

4、配置gunicorn的配置信息

gunicorn直接使用.py文件做为配置文件，因此，里面是支持py语法的web

from gevent import monkey
monkey.patch_all()
import multiprocessing

#debug = True
loglevel = 'debug'
bind = '127.0.0.1:6000' #绑定与Nginx通讯的端口
pidfile = 'log/gunicorn.pid'
accesslog = 'log/access.log'
errorlog = 'log/debug.log'
#daemon = True
workers = multiprocessing.cpu_count() * 2 + 1
worker_class = 'gevent' #默认为阻塞模式，最好选择gevent模式

保存到，项目目录下的conf/guni.confdjango

上面的配置文件中，又两个注释的地方，一个注意事项flask

debug=True 很好理解，就是刚上线时，能够开启，方便发现错误，正式启用要注销
daemon=True 意思是以守护进程的形式运行，适合直接输入gunicorn命令来运行，【注意】但若是您想用supervisor来管理的话，这个要注销
须要在项目文件中，创建一个log的文件夹，不然报错没法启动，由于咱们的日志文件和pid都须要保存在Log目录中

5、经过配置文件启动gunicorn以及守护进程启动

把以前的命令，修改一下，
gunicorn -w 4 -b 127.0.0.1:5000 -c conf/guni.conf main:app 若是conf文件中，又deamon=True，那么将以守护进程在后台中运行或者使用 nohup gunicorn -w 4 -b 127.0.0.1:5000 -c conf/guni.conf main:app
这个时候，就能够退出python虚拟环境了
``deactivate #退出虚拟环境

ubuntu

6、配置nginx

nginx的安装、配置、使用，请看我以前教程2020年ubuntu1804安装nginx最新稳定版1.16详细教程笔记
接着以前文件接续补充
在/etc/nginx/conf.d/目录下，新建一个myprj.conf文件，填入下信息

server {
        listen 80;
        root /data/python/myprj;
        server_name xxx.xx.xxx.xxx;
        location / {
            proxy_set_header x-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header Host $http_host;
            proxy_pass http://localhost:6000/; # gunicorn绑定的端口号
        }
        # 配置static的静态文件：
        location ~ ^\/static\/.*$ {
            root /data/python/myprj;
        }
}

在配置nginx最容易出现的问题是，静态文件的配置，一旦没有配好，致使图片,css文件没法访问
Nginx路径location配置中，使用root目录与alias目录的区别

alias指定的目录是准确的，即location匹配访问的path目录下的文件直接是在alias目录下查找的；

location /static/ {
        alias  /var/www/static/;
    }
#注意：alias指定的目录后面必需要加上"/"，即/var/www/static/不能改为/var/www/static

root指定的目录是location匹配访问的path目录的上一级目录,这个path目录必定要是真实存在root指定目录下的；

location /static/ {
        root  /var/www/;
    }
#注意：location中指定的/static/必须是在root指定的/var/www/目录中真实存在的。
#二者配置后的访问效果是同样的。

配置习惯
通常状况下，在nginx配置中的良好习惯是：
- 在location / 中配置root目录
- 在location /somepath/ 中配置alias虚拟目录
nginx加载新的配置

nginx -t     #必定要先检查，看到成功的信息，
nginx -s reload

7、安装和配置supervisor

supervisor是一个python开发的进程管理工具，不光能够管理python项目，java项目，php-pfm后台启动程序均可以管理哦

安装
`` sudo apt install supervisor
配置文件
到/ect/supervisor/conf.d/目录下，新建myprj.conf文件
``vim myprj.conf
填入以下内容

[program:aijiaoyu]
command=/opt/python/myprj./bin/gunicorn -c /data/python/myprj./env/gunc.py main:app
directory=/data/python/myprj
user=root
autorestart=true
startsecs=10
startretires=3
redirect_stderr=true
stdout_logfile_maxbytes=100MB
stdout_logfile_backups = 20
stdout_logfile=/var/log/supervisor/myprj.log

配置文件的简单说明

program:myprj]   #登记项目名称
directory=/data/python/myprj
command=/opt/python/myprj./bin/gunicorn -c /data/python/myprj./env/gunc.py main:app 程序启动命令
autostart=true       ; 在supervisord启动的时候也自动启动
startsecs=10         ; 启动10秒后没有异常退出，就表示进程正常启动了，默认为1秒
autorestart=true     ; 程序退出后自动重启,可选值：[unexpected,true,false]，默认为unexpected，表示进程意外杀死后才重启
startretries=3       ; 启动失败自动重试次数，默认是3
user=root          ; 用哪一个用户启动进程，默认是root
priority=999         ; 进程启动优先级，默认999，值小的优先启动
redirect_stderr=true ; 把stderr重定向到stdout，默认false
stdout_logfile_maxbytes=100MB  ; stdout 日志文件大小，默认50MB
stdout_logfile_backups = 20   ; stdout 日志文件备份数，默认是10
; stdout 日志文件，须要注意当指定目录不存在时没法正常启动，因此须要手动建立目录（supervisord 会自动建立日志文件）
stdout_logfile=/var/log/supervisor/myprj.log
stopasgroup=false     ;默认为false,进程被杀死时，是否向这个进程组发送stop信号，包括子进程
killasgroup=false     ;默认为false，向进程组发送kill信号，包括子进程

让supervisor更新配置

sudo supervisorctl update   #更新配置
sudo supervisorctl reload   #重启
sudo supervisorctl status  #查看全部项目的状况
sudo supervisorctl stop/start/restart  项目名称

【注意】必定不能以守护进程启动，不然supervisor会检测不到进程，从而认为进程启动失败

总结

每次看别人的博客，都是以为不完整，因此本身重写了这个教程。一个完成的流程
若是对你有用，请点个赞，或者关注，欢迎加群一块儿交流技术

参考文档：