153

I used to list the tests directory in .dockerignore so that it wouldn't get included in the image, which I used to run a web service.

Now I'm trying to use Docker to run my unit tests, and in this case I want the tests directory included.

I've checked docker build -h and found no option related.

How can I do this?

2
  • @Henry you mean copy-pasting the same folder twice to keep them up to date for changes that affect them both?
    – Nachokhan
    Commented Apr 26, 2022 at 14:20
  • there should be a way to do this with COPY . . like COPY --ignore=x . . Commented Nov 16, 2022 at 2:45

6 Answers 6

244

Docker 19.03 shipped a solution for this.

The Docker client tries to load <dockerfile-name>.dockerignore first and then falls back to .dockerignore if it can't be found. So docker build -f Dockerfile.foo . first tries to load Dockerfile.foo.dockerignore.

Setting the DOCKER_BUILDKIT=1 environment variable is currently required to use this feature. This flag can be used with docker compose since 1.25.0-rc3 by also specifying COMPOSE_DOCKER_CLI_BUILD=1.

See also comment0, comment1, comment2


from Mugen comment, please note

the custom dockerignore should be in the same directory as the Dockerfile and not in root context directory like the original .dockerignore

i.e.

when calling

DOCKER_BUILDKIT=1
docker build -f /path/to/custom.Dockerfile ...

your .dockerignore file should be at

/path/to/custom.Dockerfile.dockerignore

10
  • 42
    Note the custom dockerignore should be in the same directory as the Dockerfile and not in root context directory like the original .dockerignore
    – Mugen
    Commented Nov 27, 2019 at 9:39
  • 5
    @Mugen -- if the Dockerfile is in a subdirectory of the context, are the paths in the docker ignore relative to the location of the Dockerfile? (so you can ignore e.g. ../foo?)
    – shaunc
    Commented Dec 31, 2019 at 0:57
  • 11
    @shaunc surprisingly no, they are relative to the location of the context
    – Mugen
    Commented Dec 31, 2019 at 7:44
  • 3
    I've tried this and it isn't working with docker-compose
    – SumNeuron
    Commented Jan 14, 2020 at 14:40
  • 9
    What if you are doing scripted builds with -f -? A flag just seems simplest; would be great if we could use -i dockerignore-fifo Commented Jul 16, 2021 at 11:57
22

At the moment, there is no way to do this. There is a lengthy discussion about adding an --ignore flag to Docker to provide the ignore file to use - please see here.

The options you have at the moment are mostly ugly:

  • Split your project into subdirectories that each have their own Dockerfile and .dockerignore, which might not work in your case.
  • Create a script that copies the relevant files into a temporary directory and run the Docker build there.
1
  • Seems like there are lots of other options. Perhaps too many. One is to temporarily move files you don't want in the build to an ignored directory (I think this even reduces the context). Another is to create a tarball to add to the image (This doesn't help with the size of the context). Another is to have alternate ignore files and move them into the .docker_ignore name as necessary.
    – nroose
    Commented May 3, 2019 at 22:02
3

I've tried activating the DOCKER_BUILDKIT as suggested by @thisismydesign, but I ran into other problems (outside the scope of this question).

As an alternative, I'm creating an intermediary tar by using the -T flag which takes a txt file containing the files to be included in my tar, so it's not so different than a whitelist .dockerignore.

I export this tar and pipe it to the docker build command, and specify my docker file, which can live anywhere in my file hierarchy. In the end it looks like this:

tar -czh -T files-to-include.txt | docker build -f path/to/Dockerfile -

3

Adding the cleaned tests as a volume mount to the container could be an option here. After you build the image, if running it for testing, mount the source code containing the tests on top of the cleaned up code.

services:
   tests:
      image: my-clean-image
      volumes:
         - '../app:/opt/app' # Add removed tests
2
  • this is with docker-compose, but what about just with docker build Commented May 26, 2018 at 22:44
  • 1
    @AlexanderMills This is equivalent to docker run -v "`pwd`/app:/opt/app" my-clean-image
    – Blaise
    Commented Jan 22, 2019 at 13:53
1

Another option is to have a further build process that includes the tests. The way I do it is this:

If the tests are unit tests then I create a new Docker image that is derived from the main project image; I just stick a FROM at the top, and then ADD the tests, plus any required tools (in my case, mocha, chai and so on). This new 'testing' image now contains both the tests and the original source to be tested. It can then simply be run as is or it can be run in 'watch mode' with volumes mapped to your source and test directories on the host.

If the tests are integration tests--for example the primary image might be a GraphQL server--then the image I create is self-contained, i.e., is not derived from the primary image (it still contains the tests and tools, of course). My tests use environment variables to tell them where to find the endpoint that needs testing, and it's easy enough to get Docker Compose to bring up both a container using the primary image, and another container using the integration testing image, and set the environment variables so that the test suite knows what to test.

-1

Sadly it isn't currently possible to point to a specific file to use for .dockerignore, so we generate it in our build script based on the target/platform/image. As a docker enthusiast it's a sad and embarrassing workaround.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.