DockerFile 命令总结

只描述非windows系统。

  • FROM <image>[:<tag>] [AS <name>]: 设置基础镜像
FROM alpine:latest
  • RUN <command> \ ["executable", "param1", "param2"]: 执行shell脚本。进来少使用RUN,因为没执行一次 docker就会增加一层只读层。
RUN /bin/bash -c 'source $HOME/.bashrc; \
echo $HOME'
等同于
RUN /bin/bash -c 'source $HOME/.bashrc; echo $HOME'
等同于
RUN ["/bin/bash", "-c", "source $HOME/.bashrc; echo $HOME"]
  • CMD ["executable","param1","param2"] \ ["param1","param2"] \ command param1 param2: DockerFile中只有一个CMD,多于一个将执行最后一个。它的意思差不多就是启动容器后执行的默认命令。
FROM *:*
CMD ["catalina.sh", "run"]
  • LABEL <key>=<value> <key>=<value> ... : 镜像标签
LABEL "com.example.vendor"="ACME Incorporated"
LABEL com.example.label-with-value="foo"
LABEL version="1.0"
LABEL description="This text illustrates \
that label-values can span multiple lines."
  • EXPOSE <port> [<port>/<protocol>...]: 暴露容器的端口
EXPOSE 80/tcp
EXPOSE 80/udp
  • ENV <key> <value> \ <key>=<value>: 设置容器环境变量。可以使用docker run --env <key>=<value>修改环境变量
ENV myName John Doe
ENV myDog Rex The Dog
ENV myCat fluffy

  • ADD [--chown=<user>:<group>] <src>... <dest> \ [--chown=<user>:<group>] ["<src>",... "<dest>"]: 拷贝一个新文件,或者文件夹或者远程文件的 URLS,把他们添加到,镜像的文件系统中。<dest> 为绝对路径或者由WORKDIR定义的相对路径。
ADD hom* /mydir/         # 添加所有以 "hom" 开头的文件
ADD hom?.txt /mydir/     # ? 替换任何单个的字符, e.g., "home.txt"

ADD test relativeDir/    # 添加 "test" 到 `WORKDIR`/relativeDir/
ADD test /absoluteDir/   # 添加 "test" 到 /absoluteDir/

ENV cpath /home/zb
ARG zbpath=/home/lala
WORKDIR $cpath
ADD **.jpg $cpath
ADD **.jpg $zbpath

# 添加含有特殊字符的文件或者文件夹时如“[]”,需要遵循 golang 的规则将它们进行转义,以防它们为匹配模式
ADD arr[[]0].txt /mydir/ # 复制一个文件名为 "arr[0].txt" 到 /mydir/

# 通过 --chown 指定添加文件或者文件夹的用户名和组名
ADD --chown=55:mygroup files* /somedir/
ADD --chown=bin files* /somedir/
ADD --chown=1 files* /somedir/
ADD --chown=10:11 files* /somedir/
  • COPY [--chown=<user>:<group>] <src>... <dest> / [--chown=<user>:<group>] ["<src>",... "<dest>"]: 与 ADD命令差不多。

  • ENTRYPOINT ["executable", "param1", "param2"] / command param1 param2: 容器启动后执行该命令。如果定义ENTRYPOINT 那么CMD形式就变为CMD ["param1","param2"] json数组中变为ENTRYPOINT的第一个参数和第二个参数

ARG VERSION=latest
FROM alpine:$VERSION
ENTRYPOINT ["ls", "-la"]

ENTRYPOINTCMD的比较

  1. 当有多个ENTRYPOINT CMD它们都只执行最后一个
  2. 当容器为一个可执行文件时应该定义ENTRYPOINT
  3. 当同时定义ENTRYPOINT 和 CMD时,CMDENTRYPOINT的默认参数
  4. docker执行run命令时,在里面指定CMD时,CMD将会被重写。
  • VOLUME ["/data"]: 在制作镜像时挂载卷。会在宿主机上自动生成一个对应的共享目录。
RUN mkdir /data1
RUN touch /data1/2a.txt
VOLUME /data1

# 通过命令 docker inspect hasVvolume
"Mounts": [
            {
                "Type": "volume",
                "Name": "0d63fcdf621ee728bb85dfcc2b30f3acddf6489a0e93b81ced17f05860497321",
                "Source": "/var/lib/docker/volumes/0d63fcdf621ee728bb85dfcc2b30f3acddf6489a0e93b81ced17f05860497321/_data",
                "Destination": "/data1",
                "Driver": "local",
                "Mode": "",
                "RW": true,
                "Propagation": ""
            }
        ]
========================================================================================================================
# 也可以通过 docker run -v 来挂载共享目录,这时 Source 指出 -v 时定义的目录
"Mounts": [
        {
                "Type": "bind",
                "Source": "/Users/zhangbo/Desktop/data1",
                "Destination": "/data1",
                "Mode": "",
                "RW": true,
                "Propagation": "rprivate"
            }
        ]

容器中共享目录

# 使用 --volumes-from,达到容器中文件夹共享
docker run -itd --name noVvolume-v-1 --volumes-from noVvolume-v 48cd9e43b6a9
  • USER <user>[:<group>] / <UID>[:<GID>]: 给镜像添加一个用户
  • WORKDIR /path/to/workdir or WORKDIR to_workdir /path/to/workdir: 为 RUN, CMD, ENTRYPOINT, COPY, ADD 创建工作目录
ENV DIRPATH /path
WORKDIR $DIRPATH/$DIRNAME
RUN pwd
  • ARG <name>[=<default value>] : docker file中的变量
FROM busybox
ARG user1="zhang bo"
ARG buildno
RUN echo $user1
RUN echo $buildno

Step */* : RUN echo $user1
 ---> Running in a56a602a8f87
zhang bo
Removing intermediate container a56a602a8f87
 ---> 3e9c6ec19129
Step */* : RUN echo $buildno
 ---> Running in 6598768a1080

预制变量

FROM ubuntu
ARG CONT_IMG_VER
ENV CONT_IMG_VER ${CONT_IMG_VER:-v1.0.0}
RUN echo $CONT_IMG_VER

# 可以通过 --build-arg 标签进行给定的预制的变量。--build-arg <varname>=<value>
docker run --build-arg CONT_IMG_VER=******* .

推荐阅读更多精彩内容