legion-discovery

A discovery service based on Legion. https://github.com/owensmurray/legion-discovery#readme

Latest on Hackage:1.0.0.0

This package is not currently in any snapshots. If you're interested in using it, we recommend adding it to Stackage Nightly. Doing so will make builds more reliable, and allow stackage.org to host generated Haddocks.

Apache-2.0 licensed by Rick Owens
Maintained by rick@owensmurray.com

legion-discovery

A simple service discovery service based on Legion, that natively supports the idea of interface versions, and the idea that clients may only be interested in finding certain (compatible) versions of the services they are looking for.

The initial motivation for this project is to act as a test driver for the Legion framework. Since the status of that framework is still experimental, the status of this service is also experimental.

API

POST /v1/ping

Register a service. The service name and version are obtained via the User-Agent header field. Registration expires in 30 seconds.

  • Request
  • Response 204 No Content: indicates a successful registration.

GET /v1/services/:serviceId

Returns all current instances of a service, regardless of version.

GET /v1/services/:serviceId/:versionRange

Returns the service instances that match the requested version range. The version range syntax is the same as what cabal understands (e.g. >= 0.1 && < 0.2). You are really going to want to make sure and url encode this segment of the url.

GET /v1/graph

Returns a visualization of the service interactions. This endpoint supports multiple content types via the Accept header.

Content Types

application/vnd.legion-discovery.instance-list+json

{
    "https://host1:8080": {
        "version": "1.0.2.0"
    },
    "https://host2:8080": {
        "version": "1.0.2.0"
    },
    "https://host3:8080": {
        "version": "1.0.2.0"
    }
}

application/vnd.legion-discovery.ping-request+json

{
    "serviceAddress": "https://host3:8080"
}
comments powered byDisqus