Allows a Docker build to be easily changed, without having to clone and modify an existing build repository.
All with a single command, the tool can:
- Build images from a different base image.
- Add/override files in the build context.
- Apply patches to the Dockerfile or other files in the build context.
- Define a different Dockerfile.
A few basic use cases (./docker-run.sh
can be used instead of patchworkdocker
):
- To change a base image from
debian:stretch
topython:3.7-stretch
so as to get the latest version of Python in the image with no hassle:patchworkdocker build \ --base-image python:3.7-stretch \ example:1.0.0 https://github.com/example/docker-example.git
- Add an alternate Dockerfile to a pre-existing context:
patchworkdocker build \ --additional-file Dockerfile:Dockerfile.example \ --dockerfile Dockerfile.example \ https://github.com/example/docker-example.git example:1.0.0
- Change the URL of a piece of software that gets installed into a Docker image:
patchworkdocker build \ --dockerfile 3.7/stretch/Dockerfile \ --patch change-install-url.patch:Dockerfile \ https://github.com/docker-library/python.git example:1.0.0
Raspberry Pi users may find this tool particularly useful as, outside the official images, there is often need to change image build in order to get them to work on the non-standard rpi architectures.
Prerequisites
- Docker
- Python 3.7+ (optional, as can be run entirely from Docker if you don't have Python 3.7)
The tool can be installed directly from GitHub:
pip install git+https://github.com/colin-nolan/patchwork-docker@master#egg=patchworkdocker
Up-to-date usage information can be seen with:
patchworkdocker --help
patchworkdocker build --help
This work is in no way related to the company that I work for.