This is a simple gRpc Service for inter systems communication implemented in Golang. The service implements a Server which responds to requests made by a remote Client (system). gRpc makes possible to build fast and agnostic communication between systems, and are great for constant database storage, ingestion and digestion of data, fast inter-systems communication, etc.
Golang is a very fast compiled language that is great for building microservices and APIs. gRpc is a great tool for building fast and agnostic communication between systems. This project is a simple gRpc Service that implements a Server which responds to requests made by a remote Client (system). The service simply echo the paylad received from the client. For human observability, the client send a payload each second, but in production the payload can be send very fast without errors. The purpose of this project is to demonstrate how to build a gRpc Service in Golang.
To install this project, you need to have Golang installed in your machine. You can download it here. After installing Golang, you need to clone this repository into some directory in your machine. To do so, open your terminal and run the following command:
git clone https://github.com/miguelamello/go-grpc-service.git
To begin testing the GRpc server and the GRpc client in your localhost is very simple. First, you need to run the server. To do so, open a terminal window and run the following command:
cd ~/go-grpc-service/server
PS: I'm assuming you have a 64bit system, and so you can find the right binary to execute.
- If you are using Linux, you need to run
./server_linux - If you are using Mac, you need to run
./server_mac - If you are using Windows, you need to run
./server_windows.exe
PS: If you have a diferent Operational System and/or a different architecture, as a last resort you can run go run server.go. This will run the server using the Golang runtime. But you need to have Golang installed in your machine.
After running the server, you need to run the client. To do so, open a new terminal window and run the following command:
cd ~/go-grpc-service/client
PS: I'm assuming you have a 64bit system, and so you can find the right binary to execute.
- If you are using Linux, you need to run
./client_linux - If you are using Mac, you need to run
./client_mac - If you are using Windows, you need to run
./client_windows.exe
PS: If you have a diferent Operational System and/or a different architecture, as a last resort you can run go run client.go. This will run the client using the Golang runtime. But you need to have Golang installed in your machine.
Immediately you should see the server and the client communicating. The client will send a payload to the server every second and the server will respond with the received payload by the client. You can stop the server and the client by pressing CTRL + C in the terminal.
Despite being simple, this project demonstrates the power of Golang and gRpc for building fast and agnostic communication between systems. This project can be used as a base for building more complex gRpc Services. Feel free to use it as you wish. One nice thing about this implementation is that the client executable can be run in any machine, as long as it can reach the server machine. This is because the client executable is statically linked. This means that the executable contains all the dependencies it needs to run. This is great for building microservices and APIs that can be deployed in any machine without the need to install dependencies. client executable can be replicated in any number of machines and they will all work as expected. This is great for scaling purposes.
Another key feature of Golang gRpc implementation is that you can create any tooling needed to solve a problem. Once the gRpc server implementation is done, you can start creating the business logic of your application. You can create a CLI tool, a web application, a mobile application, etc. The possibilities are endless.
This project is not production ready. It is just a simple implementation of a gRpc Service in Golang. It is not recommended to use this project in production. Despite it is completely functional, it is not optimized for production. It is just a simple implementation for demonstration purposes.
If a production ready gRpc Service is needed, you can contact me at [email protected] and I can build it for you. Feel free to contact me.