go-fx-grpc-starter

About

Boilerplate code to kickstart grpc projects with uber/fx and uber/zap logger

It can be run by providing an implementation of FxGrpcServerDefinition that registers the services

// main.go
func main() {
	fxapp.StartApp(
		fxgrpc.Module,
		fx.provide(NewServiceDefinitionProvider),
	)
}

By default GRPC server runs on localhost:9090, it can be overridden via environment variables APP_FX_GRPC_HOST and APP_FX_GRPC_PORT

Example project using the boiler can be found at https://github.com/srlk/go-fx-grpc-hello-world

Environment

Below environment variables are used by the started

Running via HTTPS

To run via HTTPS a certificate and private key should be generated.

To create a self signed certificate and private key

 openssl req -x509  \
  -sha256 -nodes -days 365  \
  -newkey rsa:2048  \
  -keyout private.key  \
  -out certificate.crt \

And then provide contents of certificate and private key as environment variable

export APP_FX_GRPC_TLS_CERT=$(awk 'NF {sub(/\r/, ""); printf "%s\\n",$0;}'  certificate.crt)

export APP_FX_GRPC_TLS_KEY=$(awk 'NF {sub(/\r/, ""); printf "%s\\n",$0;}'  private.key)