A service to add docker containers to consul for service discovery
-h/--help - print usage summary -o/--once - non-daemon mode, run once and exit -d/--daemon - daemon mode: poll docker for new services and register them -e/--environment - environment --debug - enable debug output
This script will poll 'docker ps' for entries and add them to consul via API. It uses the image name to populate the consul service name (plus tags, see below) and parses forwarded ports to present in consul.
Run this under something like supervisor as a 'background' process.
You can run this under something like cron
For repo/foo:latest, dockingstation would turn repo and latest into tags for name foo. You can also pass dockingstation -e to add an environment tag To support multiple services you'll need to create a port map under: http://localhost:8500/v1/kv/service/[name]/ports that looks something like this:
{
"18001": "service" ,
"8056": "admin"
}
Where the key is the DOCKER port (since the docker port will be consistent, whereas you might be using dynamic ports on the docker side) The value for the port mapping will be appended to the name: For example, if your image is repo/foo:latest and the docker port is 18001, the name of the service in cosul would be: foo-service
You can register checks via the consul KV store. checks should map to: http://localhost:8500/v1/kv/service/[name]/checks/[service as mapped above] If your check needs to point to a specific port, you can use jinja formatting for this template.
format maps to: https://www.consul.io/docs/agent/checks.html, minus the initial 'check' root
Example:
{
"id": "api",
"name": "HTTP API on port 5000",
"http": "http://localhost:{{ checkport }}/health",
"interval": "10s",
"timeout": "1s"
}