Flask项目Docker容器化部署原理与实现
本文将介绍Flask的部署方案:Flask + Nginx + uWSGI,并使用docker进行容器化部署,部署的实例来源 Flask开发初探,操作系统为ubuntu。
Flask系列文章:
部署方案
在开发时,我们使用flask run命令启动的开发服务器是werkzeug提供的,但是这种方式目的是为了开发,不能很好的扩展,不适合生产部署。生产部署,我们需要一个更强健,性能更高的WSGI服务器(关于WSGI,可参考WSGI到底是什么 ,常用的服务器有:uWSGI、Gunicorn等,本文以uWSGI举例。
像uWSGI这类WSGI服务器内置了Web服务器,所以我们不需要web服务器也可以与客户端交换数据,处理请求和响应,但是内置的web服务器不够强健,一般情况下都会使用一个常规的web服务器运行在前端,为WSGI服务器提供反向代理,web服务器选择Nginx,Nginx会把外部的请求转发给uWSGI处理,接收到响应后再返回给客户端,这样做的好处有:
- 提高静态文件的效率,因为Nginx处理静态文件的速度非常快
- 提升系统安全性,避免直接暴露WSGI服务器
- 提升程序处理能力,通过设置反向代理,配置负载均衡可以实现。
uWSGI配置
在使用uwsgi部署flask应用时,一定要记得将app.run()方法放在if __name__ == '__main__':
内部或者单独文件内,这样就可以保证其不会被调用,从而不会启动本地服务器。
uwsgi是一个服务器,使用前一定要安装:
pip install uwsgi
配置文件:
socket=/tmp/app.sock
chmod-socket=666
pidfile=/etc/nginx/uwsgi.pid
chdir=/home/**/mygithub/learn_flask/app
master=true
wsgi-file=serve.py
http=127.0.0.1:8005
callable=app
processes=8
threads=4
lazy-apps=true
对所配置的参数进行说明:
- callable:Flask项目的实例名称
- module:可调用对象的名称
- processes:开启多少个子进程处理请求。
- threads:每个进程的线程数
更多参数详情可见:uwsgi中文文档
在命令行中启动uwsgi服务器:
uwsgi --ini uwsgi.ini
在浏览器中输入 http://127.0.0.1:8005
,可以验证服务启动。
nginx配置
安装nginx:
apt-get install nginx
启动nginx:
service nginx start
重启
service nginx restart
nginx配置:
server{
listen 8080;
server_name localhost;
access_log /var/log/nginx/app_access.log;
error_log /var/log/nginx/app_error.log;
location / {
include uwsgi_params;
uwsgi_pass unix:/tmp/app.sock
}
}
nginx配置文件nginx.conf通过include引用了conf.d和site_enabled这两个文件夹中的配置文件,所以我们可将配置文件放在这两个路径任意一处。
重启nginx和uwsgi,在浏览器中输入 http://127.0.0.1:8088
,可以验证服务启动。
这样,就完成基础的nginx+uwsgi完成了Flask的部署。
容器化部署
接下来,介绍使用docker进行容器化部署。
docker配置
建议了解docker基本操作,首先,创建Dockerfile:
FROM ubuntu:16.04
RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo "Asia/Shanghai" > /etc/timezone
RUN apt update && apt install -y iputils-ping python3 python3-pip python3-tk libffi-dev libssl-dev
RUN apt install -y nginx && pip3 install uwsgi
ADD ['./', "/app"]
ADD ['./build', "/app"]
WORKDIR /app
RUN pip3 install -r requirements.txt
RUN chmod + x start_script.sh
CMD ['/start_script.sh']
注意:
- 该镜像的基础镜像为ubuntu:16.04,可自行docker pull
- 编写服务启动脚本start_script.sh
ln -s /app/nginx.conf /etc/nginx/conf.d/
nginx && uwsgi --ini uwsgi.ini
python3 serve.py
使用命令:
docker build -t image .
以上,就打包完成了镜像 (imagename),接下来执行docker run -d --name test imagename
启动容器,执行docker ps -a
可以看到刚才启动的容器,执行docker logs -f
可查看日志。
另外,推荐使用k8s对docker容器进行编排管理,具体使用后续博客介绍。
代码可参照:my github