Dockerfile 由一行行命令语句组成,并且支持用“#”
开头作为注释,一般的,Dockerfile 分为四部分:基础镜像信息
,维护者信息
,镜像操作指令
和容器启动时执行的指令
。
Dockerfile 的指令是忽略大小写
的,建议使用大写,使用 #
作为注释,每一行只支持一条指令,每条指令可以携带多个参数。
Dockerfile 的指令根据作用可以分为两种,构建指令和设置指令。构建指令用于构建 image,其指定的操作不会在运行 image 的容器上执行;设置指令用于设置 image 的属性,其指定的操作将在运行 image 的容器中执行。
以下将针对常用的指令进行解析:
1、FROM
格式:FROM
或FROM :
第一条指令必须为 FROM 指令,并且,如果在同一个 Dockerfile 中创建多个镜像时,可以使用多个 FROM 指令(每个镜像一次)
2、MAINTAINET
格式:MAINTAINET
指定维护者的信息
3、RUN
格式:RUN
或 RUN [“”, “”, “”]
每条指令将在当前镜像基础上执行,并提交为新的镜像。(可以用 “\” 换行)
4、CMD
格式:CMD [“”,””,””]
指定启动容器时执行的命令,每个 Dockerfile 只能有一条 CMD 指令,如果指定了多条指令,则最后一条执行。(会被启动时指定的命令覆盖)
5、EXPOSE
格式:EXPOSE [ …]
告诉 Docker 服务端暴露端口,在容器启动时需要通过 -p 做端口映射
6、ENV
格式:ENV
指定环境变量,会被 RUN 指令使用,并在容器运行时保存
7、ADD
格式:ADD
复制指定的到容器的中,可以是 Dockerfile 所在的目录的一个相对路径;可以是 URL,也可以是 tar.gz(自动解压)
8、COPY
格式:COPY
复制本地主机的 ( 为 Dockerfile 所在目录的相对路径)到容器中的 (当使用本地目录为源目录时,推荐使用 COPY)
9、ENTRYPOINT
格式:ENTRYPOINT [“”,””,””]
配置容器启动后执行的命令,并且不可被 docker run 提供的参数覆盖。(每个 Dockerfile 中只能有一个 ENTRYPOINT ,当指定多个时,只有最后一个起效)
10、VOLUME
格式:VOLUME [“/mnt”]
创建一个可以从本地主机或其他容器挂载的挂载点,一般用来存放数据库和需要保持的数据等
11、USER
格式:USER daemon
指定运行容器时的用户名或 UID,后续的 RUN 也会使用指定用户。
12、WORKDIR
格式:WORKDIR /path/to/workdir
为后续的 RUN 、 CMD 、 ENTRYPOINT 指令配置工作目录。(可以使用多个 WORKDIR 指令,后续命令如果参数是相对路径, 则会基于之前命令指定的路径)
13、ONBUILD
格式:ONBUILD [INSTRUCTION]
配置当所创建的镜像作为其它新创建镜像的基础镜像时,所执行的操作指令
14、查看某一个镜像的dockerfile
docker history --format {{.CreatedBy}} --no-trunc=true 镜像id |sed "s/\/bin\/sh\ -c\ \#(nop)\ //g"|sed "s/\/bin\/sh\ -c/RUN/g" | tac
root@bjali-ecs-172-16-192-65:/home/op# docker imagesREPOSITORY TAG IMAGE ID CREATED SIZE
<none> <none> fb12486a9093 21 hours ago
apache/apisix 2.10.0-alpine 627d00c649fc 2 months ago 110MB
root@XX:/home/op# docker history --format {{.CreatedBy}} --no-trunc=true 627d00c649fc|sed "s/\/bin\/sh\ -c\ \#(nop)\ //g"|sed "s/\/bin\/sh\ -c/RUN/g" | tac
ADD file:ecdfb91a737d6c292265c1b77ffd3d82ba810dd43ea4ef79714b66b1da74a5aa in /
CMD ["/bin/sh"]
ARG ENABLE_PROXY
RUN |1 ENABLE_PROXY=false RUN set -x && (test "${ENABLE_PROXY}" != "true" || /bin/sed -i 's,http://dl-cdn.alpinelinux.org,https://mirrors.aliyun.com,g' /etc/apk/repositories) && apk add --no-cache bash libstdc++ curl tzdata # buildkit
WORKDIR /usr/local/apisix
COPY /usr/local/openresty/ /usr/local/openresty/ # buildkit
COPY /usr/local/apisix/ /usr/local/apisix/ # buildkit
COPY /usr/bin/apisix /usr/bin/apisix # buildkit
RUN |1 ENABLE_PROXY=false RUN ln -sf /dev/stdout /usr/local/apisix/logs/access.log && ln -sf /dev/stderr /usr/local/apisix/logs/error.log # buildkit
ENV PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/openresty/luajit/bin:/usr/local/openresty/nginx/sbin:/usr/local/openresty/bin
EXPOSE map[9080/tcp:{} 9443/tcp:{}]
CMD ["sh" "-c" "/usr/bin/apisix init && /usr/bin/apisix init_etcd && /usr/local/openresty/bin/openresty -p /usr/local/apisix -g 'daemon off;'"]
STOPSIGNAL SIGQUIT