GRPC Starter API

Description

GRPC Starter API is a GRPC microservice that provides a simple and secure way to access GRPC Starter. Build with monorepo, it is easy to use and easy to maintain.

It comes pre-configured with :

1. Google Cloud Error Reporting (https://cloud.google.com/go/errorreporting)
2. Google Cloud Profiler (https://cloud.google.com/go/profiler)
3. Google Pub Sub(https://cloud.google.com/go/pubsub)
4. JWT GO (https://github.com/dgrijalva/jwt-go)
5. Go Mock (https://github.com/golang/mock)
6. Redis (https://github.com/gomodule/redigo)
7. Google UUID (https://github.com/google/uuid)
8. GRPC (https://google.golang.org/grpc)
9. GRPC Gateway(https://github.com/grpc-ecosystem/grpc-gateway/v2)
10. GRPC OpenTracing (https://github.com/grpc-ecosystem/grpc-opentracing)
11. GRPC Middleware (https://github.com/grpc-ecosystem/go-grpc-middleware)
12. Protocol Buffers (https://google.golang.org/protobuf)
13. Protoc Gen Validate (https://github.com/envoyproxy/protoc-gen-validate)
14. Prometheus (https://github.com/grpc-ecosystem/go-grpc-prometheus)
15. GORM (https://gorm.io/gorm)
16. PGX Postgres (https://github.com/jackc/pgx/v4)
17. ENV Decode(https://github.com/joeshaw/envdecode)
18. Godotenv (https://github.com/joho/godotenv)
19. Mailgun (https://github.com/mailgun/mailgun-go/v4)
20. Sendgrid (https://github.com/sendgrid/sendgrid-go)
21. Testify (https://github.com/stretchr/testify)

Setup

Use this command to install the blueprint

go get github.com/rifqiakrm/grpc-starter

or manually clone the repo.

Owner

GITS.ID

How to Run

• Read Prerequisites.
• Then, read How to Run.

Development Guide

• Read Prerequisites.
• Then, read Development Guide.

Test

Unit Test

$ make tidy
$ make cover

Integration Test / API Test

To run integration test, we need to start all dependencies needed. We provide all dependencies via Docker Compose. Make sure to install Docker Compose before running integration test.

Also, we need to build the docker image for grpc-starter first.

$ make compile-server
$ make docker-build-server

After that, run all images needed using docker-compose and run the integration test.

$ docker-compose up
$ make test.integration

Deployment

Read Deployment.

Staging

TBD

Production

TBD

Postman Collection

Staging

TBD

Production

TBD

FAQs

• Read FAQs