DEPRECATION WARNING

2020-01-30

Use of these docker images/templates is not recommended for any new/migrating services.

The code in this repository is not being actively maintained.

The images in this repository are quite "heavyweight", and rely on ONBUILD triggers which make it harder to understand exactly what is going on.

Instead, it is recommended that you try to keep your Dockerfiles and docker images as lightweight and simple as possible, e.g. by starting with the alpine version of the standard image for your development language (for example, FROM ruby:2.6.2-alpine), and only adding what you actually need.

MoJ Docker Templates

This repo contains Dockerfiles for basing project specific docker images from.

Building the docker images

./make.sh in the top level directory will build all the images contained in this repo

Using images on other hosts

If you want to use these images on another host the easiest way to do it is to run a registry and then use the registry tagged form of the FROM line:

FROM docker.local:5000/moj-base

# ...

Setting up a docker registry

Taken from https://github.com/dotcloud/docker-registry

docker run \
         -e SEARCH_BACKEND=sqlalchemy \
         -p 5000:5000 \
         --detach \
         registry

Then add an alias of docker.local pointing to 127.0.0.1

echo "127.0.0.1 docker.local" | sudo tee -a /etc/hosts

Pushing images

To push an image to a custom registry you have to tag it with url/name, i.e. for the moj-base image, we need to retag it

First find out the image id:

$ docker images
REPOSITORY                                   TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
moj-base                                     latest              40f553624b6d        About an hour ago   508.1 MB
registry                                     latest              6e526128fd5b        4 weeks ago         553.1 MB
phusion/baseimage                            0.9.9               745d3ac92697        3 months ago        345.8 MB

Then tag it with the registry prefix:

$ docker tag moj-base docker.local:5000/moj-base

And finally push it up to the registry: