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: ""
 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

完毕！