Introduction to Sage

A node.js micro service container

Agenda

What is node.js?

Pros and Cons

What is Sage?

Use cases

Workshop

What is node.js?

Javascript runtime

Built for running network apps

Uses V8 (chrome engine)

Async \ non-blocking model

Why node?

Web APIs ("HTTP is a first class citizen")

Natively async

Lightweight

Javascript (?!)

Why not node?

CPU intensive jobs

What is Sage?

Ob1k for node

Wraps express

Common routes and services

Sage API

import {server as SageServer, lumberjack} from '@sage/toolkit';
import router from './route/routes';

const logger = lumberjack.LoggerFactory.getLogger('server.main');

const myService = new SageServer({
  routes: router.getRoutes()
});

myService.start().then(() => {
  logger.info(`***************  MyService Started ********************`);
});

server

Sage API

import { discovery, httpClient } from '@sage/toolkit';

...

  constructor() {
    this.httpClientInstance = httpClient.create();
  }

  async crawl(req: Request, res: Response) {
    const { url } = req.query;
    const target = await discovery.discoveryClient.fetchTarget('DocumentActions');    
    return this.httpClientInstance.get(`${target}/api/crawlByUrl/url=${url}`);
  }

discovery

Sage API

config

  [all]:
    recaptcha.enabled: false
    trackjs.key: dummay
  [test]:
  [simulator]:
  [stg]:
    trackjs.key: 123BjhWp6dHhlLAXk4AiGaKnoq4543
  [prod]:
    recaptcha.enabled: true
    trackjs.key: ENC(lsQBjhWp6dHhlLAXk4AiGaKnoqfydn)

import { config } from '@sage/toolkit';

...

isRecaptchaEnabled() {
    return config.get('recaptcha.enabled');
}

Sage API

import { metrics } from '@sage/toolkit';

...

constructor() {
  this.tokenIssueCounter = metrics.createCounter('token_issue', 
                        'Counter for creation of tokens', 
                        ['token_type', 'status']);
}

issueToken(params: any) {  
  tokenIssueCounter.inc({token_type: 'AMELIA', status: 'new'});
  ...
}

metrics

Where do we use it?

const target = await discoveryClient.fetchTarget(serviceName);
proxy.web(req, res, { target: target });

example: ob-gateway

Never trust benchmarks

Workshop