@samanbayaka/sysmgr

This project is a modular, production-ready microservices framework built with Moleculer and Moleculer-Web latest, using NATS as a high-performance messaging transporter and AJV for robust schema validation. It provides a scalable foundation for developing distributed Node.js applications, emphasizing fault tolerance, clean architecture, and efficient service communication. The system is designed to support flexible orchestration of services while maintaining strong validation and reliability across components.

Features

• Moleculer-based framework for building microservices

• Use NATS transporter for high-performance message bus

• Use Redpanda transporter for persistent, robust, and scalable message bus with ACL support.

• In memory L1 cache and Redis cache for L2

• Schema validation using AJV

• Config-driven service initialization using etcd

• Create a Demo service to demonstrate the workflow

• Dynamically register Edge Services and Microservices

• Centralized error handling middleware

• Graceful shutdown handling SIGINT, SIGTERM

• REPL support for debugging

• Log shipping using agent like fluentbit to OpenObserve

• Metrics shipping using Opentelemetry to OpenObserve

• Token based access of restricted endpoints

Installation

mkdir -p <your_path>
cd <your_path>
pnpm init
pnpm install @samanbayaka/sysmgr

Once the package is installed, modify the package.json file by adding the following entries:

{
  "main": "index.mjs",
  "type": "module",
  "private": true,
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "samanbayaka-sysmgr"
  },
}  

Run the built-in services

• For development/testing environment

cd <your_path>
SBK_CONFIG_URL='SBK_CONFIG_URL='http://<etcd_user>:<etcd_pass>@<etcd_hostname>:<etcd_port>' pnpm start

• For production environment

SBK_CONFIG_URL='http://<etcd_user>:<etcd_pass>@<etcd_hostname>:<etcd_port>' pnpm start >> /var/log/samanbayaka/sbk-${HOSTNAME}-$$.log 2>&1

or

cd <your_path>
SBK_CONFIG_URL='http://<etcd_user>:<etcd_pass>@<etcd_hostname>:<etcd_port>' pm2 start node_modules/.bin/samanbayaka-asset --name "$(basename "$PWD")" --stop-exit-codes 1 --output /var/log/samanbayaka/sbk-out-${HOSTNAME}-$$.log --error /var/log/samanbayaka/sbk-err-${HOSTNAME}-$$.log --interpreter none --watch false --restart-delay 5000 --max-restarts 10