Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gliderlabs/registrator
Service registry bridge for Docker with pluggable adapters
https://github.com/gliderlabs/registrator
consul docker service-discovery
Last synced: 21 days ago
JSON representation
Service registry bridge for Docker with pluggable adapters
- Host: GitHub
- URL: https://github.com/gliderlabs/registrator
- Owner: gliderlabs
- License: mit
- Created: 2014-07-22T20:36:02.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-05-18T11:26:59.000Z (6 months ago)
- Last Synced: 2024-10-01T23:23:44.252Z (about 1 month ago)
- Topics: consul, docker, service-discovery
- Language: Go
- Homepage: http://gliderlabs.com/registrator
- Size: 22.8 MB
- Stars: 4,661
- Watchers: 148
- Forks: 912
- Open Issues: 263
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome - gliderlabs/registrator - Service registry bridge for Docker with pluggable adapters (Go)
- my-awesome - gliderlabs/registrator - discovery pushed_at:2024-05 star:4.7k fork:0.9k Service registry bridge for Docker with pluggable adapters (Go)
- awesome-repositories - gliderlabs/registrator - Service registry bridge for Docker with pluggable adapters (Go)
- awesome-consul - registrator: Service registry bridge for Docker with pluggable adapters
- awesome-docker - registrator - Service registry bridge for Docker by [@gliderlabs][gliderlabs] and [@progrium][progrium] (Container Operations / Service Discovery)
- awesome-list-docker - registrator
- awesome-docker - registrator - Service registry bridge for Docker by [@gliderlabs][gliderlabs] and [@progrium][progrium] (Container Operations / Service Discovery)
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