The build/ directory contains the Ægir Docker image build files. These are used to build container images on which we base our localdev environment, but also (via common Ansible roles) environments in which production Aegir instances run.
Docker and DDEV are required; install them if you’ve not already done so.
To begin building these, you’ll need to install a few things via Drumkit:
. d # If Drumkit is not already bootstrapped.
make ansible-playbook ansible-galaxy packer packer-plugins
You can run a private Docker registry on your local machine to iterate quicker and avoid pushing potentially broken images to the remote registry by running:
make start-local-registry
This will also configure DDEV to use the local registry instead of the remote one. To remove the local registry and revert DDEV back to pulling from the remote, run:
make remove-local-registry
Note that this will destroy the local registry including the images in it. To stop it without destroying, run:
make stop-local-registry
It’s as easy as:
make ci-images
This will push the images to the local registry if that’s active, and only
attempts to push to the remote if the local registry isn’t active. If you need
to build just one or two images, you can provide a space-separated list as the
DOCKER_IMAGES parameter:
make ci-images DOCKER_IMAGES='docker/image1 docker/image2'
The full list of images can be found in
drumkit/mk.d/20_ci.mk.