Micro Service Framework for NodeJS - A micro service manager that will help
you to create a new service by starting another services.
This framework is supposed to run any services with single command, e.g: run the build processes and then run the server, but these services can access any service's configs, so will be easier to configure the services.
- NodeJS 7.8+
npm install -g @stater/bootStater Boot will have stater-boot and stb as alias on the CLI.
To start using Stater Boot, you need to add
stater-boot property to your package.json.
Example
{
"name": "sample-service",
"version": "1.0.0",
"stater-boot": {
"main": "service.js",
"config": "configs/service-config.js"
}
}Then you need to create a service as a bootstrap service.
Example
service.js
class SampleService {
beforeRun = ['sb-bower-list', 'sb-build-script'];
beforeEnd = ['sb-store-asset', 'sb-init-server', 'sb-start-server'];
// This function will be called when the service start,
// after starting the beforeRun services.
// The beforeEnd services will be started after this
// function called.
service(context, configs) {
let conf = configs.get('sb-server');
context.logs.info(`Server will be running on port ${conf.port}`);
}
}
module.exports = SampleService;The sample above is assume the services already installed, and the created service is to run these services.
Then you can create configs for the required services.
Example
service-config.js
module.exports = [
{
// Config name is required.
name: 'sb-server',
// Your configs is here.
port: 8080,
// This function will be called after all configs registered,
// to allow you reconfigure your config that depends
// on something else.
reconfigure(config) {
if (process.argv.includes('--prod')) {
config.port = 80;
}
}
},
{
name: 'sb-bower-list',
cwd: 'bower_components'
}
];To start the service, run this command:
stater-bootor
stbTo start specific services, include the service(s) name after the command. Example:
stater-boot foo baror
stb foo barExample using command and options:
stb foo bar -d src -c configs/stb-configs.js --debug --erroffFrom the sample above, it run services foo and bar,
set the workding directory (-d) to src folder,
and set the config file (-c) to configs/stb-configs.js,
with debug logging (--debug), and keep the services running
even when some error happen (--erroff).
For more usage info, run this command:
stb helpDetailed docs will come soon. Please check the
testfolder for example.
- Using NodeJS >= 7.8
- Removing dist folder from repo.
- Adding SourceMap support.
- Adding support to start specific services from CLI.
- Adding binary shorthand
stbasstater-boot. - Improvements.
- Updating readme.
- Adding working directory handler (
-d).
- Fixing Service Loader.
- Improve error handling.
- Updating CLI Helper.
- Adding Test.
- Fixing CLI Help Info.
- Chnage the
read-clidependency to@stater/read-cli.
- Initial release.
Copyright © 2017 Nanang Mahdaen El Agung
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.