Flask + Docker 无脑部署新手教程

胡祖俊2024-05-072024-09-26

（收藏数远远大于点赞数，嘤嘤嘤）

最近一个朋友在一直微信问我怎么部署flask。

这种情况我有经验：“google 啥都有，搜 flask 部署去”

朋友：“完全看不懂”

我直觉想反驳，可是想到当初我学部署的时候也一头雾水肝几天也没搞明白（当时是计算机网络、linux、python一窍不通），就理解了。其实在docker流行的今天，部署已经要比当初我学的时候要方便得多，但是前段时间我google搜了一圈的确没看到几篇比较好的 Docker + Flask 的指导，于是写一篇菜鸟也能看懂的新手教程。

本教程的特点就是比较无脑，照着做就能部署成功。与其部署之前学一堆看不懂的，不如直接部署了找感觉。同时给出一些链接，想深入一点了解的可以自行深入学习。

基础介绍

Flask ：python最流行的两个框架之一（django、flask），轻量级是最大的特点
Gunicorn：只熟悉熟悉用 java 或者 PHP 做开发的可能对 python 的部署一开始不太理解，Flask应用是一个符合WSGI规范的Python应用，不能独立运行（类似app.run的方式仅适合开发模式），需要依赖其他的组件提供服务器功能。
gevent：gunicorn 默认使用同步阻塞的网络模型(-k sync)，对于大并发的访问可能表现不够好，我们很方便地顺手套一个gevent来增加并发量
Docker：容器，可以理解成一个“黑盒”。在项目变得庞大以后，往往我们会疲于管理整个项目的部署和维护。如果我们将整个项目用一个“容器”装起来，那么我们仅仅只用维护一个配置文件告诉计算机每次部署要把什么东西装进“容器”，甚至借用一些工具把这个过程自动化，部署就会变得很方便。这也是为什么我写这篇文章的原因

整个架构如图所示：

具体操作

下面我们首先在自己电脑就可以运行，不用登陆服务器终端

以小学期的一个 web 项目为例，我们的项目架构是这样的：

我们先看根目录下的 start.py，这是项目的启动文件：

#start.py
from project import create_app #从project文件夹中的__init__.py中导入create_app函数

app = create_app() #记住这里的变量名app

if __name__ == '__main__':
    app.run(debug=True)

其中，我们 project 里面的 flask 项目用了 blueprint 的方式去构建，所以我们用了init.py 来定义这个flask项目，这里相当于将 web 项目用文件夹“封装”了起来，部署的内容只和文件夹里面有关。

不过可能更常见的新手教程里面的是这个样式：

#start.py
from flask import Flask

app = Flask(__name__) #记住这里的变量名app

@app.route('/')
def hello():
    return 'hello docker&flask'

if __name__ == '__main__':
    app.run(debug=True)

用哪种都无所谓，如果没接触过蓝图直接用第二种常规的方式即可（注意如果用第二种方式，几个用来部署的文件和 Flask 项目应是同级文件夹的。

一旦使用命令python start.py运行这个应用，打开浏览器，输入网址127.0.0.1:5000并回车，将会打开我们的网站。

但是这样简单运行的话，只要按一下 ctrl + c 终止运行，或者关掉终端，网站就连接不了了，我们要寻求更长久的真正的部署。

Gunicorn + Gevent

运行以下命令即可安装这两个利器

1	pip install gunicorn gevent

在根目录下新建文件 /gunicorn.conf.py

1
2
3

workers = 5    # 定义同时开启的处理请求的进程数量，根据网站流量适当调整
worker_class = "gevent"   # 采用gevent库，支持异步处理请求，提高吞吐量
bind = "0.0.0.0:80"

可以使用gunicorn命令来测试是否可以正确运行，命令如下，打开网址127.0.0.1:80，将会打开我们的网站。

1	gunicorn start:app -c gunicorn.conf.py

一旦报错，则根据错误提示修复即可。

使用 Docker 封装 Flask 应用

当然第一步先安装 docker。

下面我们将项目用 docker 包装好，以便扔到服务器上直接跑（学生党可以买阿里云或者腾讯云，均有学生优惠）。

首先我们需要为该应用创建一个 requirements.txt 文件，以便容器里面 python 环境的安装：/requirements.txt

gunicorn
gevent
flask
# ...以下替换成项目需要安装的所有 python 库，如 flask-wtf，flask-login...whatever

requirements.txt 是做 python 项目常写的一个文件，有了这个文件，在安装 python 应用依赖的三方包时，可以直接用如下命令执行：

1	pip install -r requirements.txt

当然我们这里先不用执行。

然后我们还要创建一个 Dockerfile 文件，以便 Docker 镜像的构建：/Dockerfile

FROM python:3.6
WORKDIR /Project/demo

COPY requirements.txt ./
RUN pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

COPY . .

CMD ["gunicorn", "start:app", "-c", "./gunicorn.conf.py"]