m3adow/registrator_consul_kv repository overview

⁠Registrator

This version includes PR #261⁠ (Added support for storing service attributes in the Consul KV store). Apart from that it's not changed. To utilize the KV store of consul add a 'prefix=someprefix' URL parameter to the consul:// URL like that:

/usr/bin/docker run -ti --rm --name=registrator -h registrator \
-v /var/run/docker.sock:/tmp/docker.sock m3adow/registrator_consul_kv \ 
consul://consul_server:8500?prefix=registrator

Service registry bridge for Docker, sponsored by Weave⁠.

Registrator automatically registers and deregisters services for any Docker container by inspecting containers as they come online. Registrator supports pluggable service registries, which currently includes Consul⁠, etcd⁠ and SkyDNS 2⁠.

Full documentation available at http://gliderlabs.com/registrator⁠

⁠Getting Registrator

Get the latest release, master, or any version of Registrator via Docker Hub⁠:

$ docker pull gliderlabs/registrator:latest

Latest tag always points to the latest release. There is also a :master tag and version tags to pin to specific releases.

⁠Using Registrator

The quickest way to see Registrator in action is our Quickstart⁠ tutorial. Otherwise, jump to the Run Reference⁠ in the User Guide. Typically, running Registrator looks like this:

$ docker run -d \
    --name=registrator \
    --net=host \
    --volume=/var/run/docker.sock:/tmp/docker.sock \
    gliderlabs/registrator:latest \
      consul://localhost:8500

⁠Contributing

Pull requests are welcome! We recommend getting feedback before starting by opening a GitHub issue⁠ or discussing in Slack⁠.

Also check out our Developer Guide on Contributing Backends⁠ and Staging Releases⁠.

⁠Sponsors and Thanks

Ongoing support of this project is made possible by Weave⁠, the easiest way to connect, observe and control your containers. Big thanks to Michael Crosby for skydock⁠ and the Consul mailing list for inspiration.

For a full list of sponsors, see SPONSORS⁠.

⁠License

MIT