EdCornejo / microservices-kotlin-grpc

Kotlin microservices with REST, and gRPC using BFF pattern. This repository contains backend services. Everything is dockerized and ready to "Go" actually "Kotlin" :-)

Microservices Kotlin gRPC

Only the Go Version is deploy, due to EC2 bills :) You can run images locally.

This repo contains microservices written in Kotlin with BFF pattern for performing CRUD operations.

See Also

• Go Version
• Java Spring Version

Installation

Clone the repository

git clone https://github.com/uid4oe/microservices-kotlin-grpc.git

You should have Docker installed beforehand.

.env is included. You just need to create network & execute docker-compose command

docker network create uid4oe
docker-compose up -d

At this point everything should be up and running! You can access to UI at

http://localhost:3000/kotlin

Additionally, you may take a look at Microservices gRPC UI for UI code.

Local Development

For running services in local environment you will need a MongoDB & PostgreSQL instance, you can use local.yml It will set up MongoDB, PostgreSQL and UI.

docker network create uid4oe
docker compose --file local.yml up -d

Do not forget to add above VM argument to every service.

-Dspring.profiles.active=develop

Also, for each service add grpc-java & java & kotlin folders as Sources in File->Project Structure. This will allow IDE to see the generated gRPC classes.

You can start using the app through UI at

http://localhost:3000/kotlin

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.