Dockerfile 指令 COPY 拷贝文件夹

今天在编写 dockerfile 时使用 COPY 拷贝文件夹时遇到了意料之外的情况。在此记录一下正确的使用方法。

背景说明

今天在通过 dockerfile 将文件夹拷贝到镜像的时候发现,是把文件夹下的内容拷贝进去了。

dockerfile 如下:

1
2
3
4
5
FROM node:alpine
WORKDIR /usr/src/app
COPY dist node_modules package.json ./
EXPOSE 3000
CMD ["yarn", "start:prod"]

我是想把 dist 和 node_modules 两个文件夹都拷贝到镜像中,又不想用多条 COPY 来分别拷贝,那样会多一个 layer。结果发现 dist 和 node_modules 两个文件夹本身没有被拷贝进镜像,而是把文件夹下的内容分别拷贝进的镜像。

经过测试发现:

  • ADD 命令和 COPY 命令在复制文件时行为一致
  • COPY/ADD 命令的源如果是文件夹,复制的是文件夹的内容而不是其本身
  • 使用 * 匹配所有文件,如果遇到文件夹也会保持上述逻辑,即仅复制内容

这个逻辑很诡异,和我们的一般预期不符。

我发现在六年前就已经有人问过类似的问题了,看来也没啥要改的意思。

实现方法

下面列举几个事项方式,大家可以参考着使用。

单个文件夹复制,指定目标目录

一种方法就是一次复制一个文件夹,然后 COPY 的时候要指定到镜像中的具体目录,比如把上面的 dockerfile 改成这样:

1
2
3
4
5
6
7
FROM node:alpine
WORKDIR /usr/src/app
COPY dist ./dist
COPY node_modules ./node_modules
COPY package.json ./
EXPOSE 3000
CMD ["yarn", "start:prod"]

放到另一个文件夹中统一复制

上面那种写法很麻烦,还会增加 layer 数。这边想了一个变相的方法,不是很优雅。

就是将需要拷贝的文件夹都放到一个统一的文件夹中,然后在 dockerfile 中拷贝这个文件夹,文件夹下的目录结构就能够得到保持。

1
mkdir dockerPackages && mv dist node_modules dockerPackages
1
2
3
4
5
FROM node:alpine
WORKDIR /usr/src/app
COPY dockerPackages package.json ./
EXPOSE 3000
CMD ["yarn", "start:prod"]

利用 .dockerignore 文件

我们上面的写法其实就是像完成一件事,那就是仅把部分内容拷贝进镜像,然后忽略其他内容。这样,我们就可以利用 .dockerignore 文件,来更加优雅地实现。先忽略所有文件,然后将我们需要拷贝的文件排除。

.dockerignore:

1
2
3
4
*
!dist
!node_modules
!package.json
1
2
3
4
5
6

FROM node:alpine
WORKDIR /usr/src/app
COPY . ./
EXPOSE 3000
CMD ["yarn", "start:prod"]