improbable-eng/go-srvlb

Name: go-srvlb

Owner: Improbable Engineering

Description: DNS SRV Load Balancer for gRPC

Created: 2016-11-29 09:48:28.0

Updated: 2018-01-15 02:41:10.0

Pushed: 2018-01-10 17:35:45.0

Homepage: null

Size: 24

Language: Go

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Go gRPC DNS SRV Load Balancer

Go Report Card GoDoc Apache 2.0 License Build Status

A gRPC naming.Resolver that uses DNS SRV. This allows you to do simple client-side Round Robin load balancing of gRPC requests.

Usage

= grpc.RoundRobin(grpcsrvlb.New(srv.NewGoResolver(2 * time.Second)))
, err := grpc.Dial("grpc.my_service.my_cluster.internal.example.com", grpc.WithBalancer(rr))

This will resolve the DNS SRV address grpc.my_service.my_cluster.internal.example.com using the Golang DNS resolver with an assumed TTL of 2 seconds and use that as a set of backends for the gRPC RoundRobin policy. From this point on all requests on the conn (reusable across gRPC clients) will be load balanced to a set of these backends.

Status

This is alpha software. It should work, but key components are missing:

License

go-srvlb is released under the Apache 2.0 license. See the LICENSE file for details.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.