dockerfile指令总结
指令的一般格式为
- INSTRUCTION arguments
,指令包括
- FROM
、
- MAINTAINER
、
- RUN
等。
格式为
或
- FROM <image>
。
- FROM <image>:<tag>
第一条指令必须为
指令。并且,如果在同一个Dockerfile中创建多个镜像时,可以使用多个
- FROM
指令(每个镜像一次)。
- FROM
格式为
,指定维护者信息。
- MAINTAINER <name>
格式为
或
- RUN <command>
。
- RUN ["executable", "param1", "param2"]
前者将在shell终端中运行命令,即
;后者则使用
- /bin/sh -c
执行。指定使用其它终端可以通过第二种方式实现,例如
- exec
。
- RUN ["/bin/bash", "-c", "echo hello"]
每条
指令将在当前镜像基础上执行指定命令,并提交为新的镜像。当命令较长时可以使用
- RUN
来换行。
- \
支持三种格式
使用
- CMD ["executable","param1","param2"]
执行,推荐方式;
- exec
在
- CMD command param1 param2
中执行,提供给需要交互的应用;
- /bin/sh
提供给
- CMD ["param1","param2"]
的默认参数;
- ENTRYPOINT
指定启动容器时执行的命令,每个Dockerfile只能有一条
命令。如果指定了多条命令,只有最后一条会被执行。
- CMD
如果用户启动容器时候指定了运行的命令,则会覆盖掉
指定的命令。
- CMD
格式为
。
- EXPOSE <port> [<port>...]
告诉Docker服务端容器暴露的端口号,供互联系统使用。
格式为
。 指定一个环境变量,会被后续
- ENV <key> <value>
指令使用,并在容器运行时保持。
- RUN
例如
- ENV PG_MAJOR 9.3
- ENV PG_VERSION 9.3.4
- RUN curl -SL http://example.com/postgres-$PG_VERSION.tar.xz | tar -xJC /usr/src/postgress && …
- ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH
格式为
。
- ADD <src> <dest>
该命令将复制指定的
到容器中的
- <src>
。 其中
- <dest>
可以是Dockerfile所在目录的一个相对路径;也可以是一个URL;还可以是一个tar文件(自动解压为目录)。则。
- <src>
格式为
。
- COPY <src> <dest>
复制本地主机的
(为Dockerfile所在目录的相对路径)到容器中的
- <src>
。
- <dest>
当使用本地目录为源目录时,推荐使用
。
- COPY
两种格式:
- ENTRYPOINT ["executable", "param1", "param2"]
(shell中执行)。
- ENTRYPOINT command param1 param2
配置容器启动后执行的命令,并且不可被
提供的参数覆盖。
- docker run
每个Dockerfile中只能有一个
,当指定多个时,只有最后一个起效。
- ENTRYPOINT
格式为
。
- VOLUME ["/data"]
创建一个可以从本地主机或其他容器挂载的挂载点,一般用来存放数据库和需要保持的数据等。
格式为
。
- USER daemon
指定运行容器时的用户名或UID,后续的
也会使用指定用户。
- RUN
当服务不需要管理员权限时,可以通过该命令指定运行用户。并且可以在之前创建所需要的用户,例如:
。要临时获取管理员权限可以使用
- RUN groupadd -r postgres && useradd -r -g postgres postgres
,而不推荐
- gosu
。
- sudo
格式为
。
- WORKDIR /path/to/workdir
为后续的
、
- RUN
、
- CMD
指令配置工作目录。
- ENTRYPOINT
可以使用多个
指令,后续命令如果参数是相对路径,则会基于之前命令指定的路径。例如
- WORKDIR
- WORKDIR /a
- WORKDIR b
- WORKDIR c
- RUN pwd
则最终路径为
。
- /a/b/c
格式为
。
- ONBUILD [INSTRUCTION]
配置当所创建的镜像作为其它新创建镜像的基础镜像时,所执行的操作指令。
例如,Dockerfile使用如下的内容创建了镜像
。
- image-A
- [...]
- ONBUILD ADD . /app/src
- ONBUILD RUN /usr/local/bin/python-build --dir /app/src
- [...]
如果基于A创建新的镜像时,新的Dockerfile中使用
指定基础镜像时,会自动执行
- FROM image-A
指令内容,等价于在后面添加了两条指令。
- ONBUILD
- FROM image-A
- #Automatically run the following
- ADD . /app/src
- RUN /usr/local/bin/python-build --dir /app/src
使用
指令的镜像,推荐在标签中注明,例如
- ONBUILD
。
- ruby:1.9-onbuild
Dockerfile指令总结
来源: http://www.bubuko.com/infodetail-2419714.html