Dockerfile命令详解之 ADD

Posted 2023-03-29 清风怎不知意

       许多同学不知道Dockerfile应该如何写，不清楚Dockerfile中的指令分别有什么意义，能达到什么样的目的，接下来我将在容器化专栏中详细的为大家解释每一个指令的含义以及用法。

        专栏订阅传送门https://blog.csdn.net/qq_38220908/category_11989778.html

       指令不区分大小写 。但是，按照惯例，它们应该是大写的，以便更容易地将它们与参数区分开来。(引用至官方文档>>>)

使用Dockerfile构建Springboot项目

Docker官方文档 - ADD

Dockerfile命令详解之 FROM

Dockerfile命令详解之 ARG

Dockerfile命令详解之 COPY

---

语法

ADD [--chown=<user>:<group>] <src>... <dest>

或者

ADD [--chown=<user>:<group>] ["<src>",... "<dest>"]

<src>：宿主机（这里指的是安装有Docker引擎的那台服务器）文件所在路径或远程文件url，如果是宿主机本地文件，填写的路径可以是相对路径（相对路径，则是目标文件与构建上下文的相对路径）。

<dest>：指的是容器内的路径，如果是相对路径，则是相对于WORKDIR的路径

注意：

         1、--chown选项只适用于构建liunx类型的容器，不适用于windows类型的容器，因为用户组和所有权的概念不能在liunx和windows之间做转换。

        2、第二种命令格式主要用于路径中包含空格的情况！

        3、<src>以相对路径指定文件，文件必须在当前构建上下文之内，不能使用COPY ../something  /something 

         4、<src>如果是一个远程URL，<dest>不以斜杠"/"结尾，那么下载的文件，将会复制到<dest>中。

        5、<src>如果是一个远程URL，<dest>以斜杠"/"结尾，那么下载文件的时候，会分析文件名称，并将该文件存储到<dest>指定的目录下。比如从URL下载一个app.jar文件，到/build/，那么下载下来后，文件的路径为/build/app.jar

        6、如果<src>是一个目录，将复制该目录的全部内容，包括文件系统元数据。（不会复制指定的目录本身，只会复制目录下的内容）

        7、复制多个文件时，<dest>必须以斜杆"/"结尾

        8、当<dest>是一个不存在的路径时，会进行自动创建

ADD指令路径通配符用法

        当ADD指令的<src>不是一个远程地址时，可与COPY指令一样，适用路径通配符。

        比如：我要将/usr/local/app下的所有jar文件复制到容器中的/app/build/目录下，我们可以这样写Dockerfile

FROM openjdk:11
WORKDIR /app
# 匹配以jar为后缀的文件
ADD app/*.jar build/

        我们也可以通过?符号，匹配单个字符，比如使用指令 ADD boo?.txt  /app/build ，就可以复制Dockerfile当前文件夹下 book.txt ， boom.txt等等符合规则的文件。

        注意：

        如果文件中含有特殊字符，比如[或者]这样的字符，我们需要按照Golang的规则进行通配符的转换。比如文件arr[0].text 就需要写成ADD arr[[]0].txt /app/build/

ADD不同于COPY的特性

• ADD指令可以拉去远程文件。COPY只能复制本地文件
• ADD复制本地文件时，如果文件是压缩格式(identity, gzip, bzip2 或者 xz)，那么会进行自动解压（如果ADD一个远程文件，将不会进行解压操作）。COPY指令无此功能。

        文件是否被识别为可识别的压缩格式完全是基于文件的内容，而不是文件的名称。例如，如果一个空文件恰好以.tar.gz结尾，这将不会被识别为一个压缩文件，并且不会生成任何类型的解压缩错误消息，而只是将该文件复制到目的地。

拉取GIT仓库中的文件

ADD [--keep-git-dir=<boolean>] <git ref> <dir>

        我们可以使用上面的命令格式，拉取GIT仓库中的文件，而不需要使用git clone的命令。

比如：

FROM alpine
ADD --keep-git-dir=true https://github.com/moby/buildkit.git#v0.10.1 /buildkit

--keep-git-dir=true表示保留.git目录。默认值为false。

         拉取私有仓库的文件

FROM alpine
ADD [e-mail]:foo/bar.git /bar

        这个Dockerfile可以用docker build --ssh default来构建。

增强语义之ADD --link

        与COPY --link相同，ADD --link会将你复制的文件放在一个空目录中，并将此目录转换为一个独立的层，并链接到上一阶段的构建中。

        比如：

FROM alpine
ADD --link /usr/local/app/*.jar /app/build/

   就相当于： 

FROM alpine
 
 
FROM scratch
ADD /usr/local/app/*.jar /app/build/

        并且将构建出来的两层合并到一起。      

         使用ADD --link将重用之前生成的构建并合并到新层之上。这也意味着，当基本映像收到更新时，您可以轻松地重新设置映像的基础，而不必再次执行整个构建!!

        一般来说推荐使用ADD --link，以提供更好的构建体验。

[1]  感谢大佬 @kenllf 的斧正