Awesome Open Source
Awesome Open Source

A simple example of microservices that is described in this series of blog posts.

There are two services:

The services are written in Scala and use the following technologies.

  • Spring Boot
  • Spring Cloud
  • Netflix OSS Eureka
  • RabbitMQ

Note: There are other example microservice applications.

Building and running the microservices

This project uses with Docker Compose to run the services as well as RabbitMQ and MongoDB.

The spring-boot-webapp project uses Selenium to test the web UI using the Chrome browser. You will need to install ChromeDriver. On Mac OSX you can run brew cask install chromedriver.

The quick way

The quickest way to build and run the services on Linux/Mac OSX is with the following commands:

. ./
./ assemble
docker-compose up -d

Otherwise, follow these instructions.

Running MongoDB and RabbitMQ

The RESTful service uses RabbitMQ and MongoDB. The easier way to run them is to using Docker:

 docker-compose up -d mongodb rabbitmq

You also need to set some environment variables so that the services can connect to them:

export DOCKER_HOST_IP=$(docker-machine ip default 2>/dev/null)

export SPRING_DATA_MONGODB_URI=mongodb://${DOCKER_HOST_IP}/userregistration

Build the Eureka server

This application uses Netflix OSS Eureka for service discovery. Build the Spring Cloud based Eureka server using the following commands:

cd eureka-server
./gradlew build

Build the Zipkin server

This application uses Zipkin for distributed tracing. Build the Zipkin server using the following commands:

cd zipkin-server
./gradlew build

Building the RESTful service

Use the following commands to build the RESTful service:

 cd spring-boot-restful-service
 ./gradlew build    

Running the RESTful service

You can run the service by using the following command in the top-level directory:

docker-compose up -d restfulservice

Using the RESTful service

Once the service has started, you can send a registration request using:


You can examine the MongoDB database using the following commands

$ ./
> show dbs;
local             0.031GB
mydb              0.031GB
userregistration  0.031GB
> use userregistration;
switched to db userregistration
> show collections;
> db.registeredUser.find()
{ "_id" : ObjectId("55a99b0993860551c6020e9d"), "_class" : "net.chrisrichardson.microservices.restfulspringboot.backend.RegisteredUser", "emailAddress" : "[email protected]", "password" : "secret" }
> exit

Building the web application

Since the web application invokes the RESTful service you must set the following environment variable:

export USER_REGISTRATION_URL=http://${DOCKER_HOST_IP}:8081/user

Next, use the following commands to build the web application:

cd spring-boot-webapp
./gradlew build

Running the web application

Run the web application using the following command in the top-level directory:

docker-compose up -d web

Using the web application

You can access the web application by visiting the following URL: http://${DOCKER_HOST_IP?}:8080/register.html

There are also other URLs that you can visit. The following command will wait until the services are available and displays the URLs:


Building and running Docker images

The previous instructions deployed the services as Docker containers without actually packaging the services as Docker images. The docker-compose.yml file ran the image java:openjdk-8u91-jdk and used volume mapping to make the Spring Boot jar files accessible. Follow these instructions to build and run the Docker images.

Building the images

You can build the images by running the following command:


This script is a simple wrapper around docker build.

Running the images

You can now run the Docker images using the docker-compose command with docker-compose-images.yml:

docker-compose -f docker-compose-images.yml up -d

The following command will wait until the services are available and displays the URLs:


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,160,038
Restful (29,187
Spring (28,757
Microservice (12,351
Web Application (7,090
Rabbitmq (6,391
Zipkin (984