Flask 项目部署（Docker + Flask + uwsgi + Nginx）

文章目录

一、项目背景
二、项目部署
- 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

参考资料：

Flask后端：Docker Gunicorn Nginx部署
一个 Unix 上可以用的 uwsgi Server 服务器
gunicorn 配置详解
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 项目基础环境

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

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

2.2 获得 Python 环境的所需依赖

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

pip freeze > requirement.txt

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

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

gunicorn
gevent

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

代码语言：javascript复制

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 文件

代码语言：javascript复制

# 并行工作进程数
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 内容如下：

代码语言：javascript复制

# 镜像环境，我们要 python 3.8.0
FROM python:3.8.0  
# 这句话可有可无，标识你是编写这个 Dockerfile 的作者信息
MAINTAINER "code" 
# 配置工作目录
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 创建容器，运行是一样的

代码语言：javascript复制

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

运行项目

代码语言：javascript复制

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

2.6 Docker 构建镜像，并且运行

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

代码语言：javascript复制

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

代码语言：javascript复制

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

2.7 nginx 反向代理

代码语言：javascript复制

    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 {
        }
    }

大功告成

三、总结

Docker Nginx gunicorn 部署项目
docker 与 docker-compose 运用
Nginx 反向代理配置

flask 容器 python 网络安全

0 人点赞