一、Dockerfile文件参数
Dockerfile 是用于构建 Docker 镜像的文件(之前的项目就是将jar包通过Dockerfile文件(D要记得大写!!),打包成一个镜像,当然后面也有一键化部署,使用插件来完成,方式有很多,之前的项目先使用Dockerfile文件来完成),其中可以定义一些参数以方便定制化镜像。常见的 Dockerfile 参数包括:
- FROM:指定基础镜像(除了from其他命令都是非必须的)。
- MAINTAINER:指定作者信息。
- RUN:在容器构建时就要执行的命令(就是运行shell语句)。
- CMD:指定容器启动时(真正运行时)默认运行的命令(脚本),可以以shell语句的方式来指定,也可以通过json数组的方式来指定。
- LABEL:为镜像添加元数据,比如版本号、描述等。
- EXPOSE:声明容器要监听的端口。
- ENV:设置环境变量。
- ADD/COPY:将本地(宿主机)上的文件或目录复制到容器中。
- WORKDIR:设置工作目录,指定shell语句工作在哪个路径下。
- USER:设置容器运行时的用户。
- ARG:定义构建时使用的变量,在 build 时传递进去。
- ONBUILD:定义在当前镜像基础上构建新镜像时需要执行的操作。
- STOPSIGNAL:指定容器停止时发送的信号。
- HEALTHCHECK:定义容器健康检查指令。
通过使用这些参数,可以更加灵活地构建 Docker 镜像,满足不同应用场景的需求。
二、相似参数指令辨析
①
:ADD
和 COPY
都是 Dockerfile 中用于将文件从构建上下文(本地主机或外部镜像)复制到容器内部的命令,但是它们之间有一些区别:
ADD
命令支持将构建上下文中的 URL(涉及到网络资源)、压缩包等资源添加到容器中,并且在进行复制时进行解压操作,而COPY
则无法对文件进行解压操作。ADD
命令会自动处理 URL 以及压缩包的文件复制操作,因此使用起来更加方便,但是当传输的是纯文件时,COPY
命令比ADD
更节省空间和时间,因为COPY
命令只复制指定文件而不执行额外的操作。COPY
命令可以指定多个源文件和目标路径,而ADD
命令不支持指定多个源文件。- COPY 复制文件进入镜像(只能用相对路径,不能用绝对路径)ADD 复制文件进入镜像(可以用绝对路径,假如是压缩文件会解压)
因此,如果你只需要简单地复制文件而不需要执行额外的操作,请使用 COPY
命令;如果需要下载远程文件、自动解压缩文件等操作,请使用 ADD
命令。当然根据够用就好的原则,建议在能满足功能的情况下一般使用copy就行。
②:CMD
和 ENTRYPOINT
均为定义容器启动后执行的命令指令。它们之间的主要区别如下:
ENTRYPOINT
定义了容器启动后始终会执行的命令(或脚本),而CMD
则可以覆盖ENTRYPOINT
定义的命令,默认情况下CMD
指定的命令会作为参数传递给ENTRYPOINT
定义的命令中。ENTRYPOINT
指定的命令会被视为容器的主要命令,而CMD
则会被视为该命令的默认参数。换句话说,ENTRYPOINT
定义了容器的主要进程,而CMD
则是为这个主进程提供默认参数的。- 在 Dockerfile 中可以同时存在
CMD
和ENTRYPOINT
,实际上ENTRYPOINT
通常都会搭配一个默认的CMD
。这样,在启动容器时,如果给docker run
命令传入了参数,那么这些参数会覆盖默认的CMD
参数,但是始终不会影响ENTRYPOINT
定义的命令。
因此,在选择使用 CMD
还是 ENTRYPOINT
时,应根据实际情况进行判断,如果需要始终执行某个命令,就使用 ENTRYPOINT
;如果需要执行具体的命令,并且允许在启动容器时修改这个命令的参数,就使用 CMD
。
三、Dockerfile文件实例
这是一份基于 dockette/jdk8 镜像构建的 Dockerfile 文件,它将一个 Java 应用打包成一个名为 jx-system-0.0.1-SNAPSHOT.jar 的可执行 jar 包,并将其复制到容器内部的 /test
目录下。然后使用 CMD
命令指定了镜像启动后默认执行的命令为 java -jar jx-system-0.0.1-SNAPSHOT.jar -Dfile.encoding=utf-8
,其中 -Dfile.encoding=utf-8
是指定编码为 UTF-8。
具体解释如下:
FROM dockette/jdk8
指定了基础镜像为 dockette/jdk8。WORKDIR /test
切换当前工作目录到/test
目录。COPY jx-system-0.0.1-SNAPSHOT.jar /test/jx-system-0.0.1-SNAPSHOT.jar
将本地的jx-system-0.0.1-SNAPSHOT.jar
复制到容器内的/test
目录下。CMD ["java","-jar","jx-system-0.0.1-SNAPSHOT.jar","-Dfile.encoding=utf-8"]
指定镜像启动后默认执行的命令,即运行 jx-system-0.0.1-SNAPSHOT.jar 这个可执行文件,使用-Dfile.encoding=utf-8
可以指定编码为 UTF-8。
在完成上述 Dockerfile 编写后,可以使用以下命令构建 Docker 镜像:
docker build -t your-image-name .
your-image-name
是你要给构建出来的镜像起的名字,.
表示当前目录,即 Dockerfile 所在的目录。构建完成后,使用以下命令启动容器:
docker run -d -p 8080:8080 --name your-container-name your-image-name
your-container-name
是你要给启动的容器起的名字,-p
指定将容器内部的 8080 端口映射到宿主机的 8080 端口,这样在宿主机中就可以通过浏览器访问应用程序了。
最后总结一份基本的 Dockerfile 模板文件来构建基于 Java 程序打包成的 Jar 包的镜像:
# 使用官方提供的 openjdk 作为基础镜像
FROM openjdk:8-jdk-alpine
# 复制 jar 文件到容器中
# ADD 和copy一样,复制文件到指定目录,但是copy不能解压,add自动解压
ADD target/demo.jar /app.jar
# 暴露容器端口
EXPOSE 8080
# 配置容器启动后执行的命令
ENTRYPOINT ["java", "-jar", "/app.jar"]
上述 Dockerfile 文件的解释如下:
FROM
指定了使用官方提供的openjdk作为基础镜像。ADD
指定将编译好的 Jar 文件添加到容器内。EXPOSE
告诉 Docker 哪个端口应该开放。ENTRYPOINT
它为即将运行的容器设置默认的应用程序及其参数。