Dockerfile命令详解之 ADD

约定不等于承诺〃 2024-04-07 13:44 12阅读 0赞

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

[专栏订阅传送门![icon-default.png_t_M85B][]https://blog.csdn.net/qq\_38220908/category\_11989778.html][Link 1]

指令不区分大小写 ![gif.latex?%5E%7B%5E%7B%5B1%5D%7D%7D][gif.latex_5E_7B_5E_7B_5B1_5D_7D_7D]。但是，按照惯例，它们应该是大写的，以便更容易地将它们与参数区分开来。([引用至官方文档>>>][Link 2])

> [使用Dockerfile构建Springboot项目][Dockerfile_Springboot]
> 
> [Docker官方文档 - ADD][Docker_ - ADD]
> 
> [Dockerfile命令详解之 FROM][Dockerfile_ FROM]
> 
> [Dockerfile命令详解之 ARG][Dockerfile_ ARG]
> 
> [Dockerfile命令详解之 COPY][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 git@git.example.com: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][kenllf] 的斧正

[Link 1]: https://blog.csdn.net/qq_38220908/category_11989778.html
[icon-default.png_t_M85B]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/0a60534a475349c491aa42415882ad19.png
[gif.latex_5E_7B_5E_7B_5B1_5D_7D_7D]: https://latex.csdn.net/eq?%5E%7B%5E%7B%5B1%5D%7D%7D
[Link 2]: https://docs.docker.com/engine/reference/builder/#format
[Dockerfile_Springboot]: https://blog.csdn.net/qq_38220908/article/details/126630610
[Docker_ - ADD]: https://docs.docker.com/engine/reference/builder/#add
[Dockerfile_ FROM]: https://blog.csdn.net/qq_38220908/article/details/126652650
[Dockerfile_ ARG]: https://blog.csdn.net/qq_38220908/article/details/126667781
[Dockerfile_ COPY]: https://blog.csdn.net/qq_38220908/article/details/126680214
[kenllf]: https://blog.csdn.net/kenllf?type=blog