Quick Demo

Objective

1. Build a microservice using SOAJS Swagger Editor
2. Deploy micorservice and test it using Swagger Simulator and Postman
3. Quick look at Multitenancy and its impact on microservices' behavior

Scenario

1. Install SOAJS
2. Install Demo
3. Deploy Demo
4. Test Service
5. Sample Data Explained

1 - Installation

Start by installing and deploying SOAJS as a local Cloud; Click Here and you will be redirected to the SOAJS Installer Space where you can find the installation instructions. For this demo, we will be using Local Cloud Deployment on top of Docker. 

2 - Install Demo

Clone the quick demo repository from github; it contains the code and a script that will bootstrap some database configuration for this demo ( explained below )

# Create a directory to clone the repo
> mkdir -p /opt/soajs/node_modules

# Go to directory
> cd /opt/soajs/node_modules

# Clone repo from github
> git clone git@github.com:soajs/soajs.quick.demo.git

# install dependencies
> cd soajs.quick.demo
> npm install

# Import the configuration
> cd soajs.quick.demo/import/

# node . -h <mongo service host> -p <mongo port>
> node . -h dashboard-soajsdata -p 32017

# Open the import script help manual
> cd soajs.quick.demo/import/
> node . --help

Swagger Editor

3 - Deploy Demo

3.2 Deploy Environment and Microservice

Our import script already imported the configuration we need to get things going. Let's deploy the DEV environment and the quick demo microservice.

Step 1: Deploy Environment

Go to Deploy pillar and select DEV from the drop down menu in the top left corner.

Click on Clouds & Deployments in the left-hand side menu, click on the Services tab and press Deploy Environment.

Step 2: Deploy Service

Make sure the selected environment is dev in the top left sidebar.

Navigate to Repositories under Deploy pillar, click on the service to deploy and press Configure Deployment, fill the form like the following picture and press First Time Deploy:

Once the environment is deployed, update your hosts file and add the below entry:

127.0.0.1	dev-api.mydomain.com

4 - Test the Microservice

4.1 Tools

We will test the microservice in two ways :

1. Postman: simulates your curl requests to test the microservice.
   Import the postman collections from the postman folder in the repo you cloned above, you will notice two new collections:

• demo_memory: contains 4 requests
• demo_mongo: contains 2 requests

      2. Swagger Simulator: rich UI simulator that provides REST API documentation and the ability to interact with them.
          SOAJS Dashboard UI is equipped with Swagger Engine and Simulator by default.

1. Go to the dashboard → Develop → Services: 
2. Click on Swagger logo that appears if the microservice is created using Swagger Editor and a new tab will open
3. Choose your environment where you deployed your microservice
4. Use the simulator to make API calls to your microservice

4.2 Tenant Keys

Quick Demo is a multitenant microservice; you will need to provide the tenant keys for the requests to work.

To find these keys, go to the Manage pillar → Multitenancy → Client ( you will see the list of tenants there ).

Expand a tenant entry, to reach the external keys section, grab the external key and use it in the postman requests.

5 - Sample Data Explained

In step 2, we imported some provision configuration, let's understand what this data is.

5.1 DEV Environment:

In order to deploy an environment like we did in the Step 3, you need to provide a configuration that contains how this environment should be deployed.
Yet in the Step 3, the DEV environment was already present when we opened the Deploy Pillar; it was part of the provisioned configuration that was imported.
Had we not imported it, we would have had to manually create it along with its configuration.

5.2 Productization & Multitenancy:

Similarly, we imported a product that provided ACL packages used in the DEV environment by some tenants; This also means we imported some tenants.
This effectively reduces the time it takes to get going with this demo as everything has been preconfigured.

5.3 Showcase:

• 5 Tenants:

In the above configuration, tenant 1 uses the memory model, this means if the service is turned off, all data will be lost.

Tenants 2 & 3 use the same database to store and retrieve the information from a mongo database called demo_SA.

Tenants 4 & 5 each use a database based on their tenant code value to store and retrieve the information from a mongo database where the database name uses this format: %TenantCode%_demo_MT.

6 - Conclusion

To sums it up, this demo is a good introduction to learn how to build a simple microservice having the 4 essentials HTTP APIs using Swagger Editor.

In addition, it will guide you to deploy the microservice in DEV environment using the dashboard so you can test it in Postman or Swagger.

Finally, it will demonstrates the power of multitenancy by means of 5 tenants, where each tenant makes the service behave differently when it calls its APIs and the fact that you can build and apply custom and reusable ACL recipes on these tenants.