sds

Envoy's v1 Service Discovery Service API and v2 Endpoint Discovery Service API. In contrast of https://github.com/lyft/discovery, the sds allow users to serve multiple application instances of single service in single host instance (with single ip address).

Maintenance notice

This project is no longer maintained.

Endpoints

v1 SDS

GET /v1/registration/:name/

Responses v1 SDS data: https://www.envoyproxy.io/docs/envoy/v1.8.0/api-v1/cluster_manager/sds

v2 EDS

POST /v2/discovery:endpoints

Accepts v2 DiscoveryRequest, then responses v2 DiscoveryResponse.

Registration

POST /v1/registration/:name/

Request body

{
  ip: String,
  port: u16,
  revision: String,
  tags: {
    az: String,
    region: String,
    instance_id: String,
    canary: bool,
    load_balancing_weight: Option<u8>,
  },
}

Responses 202 on success, 400 on bad requests, 500 for internal server errors.

Deregistration

DELETE /v1/registration/:name/:ip_addr_and_port/

e.g. DELETE /v1/registration/user_service/10.0.0.10:34005/

Responses 202 on success, 400 on bad requests, 500 for internal server errors, and response 400 with JSON message when the entry not found:

{
  "id": "HostNotFound",
  "reason": "Not found the entry"
}

Environment variables

AWS_DEFAULT_REGION: AWS region like us-east-1
DDB_TABLE: DynamoDB's table name
HOST_TTL: the TTL of the DynamoDB's entries
PORT: the listen port
CORE_THREADS: the maximum number of worker threads (optional)
- See https://docs.rs/tokio/0.1/tokio/runtime/struct.Builder.html#method.core_threads
DDB_TIMEOUT_SEC: the timeout of DynamoDB APIs (optional)

Createing DynamoDB table

Create with PK: service as String and ip_port as String
Set TTL setting using expire_time key

IAM permissions

DynamoDB's query, put_item, delete_item

cookpad/sds

sds