wxne1oafoacwxne1oafoac.jpg

部署 flask 项目的流程及要点

flask 一个使用 Python 编写的轻量级 Web 应用框架
gunicorn “绿色独角兽”是一个被广泛使用的高性能的 Python WSGI UNIX HTTP 服务器，移植自Ruby 的独角兽（Unicorn ）项目,使用 pre-fork worker 模式，具有使用非常简单，轻量级的资源消耗，以及高性能等特点。Gunicorn 服务器作为 wsgi app 的容器，能够与各种 Web 框架兼容（flask，django 等）,得益于 gevent 等技术，使用 Gunicorn 能够在基本不改变 wsgi app 代码的前提下，大幅度提高 wsgi app 的性能。
supervisord 是用 Python 开发的一个 client/server 服务，是 Linux/Unix 系统下的一个进程管理工具，不支持 Windows 系统。它可以很方便的监听、启动、停止、重启一个或多个进程。用Supervisor 管理的进程，当一个进程意外被杀死，supervisort 监听到进程死后，会自动将它重新拉起，很方便的做到进程自动恢复的功能，不再需要自己写 shell 脚本来控制。

gunicorn 作为项目的应用服务器， supervisord 作为管理进程的工具方便项目管理， nginx 作为web 服务器

用户访问域名 --> nginx --> 应用服务器 gunicorn <-- supervisord 负责管理

环境安装

- `nginx`、'MySQL' 以及 `supervisord` 为系统级别的环境，所以建议使用 root 用户安装。
- 建议使用 yum 安装，避免权限问题

安装 nginx

```
sudo rpm -Uvh http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm
sudo yum install -y nginx
# 启动Nginx并设置开机自动运行
sudo systemctl start nginx.service
sudo systemctl enable nginx.service
```

这样安装可以省掉很多麻烦，默认的配置文件位置 /etc/nginx/nginx.conf
需要修改配置建议新建 conf.d 文件夹, 将新的配置文件放置在 conf.d 目录下，在默认配置文件中增加 include /etc/nginx/conf.d/*.conf, 这样就可以很方便的配置与使用 nginx。
nginx 默认监听 80 端口，所以默认配置文件基本不用修改。访问 80 端口，自动转发到新配置的端口中。这样可以避免修改服务器的安全策略。
常用命令使用 yum 安装后的使用命令。如果是解压缩的方法需要重新配置

service nginx start
service nginx stop
service nginx reload

新增的配置文件示例：

    server {
        server_name 你的域名或公网ip;
        root 访问的首页地址，绝对路径;
        location = / {
        }
        location = /index.html {
        }
        location ^~ /static {
        }
        location /api/ {
                proxy_pass         http://127.0.0.1:端口;
                proxy_redirect     off;
                proxy_set_header   Host             $host;
                proxy_set_header   X-Real-IP        $remote_addr;
                proxy_set_header   X-Forwarded-For  $proxy_add_x_forwarded_for;
                proxy_set_header   X-Forwarded-Proto    $scheme;
        }
  }

安装 supervisor

建议 yum 安装，默认的配置文件位置 /etc/supervisord.conf
配置文件基本是不需要修改，只需在文件最后加上进程管理配置文件的位置。
进程管理的配置文件放到 /etc/supervisord.d/ 目录下即可
如果是别的方法安装可能会碰到各种各样的问题，包括需要修改配置，导入配置

yum install epel-release
yum install -y supervisor

常用命令

systemctl restart supervisord  # 启动默认加载的配置文件位置 /etc/supervisord.conf
systemctl start supervisord
systemctl stop supervisord
supervisorctl    # 后面不加参数，会进入到管理界面
supervisorctl stop program_name  # 停止某一个进程，program_name 为 [program:x] 里的 x
supervisorctl start program_name  # 启动某个进程
supervisorctl restart program_name  # 重启某个进程
supervisorctl stop groupworker:  # 结束所有属于名为 groupworker 这个分组的进程 (start，restart 同理)
supervisorctl stop groupworker:name1  # 结束 groupworker:name1 这个进程 (start，restart 同理)
supervisorctl stop all  # 停止全部进程，注：start、restartUnlinking stale socket /tmp/supervisor.sock、stop 都不会载入最新的配置文件
supervisorctl reload  # 载入最新的配置文件，停止原有进程并按新的配置启动、管理所有进程
supervisorctl update  # 根据最新的配置文件，启动新配置或有改动的进程，配置没有改动的进程不会受影响而重启

进程管理配置文件示例：

[program:进程名]
directory=项目位置
command = gunicorn -c gun.py app:app  # 启动项目命令
autostart=true
autorestart=true
stdout_logfile=日志文件名字.log
stdout_logfile_maxbytes = 5MB  ;
stdout_logfile_backups = 3     ;
redirect_stderr=true
stopsignal=QUIT
stopasgroup=true
killasgroup=true

安装 gunicorn

建议创建虚拟环境，在虚拟环境中使用命令安装项目所需要的包
安装具体所需的包
使用 gunrcorn 必须使用 .py 文件结尾的配置文件
配置文件示例：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

import os
from gevent import monkey
import multiprocessing

monkey.patch_all()

debug = True

bind = f"{ip}:{port}"
# 设置进程文件 '/var/run/*.pid'
pidfile = 'program.pid'
logfile = 'program.log'

# 设置日志级别
loglevel = 'debug'
# 设置访问日志和错误信息日志路径
accesslog = 'program.log'
errorlog = 'program.log'

#启动的进程数 cpu核心*2
workers = multiprocessing.cpu_count() * 2
# 工作模式协程 默认是sync 可以改成gevent
worker_class = 'gunicorn.workers.ggevent.GeventWorker'
# 设置最大并发量, 默认是1000
worker_connections = 2000

# 指定每个工作者的线程数，默认是1
threads = 2
# 设置守护进程，将进程交给supervisord管理
daemon = False
# 启动项目的用户及用户组
user = "username"
group = "groupname"
x_forwarded_for_header = 'X-FORWARDED-FOR'


# def main():
#     pass
#
#
# if __name__ == '__main__':
#     main()

部署

上传项目，使用非 root 用户，更改用户组到 nginx，这个可以自定义。

新增用户 useradd 用户名 -g 用户组 指定用户属于某个用户组。 -G 参数指定用户还属于哪个用户组
修改某个文件或者文件夹的所属用户或用户组

chown -R 用户.用户组文件或者文件夹

chown -R user.group file/

基本环境安装完成就结束了，修改相应的配置文件，启动 nginx, 启动 supervisord

关于日志

nginx 和 supervisord 的日志都在 /var/log/ 目录下。 nginx 需要进入 nginx 目录下，查看log 文件

MySQL用户授权，分配管理的表
- 创建用户
  - 使用 localhost 则为只能本机访问；若为 % 则允许所有 ip 连接。
  - 允许所有 ip 连接，不一定本机就可以连接。本机连接最好配置 localhost
    
    create user '新用户'@'localhost' identified by '密码';
- 为新用户授权
  - all 代表所有权限
  - 如果需要root远程连接访问, 则可以直接使用下面的语句，将指定 ip 改为 %
  grant all privileges on 数据库名.表名 to '新用户名'@'指定ip' identified by '新用户密码';
- 删除用户
  
  DROP USER username@localhost;
- 修改后刷新权限
  
  FLUSH PRIVILEGES;

微信公众号：

python爬虫Scrapy

666

使用-gunicorn-nginx-supervisor-部署-flask-项目