Skip to main content

A python tool which adds Rancher services to Consul based on label selectors

Project description

Rancon (aka rancher-consul)

We use consul as a service discovery mechanism, and a Consul-template / HAProxy combination to route traffic into our services. This python script is a helper to automatically enter Rancher services into Consul based on Rancher label selectors, so they can picked up by the load HAProxy load balancing layer.

This might not be of any use to anybody but me, but I’ll make it public anyway because I did not find another solution so I had to write it, and maybe someone else has the same problem.



Date: 2017-01-03

  • FIX: Service tag replacment exception


Date: 2017-01-03

  • FEATURE: Add “web interface” (basically only for metrics and health check)

  • FEATURE: Add health check under /health

  • FEATURE: Add prometheus metrics under /metrics

  • CHANGE: Deregistration behavior for services which failed registration (was: unregister, is now: keep)


Date: 2016-06-15

  • CHANGE: convert IDs, tags, names to all lowercase in consul

  • CHANGE: do not allow non-url characters in service IDs (basically nothing but [a-z0-9-])


Date: 2016-06-15

  • BREAKING: -i/--id parameter no longer global, moved to cleanup_id parameter of backend

  • CHANGE: output now logging based, so all to stderr, and -vvvv flags possible

  • FIX: bug in service lookup in Rancher

  • OPEN: https connections


Date: 2016-06-15

  • FEATURE: authentication now used

  • FIX: bug in service lookup in Rancher

  • OPEN: https connections (untested, might work)


Date: 2016-06-09

  • More verbosity during init process


Date: 2016-06-09

  • Unified naming scheme of used environment variables

  • Added convenience script “”

  • Dockerfile fixes

  • Doc fixes


Date: 2016-06-07

  • Initial PyPI release

  • module works, docker setup not tested yet

  • documentation unfinished / not present

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distribution

rancon-0.11.0-py3-none-any.whl (14.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page