Docker Interface (DI) is a declarative interface for building images and running commands in containers using Docker. At Spotify, we use Docker Interface to minimise environment drift by running all of our code in containers–during development, production, or to train machine learning models.
You can install Docker Interface using the following pip
command (you need a python3 interpreter).
pip install docker-interface
To check that Docker Interface was installed successfully, run
di --help
Docker Interface can be invoked from the command line. By default, it reads the configuration from the file di.yml
in the current working directory, a basic version of which is shown below.
build:
tag: name-of-your-image
Docker interface supports two commands:
build
builds and tags Docker image using the current working directory as the build context.run
runs a Docker command in a container and mounts the current working directory with appropriate permissions at/workspace
so you can access your local files without having to rebuild the image.
You can find more extensive examples in the examples
folder in this repository. You can find more detailed information here. Check the schema to get a comprehensive overview of the declarative syntax supported by Docker Interface.
To contribute to the development of Docker Interface, please create a fork of the repository and send any changes as a pull request.
You can test your local installation of Docker Interface as follows.
# 0. Set up a virtual environment (optional but recommended)
# 1. Install development requirements
pip install -r requirements.txt
# 2. Run the tests
make tests
See virtualenv
or conda
for details on how to set up a virtual environment in step 0.
This project adheres to the Open Code of Conduct. By participating, you are expected to honour this code.