.dockerignore工作流疑问:引用不存在目录为何无报错
.dockerignore 核心工作流说明
执行阶段
.dockerignore的规则生效于构建上下文打包阶段,早于Dockerfile指令的执行,具体流程如下:
- 执行
docker build命令后,Docker客户端首先会遍历你指定的构建上下文目录(默认是执行命令的当前目录),收集所有现存的文件、目录路径 - 客户端加载上下文根目录下的
.dockerignore文件,按从上到下的顺序逐行解析规则:- 先匹配普通排除规则,标记所有符合规则的路径为待排除
- 再匹配
!开头的例外放行规则,将符合规则的已标记路径从排除列表中移除 - 若某条规则匹配的路径在当前上下文中不存在,会直接跳过该规则,不会做任何存在性校验、也不会抛出错误
- 规则解析完成后,Docker客户端只会将未被排除的文件打包为tar包,传输给Docker daemon,被排除的文件完全不会进入后续构建流程,也不会被任何Dockerfile指令检测到。
与COPY指令报错逻辑的差异
COPY指令执行于Dockerfile构建阶段,此时构建上下文已经全部传输到Docker daemon侧:
- 执行COPY指令时,Docker daemon会直接在已收到的上下文里查找你指定的源路径,如果路径不存在,就会直接抛出错误
- 这和.dockerignore阶段的逻辑完全不同:前者是明确要求你指定存在的文件完成拷贝操作,后者只是对已存在的文件做过滤,不存在的路径不会对过滤逻辑产生任何影响。
你的场景解释
你配置的!folder_3放行规则,在上下文过滤阶段因为没有匹配到任何现存路径,直接被忽略,自然不会触发报错。最终实际被打入上下文的只有folder_1目录,folder_2被*规则排除,不存在的folder_3规则不产生任何效果。而如果直接写COPY folder_3 /home,构建阶段daemon在上下文里找不到对应路径,就会直接报错。
常用规则注意事项
- 规则优先级由书写顺序决定,后写的规则会覆盖前面的规则,比如先写
!folder_1再写*,最终folder_1还是会被排除 - 不带前缀的路径默认递归匹配所有子目录下的同名文件/目录,要仅匹配根目录下的路径,需要加
/前缀,比如/folder_2 - 注释行以
#开头,空行会被直接忽略
内容的提问来源于stack exchange,提问作者Ivan Mirchev
相关产品推荐
相关产品推荐

