如何在构建中包含本地库？

Question

我有一个这样的目录结构：

app/
inc/
www/

其中inc/ 包含app 和www 通用的代码。为我做的应用程序创建图像：

cd app
docker build .

所以构建的context 是app/ 的内容。当然，inc/ 中的代码会从应用程序中丢失，并且会中断

谷歌搜索我已经阅读了我应该阅读的建议：

docker build -f app/Dockerfile .

其中包括inc/（好），但也包括其他所有内容（坏），例如万维网

为了解决这个问题，我必须构建一个脚本，将inc/ 的内容复制到app/，执行构建和删除app/inc/。但这很麻烦，实际上，我不能这样做，因为我希望 docker-compose 进行构建。

推荐的管理方法是什么？

Answer 1

但也包括其他所有内容（坏的），例如万维网

这就是.dockerignore file 可以派上用场的地方：在其中声明www/。

在 docker CLI 将上下文发送到 docker 守护程序之前，它会在上下文的根目录中查找名为 .dockerignore 的文件。
如果此文件存在，CLI 会修改上下文以排除与其中的模式匹配的文件和目录。

这有助于避免不必要地向守护程序发送大型或敏感文件和目录，并可能使用ADD 或COPY 将它们添加到图像中。

包装 docker build 或 docker compose 以生成正确的 .dockerignore 现在是理想的选择。

最终，每个构建都应该能够指定自己的dockerignore 文件。
见issue 12886。
然而：

此功能已暂停，等待正在研究/处理的其他更改；其中之一是在发送构建上下文时使构建器“更聪明”；见#31829。

---

2019 年 8 月更新，两年后：issue 12886 (Add support for specifying .dockerignore file with -i/--ignore)，2015 年开放，即将随 Docker 19.03 关闭：
Tõnis Tiigi 提及：

我认为我们可以关闭它，因为用例已在 19.03 中得到解决，并且这里有很多过时/不正确的建议可能会让新读者感到困惑。

这已通过三个功能解决：

• #12886 (comment) 如果存储库包含许多 Dockerfile，则允许为每个 Dockerfile 设置一个 dockerignore 文件。 （请注意，这是对最初问题的准确描述）
• BuildKit 会自动忽略不使用的文件，自动消除不同组文件需要相互忽略的问题。
• 同一个 Dockerfile 对不同的构建“模式”（例如 dev 与 prod）使用不同的文件集的情况可以通过多阶段构建并使用构建参数定义模式更改来实现。

这与此处最初请求的语法不同，因为该版本与用户期望从 Dockerfiles 获得的稳定性保证不兼容。所提供的解决方案为需要更好地控制被忽略文件的用户解决了问题，而无需向其他文件添加新文件。

所以：

“先加载<dockerfile-name>.dockerignore，如果找不到则回退到.dockerignore”已登陆Docker（19.03.0-beta1）的测试分发版

需要开启BuildKit模式才能使用，例如：

$ export DOCKER_BUILDKIT=1

$ echo "FROM ubuntu \n COPY . tmp/" > Dockerfile
$ cp Dockerfile Dockerfile2
$ touch foo bar
$ echo "foo" > .dockerignore
$ echo "bar" > Dockerfile2.dockerignore

$ docker build -t container1 -f Dockerfile .
$ docker build -t container2 -f Dockerfile2 .

$ docker run container1 ls tmp
Dockerfile
Dockerfile2
Dockerfile2.dockerignore
bar
$ docker run container2 ls tmp
Dockerfile
Dockerfile2
Dockerfile2.dockerignore
foo