This project shows how to create a minimal Docker image containing a C++ gRPC service.

This demo is intended for Linux systems only. It may work on other operating systems using some form of virtual machine, but I have not tested it.

You must have Docker installed on your workstation. I have only tested the Docker files with 18.09, but any version greater than 17.05 should work.

First we create a Docker image with all the development tools necessary to compile the gRPC server. While it is possible to install all these development tools in your workstation, a Docker image makes the remaining steps easier to reproduce.

This step may take a few minutes, as it builds gRPC and other dependencies:

sudo docker build -t grpc-cpp-devtools:latest -f tools/Dockerfile.devtools tools

Once the development tools image is created we can use it to create a Docker image with a C++ gRPC server:

sudo docker build -t grpc-cpp-echo:latest -f examples/echo/Dockerfile.server .

Note that this image is relatively small:

sudo docker image ls grpc-cpp-echo:latest

REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
grpc-cpp-echo       latest              04d95e5adaa6        4 minutes ago       14.6MB

Use docker run to start a container using this image. You may want to detach from the image using the -d option and capture its id so you can terminate it later:

ID=$(sudo docker run -d -P grpc-cpp-echo:latest /r/echo_server)

Note the mapping of port 7000 to the localhost to ease testing.

The image also contains a small client to demonstrate connecting to it:

ADDRESS=$(sudo docker port "${ID}" 7000)
sudo docker run --network=host grpc-cpp-echo:latest /r/echo_client --address "${ADDRESS}"

sudo docker kill "${ID}"