signed

QiShunwang

“诚信为本、客户至上”

Flask 项目部署(Docker + Flask + uwsgi + Nginx)

2021/5/14 21:42:18   来源:

文章目录

  • 一、项目背景
  • 二、项目部署
    • 2.1 项目基础环境
    • 2.2 获得 Python 环境的所需依赖
    • 2.3 配置 gunicorn
    • 2.4 编写 Dockerfile
    • 2.5 编写 docker-compose (选用)
    • 2.6 Docker 构建镜像,并且运行
    • 2.7 nginx 反向代理
  • 三、总结

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

参考资料:

  1. Flask后端:Docker+Gunicorn+Nginx部署
  2. 一个 Unix 上可以用的 uwsgi Server 服务器
  3. gunicorn 配置详解
  4. Flask + gunicorn + nginx 部署参考

一、项目背景

近期参加比赛,原本 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<aaax@xx.com>" 
# 配置工作目录
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 反向代理配置