Bar Service Kotlin Server

Overview

This directory contains the server impl in Kotlin for a simple gRPC starter service. You can find detailed instructions for building and running example from below

• Bar Service Server using gRPC and Kotlin. For details, see the project on github.

File organization

The starter sources are organized into the following top-level folders:

• starter-service-models: .proto files for generating the stubs
• starter-service-server: Kotlin servers based on regular stub artifacts

Set up and run the server inside a docker on macOS

• Install Docker

  Download and install the latest version of docker: Download Latest Docker

• Clone the project

  Clone the project recursively cloning all submodules

  git clone git@github.com:hwslabs/bar-service-kotlin-server.git --recurse-submodules

  Navigate into the project:

  cd grpc-kotlin-starter

• Run the server

  Build a docker image and run the server on a container:

  docker-compose up

  This will start the server and open up the 50051 port for connections

Set up and run the server without any containers on macOS

• Install Homebrew

  Download and install Homebrew:

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• Install JDK

  Install any version of JDK (8 preferred):

  brew install openjdk@8

  Add the installed version of JDK to your path through .zshrc or .bash_profile

  echo 'export PATH="/usr/local/opt/openjdk@8/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc

  or

  echo 'export PATH="/usr/local/opt/openjdk@8/bin:$PATH"' >> ~/.bash_profile
  source ~/.bash_profile

• Clone the project

  Clone the project recursively cloning all submodules

  git clone git@github.com:hwslabs/bar-service-kotlin-server.git --recurse-submodules

  Navigate into the project:

  cd grpc-kotlin-starter

• Run the server

  Start the server:

  ./gradlew starter-service-server:start

  This will start the server and open up the 50051 port for connections