https://github.com/abhiyerra/sarpa

Poor Man's Service Discovery and Registration
https://github.com/abhiyerra/sarpa

Last synced: 30 days ago
JSON representation

Poor Man's Service Discovery and Registration

• Host: GitHub
• URL: https://github.com/abhiyerra/sarpa
• Owner: abhiyerra
• License: mit
• Created: 2014-11-27T19:48:43.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2014-12-16T21:33:41.000Z (almost 10 years ago)
• Last Synced: 2024-10-04T04:21:47.390Z (about 2 months ago)
• Language: Go
• Homepage:
• Size: 301 KB
• Stars: 18
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![GoDoc](https://godoc.org/github.com/abhiyerra/sarpa/client?status.svg)](https://godoc.org/github.com/abhiyerra/sarpa/client)

# Sarpa

Sarpa is a poor man's service discovery system. It is made to be used

with Docker instances. So when an Docker instance is started up it

reports itself on etcd with the public ip and port to connect

to. Sarpa watches for these key changes. And updates a file in S3

which has key values of service to machines.

# Running

    export AWS_ACCESS_KEY_ID=

    export AWS_SECRET_ACCESS_KEY=

    export ETCD_HOSTS="http://127.0.0.1:4001"

    export SARPA_BUCKET="discovery.forestly.org"

    ./sarpa

# Etcd Keys

The keys for the discovery looks like the following. It always looks

in the /sarpa directory. The next key is the s3 bucket to push the

configuration file to. The value after that is the service short name.

In that directory you can create children which include the public_host:port

so the clients can connect to them.

    /sarpa/:service/:machine_id

Example:

    etcdctl set /sarpa/treely/1 "http://1.2.3.4:3001"

# Example of a service reporting to sarpa

Here is a an example for treemap. It is a fleet script which runs the

service on a CoreOS cluster.

    [Unit]

    Description=treemap

    [Service]

    ExecStartPre=-/usr/bin/docker pull forestly/treely

    ExecStartPre=-/usr/bin/docker kill treemap-%i

    ExecStartPre=-/usr/bin/docker rm treemap-%i

    ExecStart=/usr/bin/docker run --rm --name treemap-%i -p 3001:3001 forestly/treely

    ExecStartPost=/usr/bin/etcdctl set /sarpa/treemap/%m http://%H:3001

    ExecStop=/usr/bin/docker stop treemap-%i

    ExecStopPost=/usr/bin/etcdctl rm /sarpa/treemap/%m

    [X-Fleet]

    Conflicts=treemap@*.service

# Usage in Javascript

```javascript

   console.log(SarpaServiceDiscovery);

```

# Network Diagram

![Network Diagram](usage.png)