MAPEK-FRAMEWORK
The first framework to implement a MAPE-K Loop. This project enable the community to create auto-adaptative systems based on a simple version of the MAPE-K Loop.
Information about auto-adaptative software and the MAPE-K loop: http://www.uio.no/studier/emner/matnat/ifi/INF5360/v12/undervisningsmateriale/MAPE-K adap control loop.pdf
This framework is avaiable as an npm module: https://www.npmjs.com/package/mapek
Getting started
It's mandatory to create a .ini or .properties file and pass it the path when instantiating a mapekloop This framework automatically creates a REST api wich only supports:
- POST http://..../monitor and a JSON in the body of the request
Calling this api fires a monitor event with the JSON received in the REST interface. Furthermore it's possible to easily pass data from the monitor phase to the process phase.
It's also possible to create networks of MAPE-K loops with the configuration file and the network module.
Example of use
First of all
npm install --save mapek
And then
var mapek = require("mapek");
var loop = mapek.node("mapek.properties");
var network = loop.network;
loop.monitor(function(data, next){
console.log("Monitoring "+JSON.stringify(data));
data.modified = true; //for example
//calling next we can send data to process phase
next(data);
});
loop.process(function(data){
//do something with the data
//for example, this sends the JSON called data to the monitor phase of anotherMapekLoop
network.send("anotherMapekLoop",data);
});
//in the configuration file
[rest]
port=8080
[network]
anotherMapekLoop.hostname=localhost
anotherMapekLoop.port=9999
There is a couple of example implementations in the samples folder.
Future plans
- create a cloud service to share the configurations
- improve the properties system
- Implement a generic repository to enable diferent types of databases
- add more phases to the loop(analysis,execute)
About
This project was created initially with research purposes, but can be extended and improved with the help and support of the community.