Building a Competition

Once you’re satisfied with your configuration, you can build a container image from your configuration. For Basalt to build the image for you, you will need to have the Docker daemon running on your system.

basalt build <file>

Or if you’d like to manually tag the image:

basalt build -t my-competition <file>

After the build process completes, you should see your image in the output when running docker images. If you didn’t manually provide a tag, the image will be tagged with bslt-<config-hash>.

Output TAR

If you would rather we just give you a tarball artifact with everything required to build the image instead, that can be done too by specifying an output file.

basalt build -o my-competition.tar <file>

This can be useful if you want to build with Podman or some other tool instead of Docker. You can also inspect all of the files that are used to build your container for debugging purposes. Advanced users may also want to modify pieces of the generated files.

Caution

We cannot guarantee a manually modified Basalt competition artifact will run as expected. Here be dragons.