使用docker搭建nginx，flask，gunicorn运行环境

时间 2016-07-23

1.简介

docker：非常流行的容器技术，本文是用其搭建ubuntu虚拟环境
nginx：高性能反向代理服务器
flask：微型web框架，可快速编写web应用
gunicorn: 异步处理框架

2.安装docker

在https://www.docker.com/products/docker上有各平台的docker安装方法，本文不再赘述。

3.启动ubuntu容器

启动docker后执行命令：

docker run -ti -p 80:80 -p 5000:5000 --name flask_nginx ubuntu:16.04 bash

其中80端口分配给nginx，5000端口分配给flask应用。

4.安装nginx，python相关包

进入容器后执行命令

apt-get update -y
apt-get install python3-pip python3-dev nginx vim -y
pip3 install gunicorn flask gevent

5.编写flask测试应用

创建目录/var/www/demo，创建文件myproject.py

mkdir /var/www/demo
cd /var/www/demo
vim myproject.py

创建flask应用

# -*- coding:utf-8 -*-

from flask import Flask
import time

app = Flask(__name__)

@app.route('/')
def index():
    time.sleep(0.01) # 模拟程序阻塞
    return 'hello world!'

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

启动应用

python3 myproject.py

打开http://127.0.0.1:5000，如果能看到 hello world!，证明实例应用已启动。

6.使用gunicorn启动flask应用，并将通讯绑定到myproject.sock上

按 Ctrl + c 停止flask应用，创建文件wsgi.py

vim wsgi.py

# -*- coding:utf-8 -*-

from myproject import app

if __name__ == "__main__":
    app.run()

执行命令

gunicorn --workers 3 --bind unix:myproject.sock --daemon -m 007 --user www-data --worker-class gevent wsgi:app

--worker-class 进行工作模式，默认是sync，会造成程序阻塞，这里使用gevent。
--workers 指定启动多少个进程，根据机器cpu核数来定。
--bind 指定通讯绑定到哪个.sock文件上。
--daemon 指定后台启动。
--user 指定用哪个用户启动这个进程，由于ubuntu采用apt-get安装的nginx默认启动用户是www-data，所以这里使用www-data，以免nginx没有权限访问.sock文件。
可使用top指令查看gunicorn程序启动情况：

如图所示，gunicorn启动了3个工作进程和1个主进程。从图中也可以看出docker容器只启动了必要的进程，对资源的占用非常小。

7.配置nginx配置文件，启动nginx

移除默认nginx配置文件，创建nginx配置文件myproject

rm -y /etc/nginx/sites-enabled/default
vim /etc/nginx/sites-available/myproject

server {
    listen 80;
    server_name server_domain_or_IP;

    location / {
        include proxy_params;
        proxy_pass http://unix:/var/www/demo/myproject.sock;
    }
}

链接到配置文件路径

ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled

启动nginx

nginx

打开http://127.0.0.1，如果能看到 hello world!，证明配置正确。

8.Dockerfile及docker image

如果上述文章没有描述清楚，请在https://github.com/zhanghongnian/docker_nginx_gunicorn_flask下载Dockerfile，自行build，
或者执行中dockr pull zhnliving/nginx_flask下载docker镜像，并运行
后台运行容器请执行docker run -d -p 80:80 zhnliving/nginx_flask
进入容器内部请执行docker run -ti -p 80:80 zhnliving/nginx_flask bash
欢迎加qq：453039449，一起学习。

9.参考

9.1.如何在ubuntu16.04上使用nginx和gunicorn部署flask应用
9.2.用gunicorn和gevent提高python-web框架的性能
9.3.使用gevent为IO繁忙型wsgi服务打个性能补丁