Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gliderlabs/registrator

Service registry bridge for Docker with pluggable adapters
https://github.com/gliderlabs/registrator

consul docker service-discovery

Last synced: 25 days ago
JSON representation

Service registry bridge for Docker with pluggable adapters

Awesome Lists containing this project

README 

        
# Registrator



Service registry bridge for Docker.



[![Circle CI](https://circleci.com/gh/gliderlabs/registrator.png?style=shield)](https://circleci.com/gh/gliderlabs/registrator)

[![Docker pulls](https://img.shields.io/docker/pulls/gliderlabs/registrator.svg)](https://hub.docker.com/r/gliderlabs/registrator/)

[![IRC Channel](https://img.shields.io/badge/irc-%23gliderlabs-blue.svg)](https://kiwiirc.com/client/irc.freenode.net/#gliderlabs)






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](http://www.consul.io/), [etcd](https://github.com/coreos/etcd) and

[SkyDNS 2](https://github.com/skynetservices/skydns/).



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



## Getting Registrator



Get the latest release, master, or any version of Registrator via [Docker Hub](https://registry.hub.docker.com/u/gliderlabs/registrator/):



	$ 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](https://gliderlabs.com/registrator/latest/user/quickstart)

tutorial. Otherwise, jump to the [Run

Reference](https://gliderlabs.com/registrator/latest/user/run) 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



## CLI Options

```

Usage of /bin/registrator:

  /bin/registrator [options] 



  -cleanup=false: Remove dangling services

  -deregister="always": Deregister exited services "always" or "on-success"

  -explicit=false: Only register containers which have SERVICE_NAME label set

  -internal=false: Use internal ports instead of published ones

  -ip="": IP for ports mapped to the host

  -resync=0: Frequency with which services are resynchronized

  -retry-attempts=0: Max retry attempts to establish a connection with the backend. Use -1 for infinite retries

  -retry-interval=2000: Interval (in millisecond) between retry-attempts.

  -tags="": Append tags for all registered services

  -ttl=0: TTL for services (default is no expiry)

  -ttl-refresh=0: Frequency with which service TTLs are refreshed

```



## Contributing



Pull requests are welcome! We recommend getting feedback before starting by

opening a [GitHub issue](https://github.com/gliderlabs/registrator/issues) or

discussing in [Slack](http://glider-slackin.herokuapp.com/).



Also check out our Developer Guide on [Contributing

Backends](https://gliderlabs.com/registrator/latest/dev/backends) and [Staging

Releases](https://gliderlabs.com/registrator/latest/dev/releases).



## Sponsors and Thanks



Big thanks to Weave for sponsoring, Michael Crosby for

[skydock](https://github.com/crosbymichael/skydock), and the Consul mailing list

for inspiration.



For a full list of sponsors, see

[SPONSORS](https://github.com/gliderlabs/registrator/blob/master/SPONSORS).



## License



MIT