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

爱被打了一巴掌 2023-10-12 17:29 53阅读 0赞

## 一、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文件实例 ##

![cc2701fc379e4632a57c7845b07fd526.png][]

这是一份基于 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` 它为即将运行的容器设置默认的应用程序及其参数。

##  ##

[cc2701fc379e4632a57c7845b07fd526.png]: https://img-blog.csdnimg.cn/cc2701fc379e4632a57c7845b07fd526.png