go-grpc-test

Go GRPC Test

• sample DNS client and server apps

See dns/dns.proto for request and response.

Overview Diagram

sequenceDiagram
    autonumber
    participant client
    participant server
    client->>server: request (domain)
    activate server
    note right of server: check domain in cache
    server->>client: response (status, ip)
    deactivate server
    note left of client: use ip if status = RESOLVED

Loading

Set up

• Install protocol buffers compiler (protoc)

• Install protocol buffers and GRPC plugins:

  go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.28
  go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.2

  Update GOPATH:

  export PATH="$PATH:$(go env GOPATH)/bin"

• Generate protocol buffers and GRPC files:

  protoc \
    --go_out=. \
    --go_opt=paths=source_relative \
    --go-grpc_out=. \
    --go-grpc_opt=paths=source_relative \
    dns/dns.proto

  Following files are generated:

  • dns/dns.pb.go
  • dns_grpc.pb.go

  The generated files are already under dns directory.

Build

go mod download
go build -o dns-server server/main.go
go build -o dns-client client/main.go

Run

Run server in a separate terminal (as it blocks):

$ ./dns-server
staring DNS GRPC server on 0.0.0.0:9000
gRPC server started listening on 0.0.0.0:9000

Run client from a different terminal:

$ ./dns-client --domain "domain.xyz"
192.168.0.0

License

MIT