Doorkeeper for consul discovered services.
Project description
ianitor
ianitor is a doorkeeper for your services discovered using consul. It can automatically register new services through consul API and manage TTL health checks.
It provides simple shell command that wraps process and can be simply used in your existing process/service supervision tool like supervisord, circus, runit etc.
Consul/Python versions compatibility
ianitor is compatibile with Python 2.7, 3.3, 3.4, and 3.5 versions. It is also tested against each latest patch version of every major/minor consul release starting from 0.4.1 version.
For details of our test matrix see travis.yml
file.
Installation and usage
Simply install with pip:
$ pip install ianitor
And you're ready to go with:
$ ianitor appname -- ./yourapp --some-switch
You can check if service is registered diggin' into consul DNS service:
$ dig @localhost -p 8600 appname.service.consul
; <<>> DiG 9.9.3-P1 <<>> @localhost -p 8600 appname.service.consul
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 25966
;; flags: qr aa rd; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0
;; WARNING: recursion requested but not available
;; QUESTION SECTION:
;appname.service.consul. IN A
;; ANSWER SECTION:
appname.service.consul. 0 IN A 10.54.54.214
;; Query time: 44 msec
;; SERVER: 127.0.0.1#8600(127.0.0.1)
;; WHEN: Tue Oct 28 13:53:09 CET 2014
;; MSG SIZE rcvd: 78
Full usage:
usage: ianitor [-h] [--consul-agent hostname[:port]] [--ttl seconds]
[--heartbeat seconds] [--tags tag] [--id ID] [--port PORT] [-v]
service-name -- command [arguments]
Doorkeeper for consul discovered services.
positional arguments:
service-name service name in consul cluster
optional arguments:
-h, --help show this help message and exit
--consul-agent=hostname[:port] set consul agent address
--ttl=seconds set TTL of service in consul cluster
--heartbeat=seconds set process poll heartbeat (defaults to
ttl/10)
--tags=tag set service tags in consul cluster (can be
used multiple times)
--id=ID set service id - must be node unique
(defaults to service name)
--port=PORT set service port
-v, --verbose enable logging to stdout (use multiple times
to increase verbosity)
How does ianitor work?
ianitor spawns process using python's subprocess.Popen()
with command line
specified after --
. It redirects its own stdin to child's stdin and
childs stdout/stderr to his own stdout/stderr.
This way ianitor does not interfere with logging of managed service if it logs to stdout. Moreover ianitor does not log anything to make it easier to plug it in your existing process supervision tool.
ianitor handles service registration in consul agent as well as keeping registered service entry in consul in "healthy" state by continously requesting it's TTL health check endpoint.
Example supervisord config
Assuming that you have some service under supervisord supervision:
[program:rabbitmq]
command=/usr/sbin/rabbitmq-server
priority=0
autostart=true
Simply wrap it with ianitor call:
[program:rabbitmq]
command=/usr/local/bin/ianitor rabbitmq -- /usr/sbin/rabbitmq-server
priority=0
autostart=true
Licence
ianitor
is licensed under LGPL license, version 3.
Contributing and reporting bugs
Source code is available at: ClearcodeHQ/ianitor. Issue tracker is located at GitHub Issues. Projects PyPi page.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file ianitor-0.1.0.tar.gz
.
File metadata
- Download URL: ianitor-0.1.0.tar.gz
- Upload date:
- Size: 7.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 379c4831387b8124ad4259197275635baf70ab32d395f1d88aea778d183ba484 |
|
MD5 | 16cd0d5d704ab5ccff436f0575f9b6cb |
|
BLAKE2b-256 | 3e10012209b1e64f44e9fcd3fec93135ab7908f0920fa2b9145017038259433c |
File details
Details for the file ianitor-0.1.0-py2.py3-none-any.whl
.
File metadata
- Download URL: ianitor-0.1.0-py2.py3-none-any.whl
- Upload date:
- Size: 9.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 264eb38dcfa9b9172c311b314333f547229581b7b8fbbcc01ceaf0d3d1c73e85 |
|
MD5 | 7f17fa4508482bf71a4c9748a70dd5c9 |
|
BLAKE2b-256 | a880b89c946d8808448a3d81470b8218fbb214e8adeb4390d6b8e3b6797f1e8c |