docker.md

Docker

Our Test Runners are deployed as Docker images.

Please read the general Tooling docker information to familiarize yourself with how these work.

Integration

When we run a Test Runner to test a solution, we run a Docker command that looks like this:

docker run \
        --rm \
        --network none \
        --mount type=bind,src="${solution_dir}",dst=/solution \
        --mount type=bind,src="${output_dir}",dst=/output \
        --tmpfs /tmp:rw \
        "exercism/${track_slug}-test-runner" \
        "${exercise_slug}" "/solution" "/output"

You can see that we pass three arguments to the Docker image:

1. The exercise slug
2. The path to the solution's directory
3. The path to the output directory

Conventions

All our test runners use the following conventions in their implementation:

• The Dockerfile is in the repo's root directory.
• The working directory should be /opt/test-runner.
• The entrypoint is /opt/test-runner/bin/run.sh
• The /opt/test-runner/bin/run.sh script takes 3 arguments:
  1. The exercise slug
  2. The path to the solution's directory
  3. The path to the output directory

For more information see The Interface.

New test runner repos will use these conventions by default.