3.6dockerfile语法梳理及最佳实践

在本节中，我们对常用的Dockerfile语法进行梳理。

FROM

FROM scratch # 制作base image
FROM centos     # 使用base image

注意：尽量使用官方的image作为base image

LABEL

LABEL maintainer="[e-mail]"        # 镜像作者
LABEL version="1.0"                        # 镜像版本
LABEL description="this is description"    # 镜像描述

建议：Metadata不可少

ENV

ENV MYSQL_VERSION 5.6
RUN apt-get install -y mysql-server="&{MYSQL_VERSION}" \
    && rm -rf/var/lib/apt/lists/*    # 引用常量

建议：尽量使用ENV增加可维护性

WORKDIR

WORKDIR /root # 用于切换文件夹，如果没有会自动创建root目录

强制：用WORKDIR ，不要使用RUN cd

建议：为了清晰，尽量使用绝对目录

ADD and COPY

ADD hello /            # 添加hello文件到根目录
ADD hello test/     # 添加hello文件到test目录
ADD test.tar.gz /     # 添加到根目录并解压

COPY hello /        # 添加hello文件到根目录

注意：大部分情况，copy优于ADD

注意：ADD除了COPY还有额外功能（解压）

提示：添加远程文件/目录请使用crul或者wget

RUN

执行命令并创建新的Image Layer

RUN yum update \
    && yum install -y vim python-dev    # 反斜线换行

RUN apt-get update \
    && apt-get install -y perl pwgen --no-install-ecommends
    && rm -rf /var/lib/apt/lists/*        # 注意清理缓存

建议一：为了美观，复杂的RUN请使用反斜线换行

建议二：每运行一次RUN，image都会新建一层，为了避免无用分层，合并多条命令成一行

CMD

CMD：设置容器启动后默认执行的命令和参数

FROM centos
CMD echo "hello Docker"

注意一：如果docker run指定了其他命令，CMD命令被忽略。

docker run -it moluo/hello-cmd /bin/bash     # 将不会执行CMD打印hello Docker

注意二：如果定义了多个CMD，只有最后一个会执行

FROM centos
CMD echo "hello world"                        # CMD echo "hello world"将不会执行
CMD echo "hello Docker"

ENTRYPOINT

ENTRYPOINT：设置容器启动时运行的命令

让容器以应用程序或者服务的形式运行

不会被忽略，一定会执行

COPY docker-entrypoint.sh /user/local/bin/
ENTRYPOINT ["docker-entrypoint.sh"]
EXPOSE 27017
CMD ["mongod"]

VOLUME and EXPOSE

储存和网络

后期补充

Shell格式和Exec格式

Shell格式

RUN apt-get install -y vim
CMD echo "hello docker"
ENTRYPOINT echo "hello docker"

Exec格式

RUN [ "apt-get","install","-y","vim"]
CMD ["/bin/echo","hello docker"]
ENTRYPOINT["/bin/echo","hello docker"]

Shell格式示例

FROM centos
ENV name Docker
ENTRYPOINT echo "hello $name"

Exec格式正确示例

FROM centos
ENV name Docker
ENTRYPOINT ["/bin/bash","-c","echo hello $name"]

Exec格式错误示例一

FROM centos
ENV name Docker
ENTRYPOINT ["/bin/echo","hello $name"]

错误原因：$name不会被视为一个变量。若想要将其识别为变量，可采用["/bin/bash","-c","..."]

Exec格式错误示例二

FROM centos
ENV name Docker
ENTRYPOINT ["/bin/bash","-c","echo","hello $name"]

错误原因：使用”/bin/bash“时，”echo hello $name“应该视为一个参数，而不是两个

补充

官方Image Dockerfile：Docker-library

参考

Dockerfile reference