ADD 复制文件
- 格式:
- ADD <src>...<dest>
- ADD ["<src>",..."<dest>"]
ADD docker-test-demo-0.0.1-SNAPSHOT.jar app.jar
- 从 src 目录复制文件到容器的 dest,其中 src 可以是 Dockerfile 所在目录的相对路径,也可以是一个 URL,还可以是一个压缩包
-
注意:
- src 必须在构建的上下文内,不能使用例如:ADD ../somethine /something 这样的命令,因为 docker build 命令首先会将上下文路径和其子目录发送到 docker daemon
- 如果 src 是一个 URL,同时 dest 不以斜杠结尾,则 dest 会被视为文件,src 对应内容文件会被下载到 dest
- 如果 src 是一个 URL,同时 dest 以斜杠结尾,则 dest 会被视为目录,src 对应内容文件会被下载到 dest 目录
- 如果 src 是一个目录,那么整个目录下的内容将会被复制,包括文件系统元数据
- 如果文件是可是别的压缩包,则 docker 会自动解压
ARG 设置构建参数
- 格式:
- ARG <name>[=<default value>]
ARG user1=someuser
- ARG 指令用于设置构建参数,类似与 ENV,不同的是,ARG 设置的是构建时的环境变量,在容器运行时是不会存在这些变量的
CMD 容器启动命令
- 格式:
- CMD ["executable","param1","param2"](推荐)
- CMD ["param1","param2"](为 ENTRYPOINT 指令提供预设参数)
- CMD command param1 param2 (在 shell 中执行)
CMD echo "This is a test." | wc -
- CMD 指令用于为执行容器提供默认值,每个 Dockerfile 只有一个 CMD 命令,如果指定了多个 CMD 命令,那么只有最后一条被执行,如果启动容器时指定了运行的命令,则会被覆盖掉 CMD 指定的指令
COPY 复制文件
- 格式:
- COPY <src>...<dest>
- COPY ["<src>",..."<dest>"]
- 复制本地端的 src 到容器的 dest,COPY 指令和 ADD 指令类似,COPY 不支持 URL 和压缩包
ENTRYPOINT 入口点
- 格式:
- ENTRYPOINT ["executable","param1","param2"]
- ENTRYPOINT command param1 param2
- ENTRYPOINT 和 CMD 指令的目的一样,都是指定 Docker 容器启动时的执行命令,可以多次设置,但只有最后一个有效
ENV 设置环境变量
- 格式:
- ENV <key> <value>
- ENV <key>=<value> ...
ENV JAVA_HOME /path/to/java
EXPOSE 声明暴露的端口
- 格式:
- EXPOSE <port> [<port>...]
# 声明暴露一个端口
EXPOSE port1
# 相应的运行容器使用的命令
docker run -p port1 image
# 也可以使用 -P 选项启动
docker run -P image
# 声明暴露多个端口
EXPOSE port1 port2 port3
# 相应的运行容器使用的命令
docker run -p port1 -p port2 -p port3 image
# 也可以指定需要映射到宿主机器上的端口号
docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 image
- EXPOSE 指令用于声明在运行时容器提供的服务端口,该指令的作用主要是帮助镜像使用者理解该镜像服务的守护端口,其次是当运行时使用随机映射时,会自动映射 EXPOSE 的端口
FROM 指定基础镜像
- 格式:
- FROM <image>
- FROM <image>:<tag>
- FROM <image>@<digest>
- 使用 FROM 指令指定基础镜像,FROM 指令类似 Java 里的 extends 关键字,FROM 指令必须指定且必须在其它指令之前,FROM 指令之后的的所有指令都依赖于所指定的镜像
LABEL 为镜像添加元数据
- 格式:
- LABEL <key>=<value> <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."
MAINTAINER 指定维护者信息
MAINTAINER 林塬<xxxx@qq.com>
RUN 执行命令
- 格式:
- RUN <command>
- RUN ["executable","param1","param2"]
- RUN <command> 在 shell 终端中运行,在 Linux 中默认是 /bin/sh -c,在 Windows 中是 cmd /s /c
USER 设置用户
USER daemon
- 该指令用于设置启动镜像时的用户或者 UID,写在该指令后的 RUN、CMD 以及 ENTRYPOINT 指令都将使用该用户执行命令
VOLUME 指定挂载点
VOLUME /data
- 该指令使容器中的一个目录具有持久化存储功能,该目录可被容器本身使用,也可以共享给其它容器
- 当容器中的应用有持久化数据的需求时可以在 Dockerfile 中使用该指令
WORKDIR 指定工作目录
- 格式:
- 切换目录指令,类似于 cd 命令,写在该指令后的 RUN、CMD 以及 ENTRYPOINT 都将该工作目录作为当前目录,并执行指令
其它
- Dockerfile 还有一些其它指令,例如 STOPSINGAL、SHELL 等