weahead/conf repository overview

⁠We ahead's configuration container

This container is used for providing configuration files generated with confd⁠ for other containers via volumes.

This image uses Rancher's Metadata Service⁠ as a backend for confd. When deployed on Rancher⁠ it will properly use Ranchers Metadata service, if it is unavailable due to deployment elsewhere (like during development) it will start its own metadata service based on a release of Rancher Metadata⁠.

Both confd and Rancher metadata run as non-root user inside the container.

⁠How to use

• Create a folder structure that looks like root⁠.
• Add template resources⁠
• Add templates⁠
• Add a file named Dockerfile that looks like this:

FROM weahead/conf:3.0.3

VOLUME /usr/local/etc/<name>

Make sure your template resources are output to the volume location specified in your Dockerfile.

Build it.

⁠How to use the built in Rancher metadata

• Create a YAML file and make it available at /answers.yml inside the container.
• Edit it to suite your needs.

See example: answers.example.yml⁠

⁠A note on Docker Hub

The above Dockerfile can be made even simpler by using Dockers ONBUILD and ARG instructions together, leaving just the FROM instruction. Unfortunately the Docker Hub is still running 1.8, which does not support the ARG instruction. There is an issue tracking the support for 1.9 features on Docker Hub, #460⁠

⁠License

X11⁠