Skip to content

Service registry bridge for Docker with pluggable adapters

License

Notifications You must be signed in to change notification settings

psyhomb/registrator

This branch is 1 commit ahead of, 4 commits behind gliderlabs/registrator:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

71bee28 · Sep 22, 2021
Jun 14, 2017
Sep 22, 2021
Nov 26, 2019
Feb 8, 2016
Nov 26, 2019
Feb 10, 2016
Nov 26, 2015
Apr 19, 2016
Apr 15, 2019
Apr 15, 2019
Sep 22, 2021
Sep 22, 2021
Jul 12, 2018
Sep 20, 2016
Aug 6, 2015
Feb 14, 2017
Sep 22, 2021
Oct 24, 2015
Sep 22, 2021
Sep 22, 2021
Sep 22, 2021
Aug 12, 2015
Jan 4, 2016
Sep 22, 2021

Repository files navigation

Registrator

Service registry bridge for Docker.

Circle CI Docker pulls IRC Channel

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

CLI Options

Usage of /bin/registrator:
  /bin/registrator [options] <registry URI>

  -cleanup=false: Remove dangling services
  -deregister="always": Deregister exited services "always" or "on-success"
  -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 (supports Go template)
  -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 or discussing in Slack.

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

Sponsors and Thanks

Big thanks to Weave for sponsoring, Michael Crosby for skydock, and the Consul mailing list for inspiration.

For a full list of sponsors, see SPONSORS.

License

MIT

About

Service registry bridge for Docker with pluggable adapters

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 97.4%
  • Makefile 1.7%
  • Dockerfile 0.9%