Docker Engine:应用打包工具,用于封装应用程序。
Docker Hub:用于管理云上容器应用程序的工具。
$ pip install flask
安装成功后,新建一个应用目录,命名为FlaskDemo。并在该目录下创建应用代码文件app.py。在app.py中,首先引入Flask模块,然后创建一个Web应用:
from flask import Flask
app = Flask(__name__)
然后定义路由/和其对应的请求处理程序:
@app.route("/")
def index():
return """
Python Flask in Docker!
Python Flask in Docker!
A sample web-app for running Flask inside Docker.
"""
最后,添加运行主程序并启动该脚本:
if __name__ == "__main__":
app.run(debug=True, host='0.0.0.0')
Copy
$ python app.py
然后在浏览器中访问http://localhost:5000/,可以看到Dockerzing Python app using Flask这样的页面。
![e3870e0f9c15c33ced04e4e7b37fc11d.png](https://i-blog.csdnimg.cn/blog_migrate/fce82dac81d56d088e3f14ad1d8b86c0.png)
Flask==1.0.2
接下来,需要将应用程序运行所需的所有Python文件都放在顶层文件夹中,例如,名为app的目录。同时建议将主入口程序命名为app.py ,将脚本中创建的Flask对象命名为app是一种通常的做法,这样也可以简化部署。
FlaskApp
├── requirements.txt
├── Dockerfile
└── app
└── app.py
└── <other .py files>
创建DockerfileDockerfile本质上是一个文本文件,其中明确定义了如何为我们的项目构建Docker镜像。接下来创建一个基于Ubuntu 16.04和Python 3.X的Dokcer镜像:
FROM ubuntu:16.04
MAINTAINER jhao104 "j_hao104@163.com"
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /requirements.txt
WORKDIR /
RUN pip3 install -r requirements.txt
COPY . /
ENTRYPOINT [ "python3" ]
CMD [ "app/app.py" ]
Dockerfile的基本指令有十三个,上面用到了部分。
FROM:所有Dockerfile的第一个指令都必须是FROM ,用于指定一个构建镜像的基础源镜像,如果本地没有就会从公共库中拉取,没有指定镜像的标签会使用默认的latest标签,如果需要在一个Dockerfile中构建多个镜像,可以使用多次。
MAINTAINER:描述镜像的创建者,名称和邮箱。
RUN:RUN命令是一个常用的命令,执行完成之后会成为一个新的镜像,通常用于运行安装任务从而向镜像中添加额外的内容。在这里,我们需更新包,安装python3和pip 。在第二个RUN命令中使用pip来安装requirements.txt文件中的所有包。
COPY:复制本机文件或目录,添加到指定的容器目录,本例中将requirements.txt复制到镜像中。
WORKDIR:为RUN、CMD、ENTRYPOINT指令配置工作目录。可以使用多个WORKDIR指令,后续参数如果是相对路径,则会基于之前命令指定的路径。
ENTRYPOINT:在启动容器的时候提供一个默认的命令项。
RUN:运行app目录中的app.py。
docker build -t docker-flask:0.1 .
调试模式运行根据前面讲到的容器化的优点,开发的应用程序通过容器部署,这从一开始就确保了应用程序构建的环境是干净的,从而消除了交付过程中的意外情况。但是呢,在开发应用程序的过程中,更重要的是要快速重新构建和测试,以检查验证过程中的每个中间步骤。为此,Web应用程序的开发人员需要依赖于Flask等框架提供的自动重启功能(Debug模式下,修改代码自动重启)。而这一功能也可以在容器中使用。为了启用自动重启,在启动Docker容器时将主机中的开发目录映射到容器中的app目录。这样Flask就可以监听主机中的文件变化(通过映射)来发现代码更改,并在检测到更改时自动重启应用程序。此外,还需要将应用程序的端口从容器转发到主机。这是为了能够让主机上的浏览器访问应用程序。因此,启动Docker容器时需要使用volume-mapping和port-forwarding选项:
docker run --name flask_app -v $PWD/app:/app -p 5000:5000 docker-flask:0.1
改命令将会执行以下操作:
基于之前构建的docker-flask镜像启动一个容器;
这个容器的名称被设置为flask_app 。如果没有——name选项,Docker将为容器生成一个名称。显式指定名称可以帮助我们定位容器(用来停止等操作);
-v选项将主机的app目录挂载到容器;
-p选项将容器的端口映射到主机。
![4f436155df31d0e8dd8461c9b5a48489.png](https://i-blog.csdnimg.cn/blog_migrate/4dd354e113de76901f9054e447233937.jpeg)
![fd134287bbe487adcfa875f5001bf8ac.gif](https://i-blog.csdnimg.cn/blog_migrate/20c48bf4d69f9536d3affd9d3a95a046.gif)
#!/bin/bash
if [ ! -f /debug0 ]; then
touch /debug0
while getopts 'hd:' flag; do
case "${flag}" in
h)
echo "options:"
echo "-h show brief help"
echo "-d debug mode, no nginx or uwsgi, direct start with 'python3 app/app.py'"
exit 0
;;
d)
touch /debug1
;;
*)
break
;;
esac
done
fi
if [ -e /debug1 ]; then
echo "Running app in debug mode!"
python3 app/app.py
else
echo "Running app in production mode!"
nginx && uwsgi --ini /app.ini
fi
Copy
然后创建uWSGI配置文件app.ini:
[uwsgi]
plugins = /usr/lib/uwsgi/plugins/python3
chdir = /app
module = app:app
uid = nginx
gid = nginx
socket = /run/uwsgiApp.sock
pidfile = /run/.pid
processes = 4
threads = 2
和Nginx配置文件nginx.conf:
user nginx;
worker_processes 4;
pid /run/nginx.pid;
events {
worker_connections 20000;
}
http {
include mime.types;
sendfile on;
keepalive_timeout 65;
gzip off;
server {
listen 80;
access_log off;
error_log off;
location / { try_files $uri @flaskApp; }
location @flaskApp {
include uwsgi_params;
uwsgi_pass unix:/run/uwsgiApp.sock;
}
}
}
最后,修改Dockerfile将Nginx和uWSGI安装到镜像,将配置文件复制到镜像中,并设置运行Nginx所需的用户权限:
FROM ubuntu:16.04
MAINTAINER jhao104 "j_hao104@163.com"
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev && \
apt-get install -y nginx uwsgi uwsgi-plugin-python3
COPY ./requirements.txt /requirements.txt
COPY ./nginx.conf /etc/nginx/nginx.conf
WORKDIR /
RUN pip3 install -r requirements.txt
COPY . /
RUN adduser --disabled-password --gecos '' nginx\
&& chown -R nginx:nginx /app \
&& chmod 777 /run/ -R \
&& chmod 777 /root/ -R
ENTRYPOINT [ "/bin/bash", "/entry-point.sh"]
然后重新打包镜像:
docker build -t docker-flask:0.1 .
然后使用Nginx启动应用程序:
docker run -d --name flaskapp --restart=always -p 8091:80 docker-flask:0.1
该镜像包含Python、Nginx、uWSGI完整环境,只需要在部署时指定端口映射便可以自动部署应用。要停止并删除此容器,请运行下面命令:
docker stop flaskapp && docker rm flaskapp
此外,如果我们仍然需要上面调试功能或修改部分代码,也可以像上面一样以调试模式运行容器:
docker run -it --name flaskapp -p 5000:5000 -v $PWD/app:/app docker-flask:0.1 -d debug
管理外部依赖
#!/bin/bash
if [ ! -f debug0 ]; then
touch debug0
if [ -e requirements_os.txt ]; then
apt-get install -y $(cat requirements_os.txt)
fi
if [-e requirements.txt ]; then
pip3 install -r requirements.txt
fi
while getopts 'hd:' flag; do
case "${flag}" in
h)
echo "options:"
echo "-h show brief help"
echo "-d debug mode, no nginx or uwsgi, direct start with 'python3 app/app.py'"
exit 0
;;
d)
touch debug1
;;
*)
break
;;
esac
done
fi
if [ -e debug1 ]; then
echo "Running app in debug mode!"
python3 app/app.py
else
echo "Running app in production mode!"
nginx && uwsgi --ini /app.ini
fi
这样我们可以在requirements_os.txt中指定将要安装的系统软件包名称,这些包名以空格分隔放在同一行。他们将和requirements.txt中的Python依赖库一样在应用程序启动之前安装。尽管这样对应用的迭代开发期间提供了便利,但是出于几个原因,在启动时安装依赖项不是一个好的实践:
它破坏了容器化的目标之一,即修复和测试由于部署环境的变化而不会改变的依赖关系;
增加了应用程序启动的额外开销,这将增加容器的启动时间;
每次启动应用程序时需要安装依赖项,这样对网络资源有要求。
![760097d920344ea97e0068865561579c.png](https://i-blog.csdnimg.cn/blog_migrate/1715eacbfa07aedd38d9996c4d20cbf9.jpeg)