Dockerfile 关键字和最佳实践

1. FROM2. LABEL3. RUN4. WORKDIR5. ADD and COPY6. ENV7. VOLUME8. EXPOSE9. CMD and ENTRYPOINT9.1. 编写格式9.2. CMD 详解9.3. ENTRYPOINT 详解9.2. 区别9.2.1. RUN 和 CMD

1. FROM

尽量使用官方的 image作为base image e.g.,

FROM scratch

FROM centos:7

2. LABEL

定义了 image 中的 metadata e.g.,

LABEL maintainer=“xiaowu@gmail.com” LABEL version=“1.0.0” LABEL description=“This is xxx”

3. RUN

每次运行一次 RUN 对于 image 都会生成新的一层，为了避免无用分层，合并多条命令成一行。 e.g.,

RUN yum update && yum install -y htop \ iotop

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

RUN /bin/bash -c ‘source ~/.bashrc; echo $HOME’

4. WORKDIR

用 WORKDIR 来替换 RUN cd尽量使用绝对路径。

e.g.,

WORKDIR /root

WORKDIR /test #如果目录不存在会自动创建 WORKDIR demo RUN pwd #输出结果应该是 /test/demo

5. ADD and COPY

大部分情况，COPY 优于 ADDADD 不光可以将文件复制，还能解压缩添加远程文件/目录应该使用 RUN curl 或 wget

e.g.,

ADD app / ADD archive.tar.gz /

WORKDIR /root ADD app test/ #/root/test/app

WORKDIR /root COPY app /test

6. ENV

尽量使用，增加可维护性 e.g.,

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

7. VOLUME

8. EXPOSE

9. CMD and ENTRYPOINT

都是设置容器启动后执行的命令

9.1. 编写格式

Shell 格式：

RUN yum install -y htop CMD echo “hello docker” ENTRYPOINT echo “hello docker”

Exec 格式：

RUN [“yum”, “install”, “-y”, “htop”] CMD ["/bin/echo", “hello docker”] ENTRYPOINT ["/bin/echo", “hello docker”]

9.2. CMD 详解

容器启动时默认执行的命令CMD 指令可被 run 命令指定要运行的程序所覆盖

FROM entos ENV name Docker CMD echo “hello $name”

如果执行 dockers run -it xxx /bin/bash，则hello Docker不会输出。

如果定义了多个CMD，只有最后一个CMD会生效

9.3. ENTRYPOINT 详解

让容器以应用程序或服务的形式运行不会被忽略，一定会执行

一般会一个shell脚本作为entrypoint

… … COPY docker-entrypoint.sh /usr/local/bin/ ENTRYPOINT [“docker-entrypoint.sh”]

EXPOSE 27017 CMD [“mongod”] … …

9.2. 区别

9.2.1. RUN 和 CMD

RUN 运行的时间点不同在 build 阶段，CMD 在 docker run 时运行

区别：

FROM centos ENV name Docker ENTRYPOINT echo “hello $name”

容器build后运行会打印出 hello Docker

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

打印出 hello $name 如果想打印出 hello Docker，需要使用以下方式

ENTRYPOINT ["/bin/bash", “-c”, “echo hello $name”]

---

官方的 Dockerfile 案例：

https://github.com/docker-library

参考文档：

https://docs.docker.com/engine/reference/builder