Docker部署(3)——Dockerfile文件参数

一、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 中用于将文件从构建上下文（本地主机或外部镜像）复制到容器内部的命令，但是它们之间有一些区别：

1. ADD 命令支持将构建上下文中的 URL（涉及到网络资源）、压缩包等资源添加到容器中，并且在进行复制时进行解压操作，而 COPY 则无法对文件进行解压操作。
2. ADD 命令会自动处理 URL 以及压缩包的文件复制操作，因此使用起来更加方便，但是当传输的是纯文件时，COPY 命令比 ADD 更节省空间和时间，因为 COPY 命令只复制指定文件而不执行额外的操作。
3. COPY 命令可以指定多个源文件和目标路径，而 ADD 命令不支持指定多个源文件。
4. COPY 复制文件进入镜像（只能用相对路径，不能用绝对路径）ADD 复制文件进入镜像（可以用绝对路径，假如是压缩文件会解压）

        因此，如果你只需要简单地复制文件而不需要执行额外的操作，请使用 COPY 命令；如果需要下载远程文件、自动解压缩文件等操作，请使用 ADD 命令。当然根据够用就好的原则，建议在能满足功能的情况下一般使用copy就行。

   ②：CMD 和 ENTRYPOINT 均为定义容器启动后执行的命令指令。它们之间的主要区别如下：

1. ENTRYPOINT 定义了容器启动后始终会执行的命令（或脚本），而 CMD 则可以覆盖 ENTRYPOINT 定义的命令，默认情况下 CMD 指定的命令会作为参数传递给 ENTRYPOINT 定义的命令中。
2. ENTRYPOINT 指定的命令会被视为容器的主要命令，而 CMD 则会被视为该命令的默认参数。换句话说，ENTRYPOINT 定义了容器的主要进程，而 CMD 则是为这个主进程提供默认参数的。
3. 在 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 它为即将运行的容器设置默认的应用程序及其参数。