docker筑基篇-05-Dockerfile常用指令

[TOC]

上一篇中我们介绍了使用Dockerfile构建自己的镜像。其中使用了一个很少的几行指令就可以完成自己镜像的定制。
现在我们来看一下在Dockerfile中常用的其他指令。

1 CMD

CMD用于指定一个容器在启动的时候将要执行的指令。

1.1 语法格式

CMD ["executable","param1","param2"] (exec form, this is the preferred form)
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)
CMD command param1 param2 (shell form)

我们在启动容器的时候可能会有如下写法：

docker run -it hylexus/nginx /bin/bash

而它和以下Dockerfile指令是一样的功能：

CMD ["/bin/bash"]

1.2 示例

FROM centos
CMD echo "This is a test." | wc -

##############################

FROM centos
CMD ["/usr/bin/wc","--help"]

1.3 注意点

**在一个Dockerfile文件中，CMD指令只能有一条。如果有多条，最后一条将覆盖其他的CMD指令 **
**docker run指令中传递的命令可以覆盖CMD指令 **

2 ENTRYPOINT

2.1 语法格式

实际上CMD指令的所有参数都会被再次当做参数传递给ENTRYPOINT指令指定的命令。

ENTRYPOINT ["executable", "param1", "param2"] (exec form, preferred)
ENTRYPOINT command param1 param2 (shell form)

2.2 示例


ENTRYPOINT ["/usr/sbin/nginx"]

# 传递参数
ENTRYPOINT ["/usr/sbin/nginx","-g","daemon off;"]

2.3 注意点

可以和CMD指令同时使用
可以在docker run的时候使用--entrypoint来覆盖ENTRYPOINT

2.4 CMD和ENTRYPOINT的交互

官网链接

CMD和ENTRYPOINT的交互

3 WORKDIR

3.1 语法格式

该指令用来在容器内部创建目录，RUN, CMD, ENTRYPOINT, COPY , ADD 这些指令会在该目录下执行。

WORKDIR /path/to/workdir

3.2 示例

WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd
# 注意相对路径和绝对路径
# 此处的最后路径为 /a/b/c

WORKDIR /soft/app/mobile
RUN bundle install
WORKDIR /soft/app
ENTRYPOINT ["rackup"]
# 注意此处的绝对路径

3.3 注意点

可以出现多次
可以使用 -w来覆盖工作目录
注意相对路径和绝对路径的区分

4 ENV

4.1 语法格式

该指令用来在构建镜像的过程中设置环境变量。

ENV <key> <value>
ENV <key>=<value> ...

4.2 示例

ENV myName="John Doe" myDog=Rex\ The\ Dog \
    myCat=fluffy

ENV myName John Doe
ENV myDog Rex The Dog
ENV myCat fluffy

4.3 注意点

可以使用 -e 选项来传递环境变量

5 USER

5.1 语法格式

该指令指定容器以哪个用户的身份去运行。

USER option

5.2 示例

以下是多种组合方式：

USER userName
USER userName:groupName
USER uid
USER uid:gid
USER userName:gid
USER uid:groupName

6 VOLUME

该指令用来向基于镜像创建的容器添加卷。
一个卷可以存在于若干个容器内的特定目录。

6.1 语法格式

VOLUME ["/data"[,"/data2",...]]

对于该指令的其他用途，将在本人闲暇时在其他文章中介绍。

6.2 示例

FROM ubuntu
RUN mkdir /myvol
RUN echo "hello world" > /myvol/greeting
VOLUME /myvol
# 新创建的容器会有一个挂载点：/myvol
# 并且文件greeting会被复制到/myvol下

6.3 注意点

卷可以在容器之间共享，当然，共享并不是必须的
对卷的修改是即时生效的，并且不会对更新镜像产生影响
直到没人任何容器使用的时候卷才会被销毁

7 ADD

该指令可以将宿主机文件、目录或者远程文件复制到容器中。比如在构建镜像是可以将源文件复制到镜像中。

该指令还是比较常用的，可以看看官方文档的详细介绍：https://docs.docker.com/engine/reference/builder/#add

7.1 语法格式

ADD <src>... <dest>
ADD ["<src>",... "<dest>"] (this form is required for paths containing whitespace)

7.2 示例

# 不以斜线结尾，源是个文件
ADD xxx.txt /root/data
# 以斜线结尾，源是个目录
ADD mydata /root/data/
# 此处的归档文件会自动解压
ADD xxx.tar.gz /root/data

7.3 注意点

对归档文件ADD时，会自动解压
如果目的位置不存在，docker会自动创建(mod=755)
ADD指令会使得构建缓存无效

8 COPY

该指令和COPY指令类似。都可以将本地文件复制到容器中。

8.1 语法格式

COPY <src>... <dest>
COPY ["<src>",... "<dest>"] (this form is required for paths containing whitespace)

8.2 和ADD指令的不同

支复制本地文件
不会自动进行文件提取和解压

8.3 示例

COPY test relativeDir/   # adds "test" to `WORKDIR`/relativeDir/
COPY test /absoluteDir/  # adds "test" to /absoluteDir/

9 ONBUILD

该指令可以为镜像添加触发器。
当某个镜像被当做基础镜像来构建其他镜像时，该镜像中的触发器将会被执行。

9.1 语法格式

# INSTRUCTION可以是任何指令
ONBUILD [INSTRUCTION]