Acme Air in NodeJS

An implementation of the Acme Air sample application for NodeJS. This implementation can support multiple datastores, can run in several application modes, and can support running on a variety of runtime platforms including standalone bare metal system, Virtual Machines, docker containers, IBM Bluemix, IBM Bluemix Container Service.

Content

Runtime Environment

NodeJs

Datastore Choices

Environment variable dbtype is used to determine the datastore choice. MongoDB is default. See under "More on configurations".

Application Mode

Environment variable AUTH_SERVICE is use to determine when Micro-Service is used. Default is Monolitic. See under "More on configurations".

Monolithic

One NodeJS application. The default mode.

Micro-Service

Main NodeJS application delegates to authorization service NodeJS application hosted on host:port, defined in AUTH_SERVICE

Application Run Platforms

[Bluemix Instructions] (README_Bluemix.md)
[Docker Instructions] (README_Docker.md)
[Bluemix Container Service Instructions] (README_Bluemix_Container.md)

How to get started

Assume MongoDB started on 127.0.0.1:27017

Resolve module dependencies

npm install
node_modules/.bin/npm install

Run Acmeair in Monolithic on Local

node monolithic_app.js

Access Monolithic Application

http://localhost:9085/acmeair-monolithic

Run Acmeair in Micro-Service on Local (See Docker Instructions -> much easier)

install nginx and startup using the nginx.conf file

node authservice_app.js
node customerservice_app.js	
node flightservice_app.js
node bookingservice_app.js
node main_app.js

*ports are hardcoded in nginx.conf and settings.json

Access Micro-Service Application

http://localhost/acmeair

Load Database 
	preload 10k customers uid[0..9999]@email.com:password, 5 days' flights.  Defined in loader/loader-settings.json
Login
Flights
	such as Singapore to HongKong or Paris to Moscow 
Checkin
	cancel some booked flights
Account
	update account info
Logout

More on Configurations

Environment Variables

Name	Default	Meaning
dbtype	mongo	You can switch between mongo,cloudant,cassandra for datastore choices. When running on Bluemix, dbtype is automactially discovered from the service the application is bound to.
AUTH_SERVICE		By default, there is only one main NodeJS application for all logics. When defined, in the format of host:port, it enables Micro-Service mode, main NodeJS application delegates to authorization service NodeJS application hosted on host:port.
enableHystrix	false	setting it to true will enable hystrix stream available at /rest/api/hystrix.stream
MONGO_URL		Mongo database URL. Take precedence over other settings
CLOUDANT_URL		Cloudant database URL. Take precedence over other settings
CASSANDRA_CP		Cassandra Contact Points. Take precedence over other settings
CASSANDRA_KS		Cassandra keyspace. Take precedence over other settings

Configuration for Runtime

Default values are defined here

Name	Default	Meaning
mongoHost	127.0.0.1	MongoDB host ip
mongoPort	27017	MongoDB port
mongoConnectionPoolSize	10	MongoDB connection pool size
cloudant_host		Cloudant database host name
cloudant_port	443	Cloudant database port
cloudant_username		Cloudant database username/API key
cloudant_password		Cloudant database password
cloudant_httpclient.maxTotal	200	Cloudant http client max connections
cloudant_httpclient.maxPerRoute	100	Cloudant http client connections per route
cloudant_httpclient.soTimeout	5000	Cloudant http client socket timeout
cloudant_httpclient.connectionTimeout	5000	Cloudant http client connection timeout
cassandra_contactPoints		Cassandra contact points
cassandra_keyspace	acmeair_keyspace	Cassandra keyspace

When running on Bluemix, datasource url will be read from bound service information.
For Cloudant, you need to follow instruction to create database and define search index.
For Cassandra, you need to follow instruction to create keyspace and tables.

Configuration for Preload