docker-gen is a file generator that renders templates using docker container meta-data.

docker-gen can be used to generate various kinds of files for:

• Centralized logging - fluentd, logstash or other centralized logging tools that tail the containers JSON log file or files within the container.
• Log Rotation - logrotate files to rotate container JSON log files
• Reverse Proxy Configs - nginx, haproxy, etc. reverse proxy configs to route requests from the host to containers
• Service Discovery - Scripts (python, bash, etc..) to register containers within etcd, hipache, etc..

===

Linux binaries for release 0.2.0

• amd64
• i386

Download the version you need, untar, and install to your PATH.

$ wget https://github.com/jwilder/docker-gen/releases/download/0.2.0/docker-gen-linux-amd64-0.2.0.tar.gz
$ tar xvzf tar xvzf docker-gen-linux-amd64-0.2.0.tar.gz
$ ./docker-gen

See jwilder/nginx-proxy trusted build as an example of running docker-gen within a container.

$ docker-gen
Usage: docker-gen [-config file] [-watch=false] [-notify="restart xyz"] [-interval=0] [-endpoint tcp|unix://..] <template> [<dest>]

Options:

• -watch - runs continuously and monitors docker container events. When containers are started or stopped, the template is regenerated.
• -notify - runs a command after the template is generated. Useful for restarting nginx, reloading haproxy, etc..
• -config file - Use the specified config file instead of command-line options. Multiple templates can be defined and they will be executed in the order that they appear in the config file.
• -interval <secs> - Run the notify command on a fixed interval. Useful for service registration use cases.
• -endpoint tcp|unix://.. - Use a different docker remote API endpoint. This can also be set w/ a DOCKER_HOST environment variable.

If no <dest> file is specified, the output is sent to stdout. Mainly useful for debugging.

jwilder/nginx-proxy trusted build.

Start nginx-proxy:

$ docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock -t jwilder/nginx-proxy

Then start containers with a VIRTUAL_HOST env variable:

$ docker run -e VIRTUAL_HOST=foo.bar.com -t ...

$ docker-gen -only-exposed -watch -notify "/etc/init.d/nginx reload" templates/nginx.tmpl /etc/nginx/sites-enabled/default

Automated Nginx Reverse Proxy for Docker

$ docker-gen -watch -notify "restart fluentd" templates/fluentd.tmpl /etc/fluent/fluent.conf

Docker Log Management With Fluentd

$ docker-gen -notify "/bin/bash /tmp/etcd.sh" -interval 10 templates/etcd.tmpl /tmp/etcd.sh

This project uses godep for managing 3rd party dependencies. You'll need to install godep into your workspace before hacking on docker-gen.

$ git clone <your fork>
$ godep restore
$ make

• Add event status for handling start and stop events differently
• Add a way to filter out containers in templates