grproxy

README

grproxy

GRPC proxy to inspect, record, and reply requests

Note: Currently only support inspecting request and response

$ ./grproxy -addr "127.0.0.1:9999" -target "127.0.0.1:10000"

Arguments

• addr local address of the proxy
• target upstream (backend) of the GRPC server to forward to

Running with docker

$ docker run --rm -it -p 9999:9999 yulrizka/grproxy:latest -target "host.docker.internal:10000"

host.docker.internal will be translated by docker to the host IP address as a workaround since OSX or Windows does not support --net=host. This is if you bind remote GRPC server to your local machine (localhost). See example below.

Example

Say that you are running a GRPC service FooService on remote kubernetes port 10000.

To debug it, first you need to forward the service port to localhost

$ kubectl port-forward svc/strawberry-core 10000:10000

At this point you will have the original GRPC server running on port 10000 locally.

Start the proxy on port 9999

$ docker run --rm -it -p 9999:9999 yulrizka/grproxy:latest -target "host.docker.internal:10000"

This will open the proxy on port 9999 on your host machine that forward the request to localhost:10000

In your app, you can start using the proxy

# example listing all methods with grpcurl
$ grpcurl -plaintext localhost:9999 list

Fooservice
grpc.reflection.v1alpha.ServerReflection

Documentation

Index

• type Proxy
  • func NewInterceptor(targetAddr string) *Proxy
  • func (p *Proxy) Serve(ctx context.Context, l net.Listener) error

Types

type Proxy

type Proxy struct {
	// contains filtered or unexported fields
}

func NewInterceptor

func NewInterceptor(targetAddr string) *Proxy

func (*Proxy) Serve

func (p *Proxy) Serve(ctx context.Context, l net.Listener) error

Serve proxy request. This will start a grpc server and start collecting upstream services and method and create a stub method that will intercept the message, send it to upstream, and forward the reply to the client