一段话总结完 COPY
- 作用:复制内容到镜像
- 格式: COPY <src> <dest>
- 详解:复制本地主机的 <src>下内容到镜像中的 <dest>,目标路径不存在时,会自动创建。
- <src>:可以是 Dockerfile 所在目录的一个相对路径(文件或目录)
- <dest>:可以是镜像内绝对路径,或者相对于工作目录(WORKDIR)的相对路径
- 路径:支持正则表达式, COPY test* /tmp
两种格式
COPY [--chown=<user>:<group>] <src>... <dest> COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]
--chown
仅适用于 linux 上的 dockerfile,在 window 上没有用户、组的概念
COPY 作用
- COPY 指令从 <src> 复制新文件、目录或远程文件 URL,并将它们添加到路径 <dest>
- 可以指定多个 <src> 资源,但如果它们是文件或目录,则它们的路径被解析为相对于构建上下文的源
- 每个 <src> 可能包含通配符,匹配将使用 Go 的 filepath.Match 规则完成
简单栗子
* 通配符
把所有 hom 开头的文件复制到镜像文件系统的 /mydir/ 目录下
COPY hom* /mydir/
? 通配符
? 匹配 0 或 1 个字符,比如会把 home.txt 文件复制到 /mydir/ 目录下
COPY hom?.txt /mydir/
重点
<dest> 是绝对路径,或相对于 WORKDIR 的路径,源将在目标容器内复制到该路径中
使用相对路径的栗子
COPY test.txt relativeDir/
等价于
COPY test.txt <WORKDIR>/relativeDir/
使用绝对路径的栗子
将 test.txt 添加到 /absoluteDir/ 目录下
COPY test.txt /absoluteDir/
包含特殊字符的文件
添加名为 arr[0].txt 的文件
COPY arr[[]0].txt /mydir/
标志 --from=<name>
将从 from 指定的构建阶段中寻找源文件 <src>
# 第一构建阶段:将仅用于生成 requirements.txt 文件 FROM tiangolo/uvicorn-gunicorn:python3.9 as requirements-stage # 将当前工作目录设置为 /tmp WORKDIR /tmp # 生成 requirements.txt RUN touch requirements.txt # 第二构建阶段,在这往后的任何内容都将保留在最终容器映像中 FROM python:3.9 # 将当前工作目录设置为 /code WORKDIR /code # 从第一个阶段复制 requirements.txt;这个文件只存在于前一个 Docker 阶段,这就是使用 --from-requirements-stage 复制它的原因 COPY --from=requirements-stage /tmp/requirements.txt /code/requirements.txt # 运行命令 RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
COPY 遵循的规则
<src> 路径必须在构建的上下文中
不能添加 ../something 、 /something ,因为 docker 构建的第一步是将上下文目录(和子目录)发送到 docker 守护进程
# test.txt 是相对路径,相对于构建上下文 COPY test.txt /mkdir/ # 错误写法,文件均不在上下文目录中,并不会被找到 # 这个找的就是构建上下文的上级目录的 test.txt COPY ../test.txt /mkdir/ # 这个找的是本机根目录下的 test.txt COPY /test.txt /mkdir/
<src> 是目录
- 则复制目录的全部内容,包括文件系统元数据
- 不会复制目录本身,只会复制其内容
COPY dir /mydir/
<src> 是任何其他类型的文件
- 则将其与其元数据一起单独复制
- <dest> 以斜杠 / 结尾,它将被视为一个目录,并且 <src> 的内容将写入 <dest>/base(<src>)
指定了多个 <src> 资源,或者由于使用了通配符
则 <dest> 必须是一个目录,并且必须以斜杠 / 结尾
COPY test1.txt test2.txt /mydir/
<dest> 不以斜杠结尾
它将被视为常规文件,并且 <src> 的内容将写入 <dest>
COPY test.txt /mytext
<dest> 不存在
路径中所有缺失的目录都会自动创建
COPY test.txt /dir/test/my/
注意事项
<src> 的内容发生变化,第一个遇到的 COPY 指令将使来自 Dockerfile 的所有后续指令的缓存无效,这包括使 RUN 指令的缓存无效
完整练习的 dockerfile
FROM centos # 添加文件到目录下 COPY test.txt /mydir/ # 将文件内容写入 mytest COPY test.txt /mytest # 压缩文件,自动解压 COPY jmeter.log.zip /myzipdir/ # 添加目录 COPY TeamFile / # 其他文件 COPY jmeter.log /mydir/ # 多个文件 COPY test1.txt test2.txt /mydir/ # 通配符,dest 不存在自动创建 COPY test*.txt /mydir/test/ # 特殊字符串 COPY COPY[[]0].txt /mydir/ WORKDIR /data # 相对路径 COPY test.txt test/
ADD 和 COPY 的区别和使用场景
- ADD 支持添加远程 url 和自动提取压缩格式的文件,COPY 只允许从本机中复制文件
- COPY 支持从其他构建阶段中复制源文件(--from)
- 根据官方 Dockerfile 最佳实践,除非真的需要从远程 url 添加文件或自动提取压缩文件才用 ADD,其他情况一律使用 COPY
注意
- ADD 从远程 url 获取文件和复制的效果并不理想,因为该文件会增加 Docker Image 最终的大小
- 相反,应该使用 curl huo wget 来获取远程文件,然后在不需要它时进行删除