Flask + Gunicorn + Supervisor 简易部署 web 应用

先交代背景:

  • Vultr 服务器
  • Ubuntu 16.04 系统
  • Python 3.5.2 版本
  • gunicorn (19.7.1)

安装所需的包

因为这一版本的 Ubuntu 系统自带了 Python 3.5.2,所以就不需要安装 Python 了。但是 pip 还是要自己手动安装的:

apt install python3-pip

注意: python3-pip 才是给 Python3 安装 pip 的,否则会给系统里的 Python2.7 安装。

这时 pip 可能版本较低,还缺少 setuptools 这个包,影响其他包的安装,我们把 pip 升级下,再把包装上:

pip3 install --upgrade pip
pip3 install setuptools 

然后安装 Flask:

pip3 install flask

安装 gunicorn:

apt install gunicorn

安装 gunicorn 的 python 相关的包:

pip3 install gunicorn

安装 supervisor:

apt install supervisor

基本的环境就准备好了。




用 gunicorn 启动 flask 项目

因为我使用的是 root 用户来操作,所以直接就在 /root 目录创建一个新目录来放置我们的 flask 项目文件:

mkdir myproject

进入 myproject 目录,并新建 myapp.py 文件:

cd myproject
touch myapp.py

用 vim 编辑 myapp.py 文件:

vim myapp.py

写入一个最简单的 flask 程序:

from flask import Flask

app = Flask(__name__)

@app.route('/')
def index():
    return 'hello world'
if __name__ == '__main__':
    app.debug = True
    app.run()

启动 flask 程序:

python3 myapp.py

因为我的服务器没有绑定域名,这时候要在浏览器打开我们的服务器的 IP 地址在加上 flask 默认的端口号 5000(如:http://111.11.111.111:5000/),就能看到喜闻乐见的 “hello world!”了(可能需要等待较长时间)。

但 flask 自带的这个服务器功能非常弱,仅供开发调试时候使用,我们需要一个高效能的服务器 Gunicorn 来运行我们的 flask 项目。

在 myproject 目录执行以下命令:

/usr/local/bin/gunicorn -w 4 -b 0.0.0.0:5000 myapp:app
  • /usr/local/bin/gunicorn: gunicorn 的安装路径,如果是在虚拟环境中运行的话该路径需要适当修改。

  • -w 4 : workers ,是开的进程数量

  • -b 0.0.0.0:5000: bind,绑定 IP 和端口,0.0.0.0 让公网能够访问。

执行上诉命令后,我们的 hello world 页面就能通过 gunicorn 工作了。

提示:如果搞不清楚, gunicorn 的安装路径,可用 find / -name 'gunicorn' 命令查找。




用 supervisor 管理进程

supervisor 默认的配置文件是放在 /etc/supervisor 路径中的,里面会有一个默认配置文件 supervisord.conf 和一个文件夹 conf.d,该文件夹用来放置单独某个进程的配置文件。

打开 supervisord.conf 我们只看最下面一行:

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

这里定义了 supervisor 会读取 /etc/supervisor/conf.d/ 路径下的 conf 格式的配置文件。

我们进入 conf.d 路径,并新建一个配置文件 myapp.conf

cd conf.d
touch myapp.conf

编辑 myapp.conf 写入以下配置:

[program:myapp]
command=/usr/local/bin/gunicorn -w 4 -b 0.0.0.0:5000 myapp:app
directory=/root/myproject
autostart=true
autorestart=true  
  • command:启动命令,和上例启动 gunicorn 命令是一样的
  • directory:程序的启动目录,也就是 myapp.py 放在哪
  • autostart:自动开启
  • autorestart:进程挂了之后自动重启

现在就可以通过 supervisor 来管理 gunicorn 并运行 flask 项目了。

使用 supervisorctl 命令进入 supervisor 管理界面,首先更新配置:

> update

因为我们设置了自动启动,这时候项目已经启动了,hello world 页面能够正常工作了。

supervisor 还有以下常用命令:

> status    # 查看程序状态
> stop usercenter   # 关闭 usercenter 程序
> start usercenter  # 启动 usercenter 程序
> restart usercenter    # 重启 usercenter 程序
> reread    # 读取有更新(增加)的配置文件,不会启动新添加的程序
> update    # 重启配置文件修改过的程序

你可能感兴趣的:(Flask + Gunicorn + Supervisor 简易部署 web 应用)