flask部署(gunicorn+Supervisor+nginx)

- flask         python的服务器框架
- gunicorn      webservice,WSGI 的容器
- supervisor    进程管理工具
- nginx         一个高性能的 web 服务器

一、安装gunicorn

pip install gevent   #如果你的项目中没有用到gevent，那么安装gunicorn之前，需要安装一下
pip install gunicorn 
deactivate     #退出虚拟环境
#刷新
export PATH=$PATH:/usr/local/bin/python3/bin

可以直接使用gunicorn命令来启动程序，例如
gunicorn -w 4 -b 127.0.0.1:5000 main:app
【注意】上面的命令，需要在激活虚拟环境的情况下，到项目目录中运行，项目启动文件是main.py 里面又变量名是app的flask的实例
下面是常用命令说明：

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

二、配置gunicorn的配置信息

gunicorn直接使用.py文件作为配置文件，所以，里面是支持py语法的

    from gevent import monkey
    monkey.patch_all()
    import multiprocessing

    #debug = True
    # loglevel = 'debug'
    bind = '127.0.0.1:5000' #绑定与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.conf

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

1、debug=True 很好理解，就是刚上线时，可以开启，方便发现错误，正式启用要注销
2、daemon=True 意思是以守护进程的形式运行，适合直接输入gunicorn命令来运行，【注意】但如果您想用supervisor来管理的话，这个要注销
3、需要在项目文件中，建立一个log的文件夹，否则报错无法启动，因为我们的日志文件和pid都需要保存在Log目录中

三、通过配置文件启动gunicorn以及守护进程启动

把之前的命令，修改一下，gunicorn -w 4 -b 127.0.0.1:5000 -c conf/guni.conf main:app 如果conf文件中，有deamon=True，那么将以守护进程在后台中运行

四、配置nginx

nginx的安装推荐以下文章https://www.cnblogs.com/nickchou/p/12978724.html

#user  nobody;
worker_processes  auto;
pid /usr/local/nginx/logs/nginx.pid;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;
events {
    worker_connections  1024;
}

http {
    client_max_body_size 100m;
    include      /usr/local/nginx/conf/mime.types;
    default_type  application/octet-stream;
    #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
    #                  '$status $body_bytes_sent "$http_referer" '
    #                  '"$http_user_agent" "$http_x_forwarded_for"';
    access_log  logs/access.log;
    error_log logs/error.log;

    sendfile        on;
    tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;

    gzip  on;
    gzip_disable "msie6";

    server {
        listen       80;
        server_name  0.0.0.0;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

        location / {
            proxy_pass http://127.0.0.1:5000; # 这里是指向 gunicorn host 的服务地址
            proxy_set_header Host $host;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }

        #error_page  404              /404.html;

        # redirect server error pages to the static page /50x.html
        #
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }
}

五、安装和配置supervisor

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

1、安装 Supervisor 
  yum install supervisor
2、检查 Supervisor 配置文件
  vim /etc/supervisord.conf
    找到最后一行，检查是否是如下内容
    [include]
    files = supervisord.d/*.ini
2.1、注意：/etc/supervisord.conf文件中有部分配置默认设置为/tmp/xxx，可能存在一段时间后出现unix:///tmp/supervisor.sock no such file的问题()
2.1.1、打开配置文件
vim /etc/supervisord.conf
这里把所有的/tmp路径改掉，/tmp/supervisor.sock 改成 /var/run/supervisor.sock，/tmp/supervisord.log 改成 /var/log/supervisor.log，/tmp/supervisord.pid 改成 /var/run/supervisor.pid 要不容易被linux自动清掉
2.1.2、修改权限
sudo chmod 777 /runsudo 
chmod 777 /var/log
如果没改，启动报错 IOError: [Errno 13] Permission denied: '/var/log/supervisord.log'
2.1.3、创建supervisor.sock
sudo touch /var/run/supervisor.sock
sudo chmod 777 /var/run/supervisor.sock
2.1.4、启动supervisord，注意stop之前的实例或杀死进程
supervisord
3、进入 /etc/supervisord.d/ 目录， 为项目创建一个 Supervisor 配置文件
  $ cd /etc/supervisord.d/
  $ vi FlaskApp.ini

配置文件为FlaskApp.ini

[program:app]
command=/usr/local/bin/python3/bin/gunicorn -w 4 -b 127.0.0.1:5000 -c guni.conf manage:app 

; 下面的路径请修改为你创建的项目的根目录
directory=/wxy/wxy_backstage

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

; 程序退出后自动重启,可选值：[unexpected,true,false]，默认为unexpected，表示进程意外杀死后才重启
autorestart=true
; 进程停止信号
stopsignal=QUIT
; 防止孤儿进程
stopasgroup=true
killasgroup=true

; 下面的用户请修改为创建该项目的用户
user=root
; 把stderr重定向到stdout，默认false
redirect_stderr=true

; log 文件的路径你可以重新自定义
stdout_logfile=/logs/FlaskApi/supervisor.log

; 解决编码问题
[supervisord]
environment=LC_ALL='en_US.UTF-8',LANG='en_US.UTF-8'

配置文件的简单说明

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信号，包括子进程

4、启动 Supervisor
$ supervisord -c /etc/supervisord.conf

    supervisorctl update   #更新配置
    supervisorctl reload   #重启
    supervisorctl status  #查看所有项目的情况
    supervisorctl stop/start/restart  项目名称

5、使用 service 命令管理 Supervisor 服务：

service supervisord start          # 启动 Supervisor 服务
service supervisord stop           # 停止 Supervisor 服务
service supervisord restart        # 重启 Supervisor 服务
service supervisord status         # 查看 Supervisor 服务状态

6、使用 systemctl 命令管理 Supervisor 服务：

    systemctl start supervisord   # 启动 Supervisor 服务
    systemctl stop supervisord    # 停止 Supervisor 服务
    systemctl restart supervisord # 重启 Supervisor 服务
    systemctl status supervisord  # 查看 Supervisor 服务状态
    systemctl enable supervisord  # 设置 Supervisor 服务开机自启动
    systemctl disable supervisord # 关闭 Supervisor 服务开机自启动