Docker + Flask + gunicorn + Nginx 部署项目

Author：Gorit
Date：2021/5/14
2021年发表博文： 18/50

一、项目背景

近期参加比赛，原本 windows server 部署的 Flask 后端项目所用的服务器快要过期了，开始改用 Linux 服务器部署。

写过 Flask 项目的同学都知道, Flask 内置的 WSGI 服务器，只适合开发调试使用，但是如果要部署在生产环境，性能是完全不够用的。

Flask app 和 用户交互流程如下：

Flask app（web 应用） <—> uWSGI （实现了 uwsgi 协议的 web 服务器，可以实现 uwsgi 协议 与 http 协议的相互转化）<-> Nginx（高性能的 http 服务器）

所以，经过查阅网上已有的方案 + 自己的实践，找到了一套可用性比较高的部署方案，于是将本次的实践记录下来，以备日后所需。最终我哦采用的部署方案为

flask + gunicorn + Nginx

二、项目部署

基础的知识就不补充了，但是我会在关键命令写注释

2.1 项目基础环境

以下环境及基础操作，默认大家是会的，毕竟已经安装完成

1. Linux 云服务器（CentOS7 环境） 阿里云，腾讯云均可
2. Nginx （高性能的 HTTP服务器）
3. Docker + Docker Compose（容器编排）
4. Flask app（Python 环境由 Docker 提供）
5. SSL 证书配置（需要用到反向代理 HTTPS）

2.2 获得 Python 环境的所需依赖

在你的 Flask 项目根目录中，输入如下命令

pip freeze > requirement.txt

过一会，就能在当前目录看到一个名为 requirement.txt 的文档

当然，我们还需要另外两个依赖，现在可以先不管，在 Docker 里面安装即可。

1. gunicorn
2. gevent

在这里，我们以一个 Python 单页面应用为示例，命名为 app.py

from flask import Flask
app = Flask(__name__)

@app.route('/')
def index():
    return 'hello world'

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=80)

OK, 到这步，Python 基础环境搭建完毕

2.3 配置 gunicorn

创建 gun.conf 文件

# 并行工作进程数
workers = 2
# 指定每个工作者的线程数
threads = 4
# 监听内网端口80
bind = '0.0.0.0:80'
# 工作模式协程
worker_class = 'gevent'
# 设置最大并发量
worker_connections = 2000
# 设置进程文件目录
pidfile = 'gunicorn.pid'
# 设置访问日志和错误信息日志路径
accesslog = 'gunicorn_acess.log'
errorlog  = 'gunicorn_error.log'
# 设置日志记录水平
loglevel = 'info'
# 代码发生变化是否自动重启
reload=True

2.4 编写 Dockerfile

编写 Dockerfile 内容如下：

# 镜像环境，我们要 python 3.8.0
FROM python:3.8.0  
# 这句话可有可无，标识你是编写这个 Dockerfile 的作者信息
MAINTAINER "code<[e-mail]>" 
# 配置工作目录
WORKDIR /code  

# 拷贝当前目录所有的文件，进入 docker 镜像中
COPY . .

# 执行安装 Python 环境依赖
RUN pip install -i https://pypi.tuna.tsinghua.edu.cn/simple gunicorn gevent
RUN pip install -i https://pypi.tuna.tsinghua.edu.cn/simple flask

# 暴露 80 端口，给外部使用，因为上面我们开启的是 80 端口
EXPOSE 80

# 使用 gunicorn 运行 Flask 项目，最后一个命令： app:app  前者对应的是flask 启动 文件，后面不要乱改
CMD gunicorn  -c gun.conf app:app

2.5 编写 docker-compose （选用）

docker-compose 只不过是让项目部署的更加优雅一点，实际和 Docker 创建容器，运行是一样的

version: "3"
services:
  flask_test:
    image: flask-test:2.0 # 生成的镜像的名称 和 tag
    build: . # 一键构建镜像  =================  以上为构建命令，以下为运行命令
    restart: always # 总是重启
    container_name: flask_v2 # 运行后的容器的名称
    ports:
      - "5500:80" # 端口映射， 这里是将 docker 容器内的 80 端口映射到云服务器的 5500 端口

运行项目

docker-compose up -d # 运行项目，并且后台执行
docker-compose ps # 查看当前目录下 docker-composse 的运行状态

2.6 Docker 构建镜像，并且运行

上面的 docker-compose 对应的 docker 构建镜像命令如下

docker build -t flask-test:2.0 .  # 构建镜像
# 查看构建好的镜像
docker images

# 运行容器
docker run -d -p 5500:80 --name flask_v2 --restart=always 需要运行的IMAGE ID

2.7 nginx 反向代理

    upstream test {
        server 127.0.0.1:5500;
    }
    server {
        listen       443 ssl http2 default_server;
        listen       [::]:443 ssl http2 default_server;
        server_name  服务器域名;
        root         443 端口默认静态文件;

        ssl_certificate "你的整数 pem";
        ssl_certificate_key "你的整数key";
        ssl_session_cache shared:SSL:1m;
        ssl_session_timeout  10m;
        ssl_ciphers HIGH:!aNULL:!MD5;
        ssl_prefer_server_ciphers on;

        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;

        location / {
        }
	
		location /flask {
                proxy_pass http://test/;
        }

        error_page 404 /404.html;
        location = /404.html {
        }

        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
        }
    }

大功告成

三、总结

1. Docker + Nginx + gunicorn 部署项目
2. docker 与 docker-compose 运用
3. Nginx 反向代理配置