为项目创建一个Docker镜像Dockerise A Project, since 2022-01-11

(2022.01.11 Tues, 2022.09.11 Sat修改)
Dockerise a project可分为下面若干步骤：

• 建立一个项目(本文以Python项目为例)
• 创建一个Dockerfile文件
• 执行Dockerfile文件创建镜像

假设我们已经拥有一个Python Flask项目。在flaskApp/路径下，有如下app.py文件

from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
    return "Hello World!"

if __name__ == "__main__":
    app.run(host='0.0.0.0')

创建一个Dockerfile文件

Dockerfile文件可以看成是生成Docker镜像的按顺序执行的一系列指令的集合。执行该文件即可生成镜像。每运行一行命令，就会在镜像上建立一层。
这是一个Dockerfile案例

FROM python:3.8-alpine
RUN mkdir /app
ADD . /app
WORKDIR /app
COPY . .
RUN pip install -r requirements.txt
CMD ["python", "app.py"]

指令说明：

• FROM python:3.7: 指出基础镜像，且必须存在该指令。如果没有基础镜像，可写成FROM scratch，同时接下来所写的指令将作为镜像的第一层开始。这个例子中的3.7相当于，如果没有指定则默认latest。
• RUN mkdir /app: 在构建docker容器时运行指定的命令。运行命令有两个种格式

RUN
RUN [command, para1, para2]

RUN命令的换行符是\。

注意，RUN pip install -r requirements.txt如果速度过慢，可能是安装源不在国内导致，可连接国内安装源以提速，比如

RUN pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

• COPY . .: 将本地项目文件夹的文件复制到容器中WORKDIR指定的文件夹内。复制完成后，项目的所有文件运行于WORKDIR指定的文件夹内，本例中为/app文件夹内。
• ADD . /app: 一个复制命令，类似于cp命令，在服务器和容器之间实现复制。其格式

ADD

可以是容器内的一个绝对路径，也是相对于工作目录的相对路径。
可以是本地文件或压缩文件，或一个URL。如果是URL，ADD相当于wget。如果是文件夹，则复制整个目录的内容，含文件系统元数据。

• WORKDIR /app: 设置工作目录，对Dockerfile中的命令有效，不存在就会创建，可多次设置。多次设置则在前一个次设置的基础上创建新目录。如

$ WORKDIR /a
$ WORKDIR b
$ WORKDIR c
$ RUN pwd

返回结果为/a/b/c/。
WORKDIR也可解析环境变量。

在本例中，镜像之外的文件位置是，比如/home/pn/app.py，而镜像复制了当前路径即/home/pn/的全部文件到镜像中的/app/路径中，且工作路径设置为/app(WORKDIR /app)，则app.py文件在镜像中的位置为/app/app.py，且运行镜像生成容器时，初始的路径是/app/。

• CMD ["python", "app.py"]: Docker启动时要运行的命令。三种格式

CMD ["executable", "param1", "param2"]
CMD ["param1", "param2"]
CMD command param1 param2

CMD命令中的各个部分需要用双引号标注"，如果使用单引号'将导致错误。

注意RUN和CMD的不同在于RUN是在构建docker文件时运行的命令，而CMD是在运行docker镜像时运行的命令。

其他命令

• COPY : 类似于ADD命令，但是只能是文件，其他用法和ADD一致。
• ENTRYPOINT: 启动时运行命令，其效果与CMD相似。差别在于1) ENTRYPOINT不会被运行的command覆盖，而CMD则会被覆盖；2) 如果我们在Dockerfile中同时写ENTRYPOINT和CMD，并且CMD不是一个完整的可执行命令，那么CMD指定的内容将会作为ENTRYPOINT的参数。比如

$ FROM ubuntu
$ ENTRYPOINT ["top", "-b"]
$ CMD ["-c"]

格式如下

ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2

• VOLUME: 实现挂载功能，可以将文件夹或者其他容器中的文件夹挂载到容器中。格式如下

VOLUME ["/var/log/"]
VOLUME /var/log
VOLUME /var/log /var/db #可挂载多个文件夹

使用场景为需要持久化存储数据时。容器使用的是AUFS，这种文件系统不能持久化数据，当容器关闭后，所有的更改都会丢失，当数据需要持久化时用这个命令。

• USER: 设置启动容器的用户，用户名或UID，

USER daemon #?
USER 

执行Dockerfile文件生成镜像

docker build -t .

在Dockerfile的同文件夹下，以上面这种格式生成镜像文件，镜像名为，命令最后一部分用于告诉系统从哪个路径开始建立镜像。

执行上面命令之后，通过docker images即可查看。在通过下面指令生成

docker run -p 8000:5000 -it

其中-p 8000:5000代表了容器内的端口5000对应了容器外的8000端口。-it代表了以交互模式运行。

Reference

1 Dockerfile命令详解 (超全版本)