TNTGRPC is a tool for creating grpc C++ library for Tarantool application server. This example explains how to use GRPC generator for Tarantool application server.

First, we need to build tntgrpc image.

git clone https://github.com/jonywtf/tntgrpc.git
cd ./tntgrpc
./build.sh

cd ./example

Start tarantool GRPC server

Remove grpc library 'mytntgrpclib.so' and docker container if exists.

rm -rf mytntgrpclib.so; docker rm mytarantool

On the step we are trying to generate mytntgrpclib.so from helloworld.proto file. We need only *.proto files to generate native library 'mytntgrpclib.so'. We can use docker container from 'tntgrpc' image for this. We can specify library name ('mytntgrpclib' in this example). Also we must share two folders with proto files and output path for the container. '/proto' path is a directory where grpc tool takes proto files (helloworld.proto) '/output' path is a directory where grpc tool saves tarantool native library (mytntgrpclib.so)

docker run -it \
    -v $(pwd):/proto \  # our proto files is here
    -v $(pwd):/output \ # output files
    tntgrpc \
    --name=mytntgrpclib helloworld.proto

Ok, now we have 'mytntgrpclib.so' and we can use it for GRPC service inside Tarantool. We need share port 3301 for tarantool and 50051 for grpc, also we must share current folder for tarantool because lua code (app.lua) and grpc lib (mytntgrpclib.so) are here. On this step we don't need *.proto files anymore. Only lua code and native library are required. If you need you can use it in different way of course.

docker run --name mytarantool -it \
    -p3301:3301 -p50051:50051 \
    -v $(pwd):/opt/tarantool \
    tarantool/tarantool:2 \
    tarantool /opt/tarantool/app.lua

All the steps in ./run_server.sh

Start GRPC client

We should build GRPC client for Tarantool GRPC service. Let's build it with Docker. It's supereasy!

We have Dockerfile with build tools, grpc and golang compilers. Let's build it.

docker build -t tnt_grpc_client_builder \
    -f ./client/Dockerfile ./

Let's start 'tnt_grpc_client_builder' container. We need to share *.proto files and Goland source code for it. We will get clients for Mac, Linux and Windows in 'bin' directory after the work is done.

docker run -it \
    -v $(pwd)/:/proto/ \ # our proto files is here
    -v $(pwd)/client/:/client_src/ \ # client source code
    -v $(pwd)/:/hostoutput \     # output path for binary files
    tnt_grpc_client_builder

Now we can start the client for your platform.

./client/bin/client_mac

all the steps in ./run_client.sh