flask+uwsgi+nginx+docker-compose部署

• 简单介绍

Flask这里就不多阐述了，已经是很流行的一个轻量级python框架了，对于小、中型项目特别适合。这里用docker的compose编排部署.
uwsgi 简单的说明下，uWSGI是一个Web服务器，它实现了WSGI协议、uwsgi、http等协议。

Nginx中HttpUwsgiModule的作用是与uWSGI服务器进行交换。

WSGI是一种Web服务器网关接口。它是一个Web服务器（如nginx，uWSGI等服务器）与web应用（如用Flask框架写的程序）通信的一种规范。

这是官方说法，大概还是看具体例子能够说明一切，https://www.runoob.com/python3/python-uwsgi.html（这里是http方式），另外一种是socket方式，

下面附一张图来说明

现在大部分web服务器（如nginx）支持uwsgi， socket是最高效的一种网络通信方式，socket通信速度会比http快

uwsgi.ini的配置说明：

http-socket=:5000//配置uwsgi监听的socket(ip+端口）
callable=app//uwsgi调用的python应用实例名称,Flask里默认是app,根据具体项目代码实例命名来设置
wsgi-file=server.py//调用的主程序文件，绝对路径或相对于该ini文件位置的相对路径均可
master=true//以独立守护进程运行
processes=8//配置进程数量
threads=4//配置线程数量
enable-threads=true//允许在请求中开启新线程
stats=127.0.0.1:9191//返回一个json串，显示各进程和worker的状态
pidfile=uwsgi.pid//存放uwsgi进程的pid，便于重启和关闭操作
listen=1024//监听队列长度，默认100，设置大于100的值时，需要先调整系统参数
chdir = /project  //指定项目目录为主目录
daemonize=uwsgi.daemonize.log//以守护进程运行，日志文件路径
memory-report=true//启用内存报告，报告占用的内存
buffer-size=65535//设置请求的最大大小 (排除request-body)，这一般映射到请求头的大小。默认情况下，它是4k，大cookies的情况下需要加大该配置

docker-compose的一些常用操作

docker-compose up -d nginx                     构建建启动nignx容器

docker-compose exec nginx bash            登录到nginx容器中

docker-compose down                              删除所有nginx容器,镜像

docker-compose ps                                   显示所有容器

docker-compose restart nginx                   重新启动nginx容器

docker-compose run --no-deps --rm php-fpm php -v  在php-fpm中不启动关联容器，并容器执行php -v 执行完成后删除容器

docker-compose build nginx                     构建镜像 。        

docker-compose build --no-cache nginx   不带缓存的构建。

docker-compose logs  nginx                     查看nginx的日志 

docker-compose logs -f nginx                   查看nginx的实时日志

docker-compose config  -q                        验证（docker-compose.yml）文件配置，当配置正确时，不输出任何内容，当文件配置错误，输出错误信息。 

docker-compose events --json nginx       以json的形式输出nginx的docker日志

docker-compose pause nginx                 暂停nignx容器

docker-compose unpause nginx             恢复ningx容器

docker-compose rm nginx                       删除容器（删除前必须关闭容器）

docker-compose stop nginx                    停止nignx容器

docker-compose start nginx                    启动nignx容器

• 正式部署

1. 先看下目录

　　　　创建文件夹mkdir docker-flask

            创建文件docker-compose.yml nginx.conf  文件夹webapp

             cd webapp里面创建文件Dockerfile app.py requirements.txt uwsgi.ini

　　　　文件内容依次如下：

　　　　docker-compose.yml　

　　　　

version: "2"
services:
    webapp:
        build: ./webapp  #webapp目录地址，当前文件夹
        container_name: webapp  #容器名称
    nginx:
        image: nginx  #需要nginx镜像，所以最好在本地事先生成一个nginx镜像
        volumes:
            - ./nginx.conf:/etc/nginx/conf.d/default.conf  #做配置映射
        depends_on:
            - webapp   #依赖webapp
        ports:
            - "8888:80"

编排服务的其实就是将多个分别的服务关联到一起启动，可以事先对每个服务先做下单独的运行，都成功的话，在配置的docker-compose里面。

　　　　nginx.conf　　   

server {
    listen 80;
    server_name 0.0.0.0; 
    location / {
        include uwsgi_params;
        uwsgi_pass webapp:8002; 
    }
}

　　　　webapp文件夹里的文件内容

　　　　Dockerfile

FROM python:3.5
ENV TZ=Asia/Shanghai
RUN mkdir /webapp
WORKDIR /webapp  #指定工作目录
COPY . /webapp

RUN pip install -i https://pypi.doubanio.com/simple/  --trusted-host pypi.doubanio.com -r requirements.txt #这里用国内信任的豆瓣源，速度比较快

CMD ["uwsgi", "--ini", "/webapp/uwsgi.ini"] #初始化的启动操作

　　　　app.py

#!/usr/bin/env python
#coding=utf-8

from flask import Flask,render_template_string

app = Flask(__name__)

@app.route("/")
def index():
        return render_template_string('<h1>Hello Flask</h1>')

if __name__ == "__main__":
    app.run(debug=True,host='127.0.0.1',port=5000) #这里是用python app.py启动的设置，如果用uwsgi这种，可以无需关注 

　　　　requirements.txt

Flask
uwsgi

　　　　uwsgi.ini　　

[uwsgi]
module = app:app #目录.文件:app对象
#callable = app #或者这么设置
master = true
processes = 4
chdir = /webapp #指定运行目录
socket = :8002  #监听端口
chmod-socket = 666
logto = /webapp/app.log
vacuum = true

　2、都配置完成后，在docker-flask目录下执行

　　docker-compose up  或者 docker-compose up -d 后台运行

      docker ps 查看运行的容器

　　docker-compose ps 查看运行的服务

　3、如果没什么问题的话在浏览器直接输入 127.0.0.1:8888就会看到

　　Hello Flask

完毕！