acmeair

Acme Air Sample and Benchmark

This application shows an implementation of a fictitious airline called “Acme Air”. The application was built with the some key business requirements: the ability to scale to billions of web API calls per day, the need to develop and deploy the application in public clouds (as opposed to dedicated pre-allocated infrastructure), and the need to support multiple channels for user interaction (with mobile enablement first and browser/Web 2.0 second).

There are two implementations of the application tier. Each application implementation, supports multiple data tiers. They are:

Repository Contents

Source:

• acmeair-common: The Java entities used throughout the application.
• acmeair-customer-common: The common files of customer service which could be used by other module who want to use customer service.
• acmeair-customer-service: The micro service of customer service.
• acmeair-loader: A tool to load the Java implementation data store.
• acmeair-services: The Java data services interface definitions.
• acmeair-service-morphia: A mongodb data service implementation.
• acmeair-booking-service: The micro service of booking service.
• acmeair-webapp: The Web 2.0 application frontend which accesses the customer service for login and booking service for booking flight.

How to get started

• Development Environment

  • Install Maven to build the code.
  • We use Docker to run the integration test.
  • We use Consul as service discovery registry.
  • We use MongoDB as Data Service (it is optional.)

• Instructions for build the code base

  You can build the code by using maven from the root without running the test

  mvn clean install -Dtest=false -DfailIfNoTests=false 
  

  You can build the code by using maven from the root without using docker

  mvn clean install
  

  If you want to build the docker image and run the integration tests with docker, you can use the Profile of Docker just like this

  mvn clean install -Pdocker
  

  If you are using docker machine, please use the following command

  mvn clean install -Pdocker -Pdocker-machine
  

• Running Application

  The Acmeair Application have three separated services process: acmeair-customer-service, acmeair-booking-service and acmeair-webapp. Acmeair Application also need to use the Service Registry consul to find out the services which it dependents. acmeair-booking-service and acmeair-customer-service can use the outside mongoDB service or use the in memory DB by using active profile.

  Here are the dependencies of these service:

  acmeair-webapp -----> acmeair-booking-service (DB)  --------+
       |        |               |                          |
       |        |               |                          |
       |        |               v                          |
       |        +--> acmeair-customer-service (DB)-----+   |
       |                                               |   |
       |                                               V   V
       +-------------------------------------------->Service Registry (Consul)            
  

• Running Application with docker-compose

  docker-compose up
  

• Running Application with docker-compose and pre-loaded customers/flights data

  docker-compose -f docker-compose.yml -f docker-compose.perf.yml up
  

• Running Application with java command

  1.Running Consul with docker

  docker run -p 8500:8500 consul
  

  2.Running MongoDb With docker (optional)

  docker run -p 27017:27017 mongo
  

  3.Starting acmeair-customer-service

  #Running the customer service with in memory db
  java -Dspring.profiles.active=jpa -Dspring.cloud.consul.host=localhost -Dserver.port=8082 -jar acmeair-customer-service/target/acmeair/acmeair-customer-service-exec.jar
      
  #Running the customer service with mongoDB service
  java -Dspring.profiles.active=mongodb -Dspring.data.mongodb.host=localhost -Dspring.cloud.consul.host=localhost -Dserver.port=8082 -jar acmeair-customer-service/target/acmeair/acmeair-customer-service-exec.jar
  

  4.Starting acmeair-booking-service

  #Running the booking service with in memory db
  java -Dspring.profiles.active=jpa -Dspring.cloud.consul.host=localhost  -Dserver.port=8081 -jar acmeair-booking-service/target/acmeair/acmeair-booking-service-exec.jar
      
  # Running the booking service with mongoDB service
  java -Dspring.profiles.active=mongodb -Dspring.data.mongodb.host=localhost -Dspring.cloud.consul.host=localhost  -Dserver.port=8081 -jar acmeair-booking-service/target/acmeair/acmeair-booking-service-exec.jar
  

  5.Starting acmeair-webapp

  java -Dspring.cloud.consul.host=localhost -Dspring.profiles.active=consul -Dserver.port=8080 -jar acmeair-webapp/target/acmeair/acmeair-webapp-exec.jar
  

  6.Access the acmeair-webapp from browser with below address

  http://localhost:8080/index.html
  

• Running AcmeAir on Google Compute Engine

  The default Java version is 1.7 on Google Compute Engine but AcmeAir is using 1.8. Run the following command to set up Java 8 on Google Compute Engine.

  sudo update-alternatives --set java /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java
  export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64/jre/