后端部署笔记nginx+gunicorn+supervisor+flask

后端部署笔记nginx+gunicorn+supervisor+flask

1. flask 是一个python的微观web框架。简洁高效，使用简单。

2. 生产环境下，flask自带的服务器，无法满足性能要求。Gunicorn是一个开源python WSGI UNIX的HTTP 服务器。配置简单，高性能。

   Note:

   ​ WSGI协议

   ​ Web框架致力于如何生成HTML代码，而Web服务器用于处理和响应HTTP请求。Web框架和Web服 务器之间的通信，需要一套双方都遵守的接口协议。WSGI协议就是用来统一这两者的接口的。

   ​ flask就是一种优秀的Web框架，gunicorn就是web服务器。两者配合组成了web后端服务。

3. supervisor 是一个用python写的进程管理工具，可以很方便的用来启动、重启、关闭进程（不仅仅是python进程）。除了对单个进程控制，还可以同时启动、关闭多个进程，比如很不幸的服务器出问题导致所有应用程序都被杀死，此时可以用supervisor同时启动所有应用程序而不是一个一个地敲命令启动。

   想要结束gunicorn只需要执行pkill gunicorn，有时候还要ps -ef找到pid进程号才能kill。过于繁琐。因此使用supervisor可以更加方便的管理wsgi容器gunicorn。

4. nginx是专业的服务器，可以做负载均衡，拦截静态请求，访问控制，限速，限制连接数，反向代理，抗并发。

下面进入配置环节

1. 安装python环境，创建flask的虚拟环境与安装supervisor的python2环境

2. 将flask代码放置在合适的位置

3. 在flask的虚拟环境中安装gunicorn

   pip install gunicorn

4. gunicorn 启动flask可以使用如下命令：

   gunicron -w 4 -b 127.0.0.1:8000 -k gevent myapp:app

​ -w 表示开启多少个worker

​ -b 表示gunicorn开放的访问地址

​ -k gevent 表示以异步的方式启动

​ myapp表示flask项目中app文件的文件名

​ 我们不直接使用gunicorn启动，使用supervisor管理gunicorn

5. 切换到python2环境 ( supervisor不支持python3 )

pip install supervisor

// 找到合适的放配置文件的目录 如/etc/supervisor/下

echo_supervisord_conf > supervisor.conf # 生成supervisor默认配置文件

makedir conf.d # 创建存放app conf文件的目录

vim supevisor.conf

未避免产生非root用户的权限错误，将supervisord.conf内[unix_http_server] 这项改为（;是注释）：

[unix_http_server]
file=/tmp/supervisor.sock   ; (the path to the socket file)
chmod=0766                 ; socket file mode (default 0700)
;chown=nobody:nogroup       ; socket file uid:gid owner
;username=user              ; (default is no username (open server))
;password=123               ; (default is no password (open server))

cp supervisord_conf conf.d/ # app 的conf 文件可以从默认配置文件上更改

vim supervisor.conf # 再次修改配置文件

再将末尾的[include]部分改为：

[include]
files = /etc/supervisor/*.conf
files = /etc/supervisor/conf.d/*.conf

这样方便为每个app单独设置conf文件而不必全部写在全局设置里面。

在conf.d下将刚才复制过来的配置文件重命名为你app的名字

mv supervisor.conf myapp.conf

vim myapp.conf

在文件末尾添加如下配置

[program:gunicorn]
command=/home/dlf/anaconda3/envs/pdns/bin/gunicorn -w 4 -b 127.0.0.1:3000 -k gevent app:app                                                         ; supervisor启动命令
directory=/home/dlf/project/pdns_api                            ; 项目的文件夹路径
startsecs=5                                                     ; 启动时间
stopwaitsecs=0                                                  ; 终止等待时间
autostart=false                                                 ; 是否自动启动
autorestart=true                                                ; 是否自动重启
startretries = 3                                                ; 启动失败自动重试次数
stopasgroup=true                        ; send stop signal to the UNIX process
killasgroup=true                        ; SIGKILL the UNIX process group (def false)
stdout_logfile=/home/dlf/apps/var/www/server/log/gunicorn.log   ; log 日志
stderr_logfile=/home/dlf/apps/var/www/server/log/gunicorn.err

进行启动操作：
在创建的python2虚拟环境下

通过配置文件启动supervisor
supervisord -c supervisor.conf

查看supervisor的状态
supervisorctl -c supervisor.conf status

修改配置文件后，重新载入配置文件
supervisorctl -c supervisor.conf reload

启动指定/所有 supervisor管理的程序进程
supervisorctl -c supervisor.conf start [all]|[appname]

关闭指定/所有 supervisor管理的程序进程
supervisorctl -c supervisor.conf stop [all]|[appname]

其中appname就是上述配置中program:后面的字段 如gunicorn

6. 我们启动的服务绑定的是内网地址，用nginx 做反向代理，同时增加整个后端的并发能力

   • 安装nginx(不在python虚拟环境下)

     sudo apt-get install nginx

   • 编辑配置文件 /etc/nginx/conf.d/gunicorn.conf

     server {
         listen 8000;
         server_name example.org; # 这是HOST机器的外部域名，用地址也行
     
         location / {
             proxy_pass http://127.0.0.1:30000; # 这里是指向 gunicorn host 的服务地址
             proxy_read_timeout 300;            # nginx会等待多长时间来获得请求的响应
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         }
     }
     

   • nginx 启动测试

     测试配置的是否正确
     sudo service nginx -t

     重启nginx服务
     sudo service nginx restart

     如果有正在运行的nginx服务，可以使用平滑重启
     sudo service nginx reload

refer: 搜了很多资料，没有保存搜索时的链接。如侵权，请联系我，进行删除。