/tiller

A dynamic configuration file generation tool, particularly useful with Docker containers

Primary LanguageRubyOtherNOASSERTION

What is it?

Tiller is a tool that generates configuration files. It takes a set of templates, fills them in with values from a variety of sources (such as environment variables, Consul, YAML files, JSON from a webservice...), installs them in a specified location and then optionally spawns a child process.

You might find this particularly useful if you're using Docker, as you can ship a set of configuration files for different environments inside one container, and/or easily build "parameterized containers" which users can then configure at runtime.

However, its use is not just limited to Docker; you may also find it useful as a sort of "proxy" that can provide values to application configuration files from a data source that the application does not natively support.

It's available as a Ruby Gem, so installation should be a simple gem install tiller.

Gem Version Build Status Join the chat at https://gitter.im/markround/tiller Documentation Status

Documentation

The main documentation has been updated and a searchable, easy to read version is now hosted on readthedocs.io. You can also read the raw markdown files by browsing the docs directory in this repository.

You may like to read the Quickstart guide if you want a very quick overview.

There is also a Gitter chatroom for you to ask any questions, suggest new features and talk to other users.

Status

Please see the status of the original project under https://github.com/markround/tiller#status

Currently, iam trying to keep the fork alive by patching ruby compatibility and bugs that cause issues for us. Happy to review PR's for bug-fixes, feature-requests or PRs for features are most likely to never get merged. This fork is considered to be the bare minimum effort to keep it alive and stable.

Credits

All the credits to https://github.com/markround