部署 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 负责管理
环境安装
代码语言:javascript复制- `nginx`、'MySQL' 以及 `supervisord` 为系统级别的环境,所以建议使用 root 用户安装。
- 建议使用 yum 安装,避免权限问题
安装 nginx
代码语言:javascript复制```
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 安装后的使用命令。如果是解压缩的方法需要重新配置
代码语言:javascript复制service nginx start
service nginx stop
service nginx reload
新增的配置文件示例:
代码语言:javascript复制 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/
目录下即可
如果是别的方法安装可能会碰到各种各样的问题,包括需要修改配置,导入配置
代码语言:javascript复制yum install epel-release
yum install -y supervisor
常用命令
代码语言:javascript复制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 # 根据最新的配置文件,启动新配置或有改动的进程,配置没有改动的进程不会受影响而重启
进程管理配置文件示例:
代码语言:javascript复制[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
文件结尾的配置文件。
配置文件示例:
代码语言:javascript复制#!/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()
代码语言:javascript复制
## 部署
上传项目,使用非 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; `