1
0
mirror of https://github.com/node-red/node-red.git synced 2023-10-10 13:36:53 +02:00
node-red/packages/node_modules/@node-red/runtime/lib/index.js

389 lines
13 KiB
JavaScript
Raw Normal View History

/*!
* Copyright JS Foundation and other contributors, http://js.foundation
2013-09-05 16:02:48 +02:00
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
**/
2018-08-04 23:23:06 +02:00
var externalAPI = require("./api");
2013-09-05 16:02:48 +02:00
var redNodes = require("./nodes");
var flows = require("./flows");
2014-09-22 15:33:26 +02:00
var storage = require("./storage");
var library = require("./library");
var plugins = require("./plugins");
var settings = require("./settings");
var express = require("express");
var path = require('path');
var fs = require("fs");
2016-02-22 18:47:16 +01:00
var os = require("os");
2013-09-05 16:02:48 +02:00
2021-04-12 21:30:31 +02:00
const {log,i18n,events,exec,util,hooks} = require("@node-red/util");
2015-02-04 23:28:17 +01:00
var runtimeMetricInterval = null;
var started = false;
2015-11-24 23:38:42 +01:00
var stubbedExpressApp = {
get: function() {},
post: function() {},
put: function() {},
delete: function() {}
2015-11-24 23:38:42 +01:00
}
var adminApi = {
auth: {
needsPermission: function() {return function(req,res,next) {next()}}
2015-11-24 23:38:42 +01:00
},
adminApp: stubbedExpressApp,
server: {}
}
var nodeApp;
2018-12-04 16:59:43 +01:00
var adminApp;
var server;
/**
* Initialise the runtime module.
* @param {Object} settings - the runtime settings object
* @param {HTTPServer} server - the http server instance for the server to use
* @param {AdminAPI} adminApi - an instance of @node-red/editor-api. <B>TODO</B>: This needs to be
* better abstracted.
* @memberof @node-red/runtime
*/
function init(userSettings,httpServer,_adminApi) {
server = httpServer;
userSettings.version = getVersion();
settings.init(userSettings);
nodeApp = express();
2018-12-04 16:59:43 +01:00
adminApp = express();
2015-11-24 23:38:42 +01:00
if (_adminApi) {
adminApi = _adminApi;
}
redNodes.init(runtime);
2018-08-04 23:23:06 +02:00
externalAPI.init(runtime);
}
2015-02-04 23:28:17 +01:00
var version;
function getVersion() {
if (!version) {
2018-08-17 23:10:54 +02:00
version = require(path.join(__dirname,"..","package.json")).version;
/* istanbul ignore else */
try {
2018-08-04 23:23:06 +02:00
fs.statSync(path.join(__dirname,"..","..","..","..",".git"));
version += "-git";
} catch(err) {
// No git directory
}
}
return version;
2014-11-04 12:34:49 +01:00
}
/**
* Start the runtime.
* @return {Promise} - resolves when the runtime is started. This does not mean the
* flows will be running as they are started asynchronously.
* @memberof @node-red/runtime
*/
2014-11-04 12:34:49 +01:00
function start() {
2018-08-17 23:10:54 +02:00
return i18n.registerMessageCatalog("runtime",path.resolve(path.join(__dirname,"..","locales")),"runtime.json")
.then(function() { return storage.init(runtime)})
.then(function() { return settings.load(storage)})
2020-12-17 15:35:01 +01:00
.then(function() { return library.init(runtime)})
.then(function() {
2015-02-04 23:28:17 +01:00
if (log.metric()) {
runtimeMetricInterval = setInterval(function() {
reportMetrics();
2015-03-21 18:42:06 +01:00
}, settings.runtimeMetricInterval||15000);
2015-02-04 23:28:17 +01:00
}
log.info("\n\n"+log._("runtime.welcome")+"\n===================\n");
2014-11-04 12:34:49 +01:00
if (settings.version) {
2015-05-08 15:21:01 +02:00
log.info(log._("runtime.version",{component:"Node-RED",version:"v"+settings.version}));
}
2015-05-08 15:21:01 +02:00
log.info(log._("runtime.version",{component:"Node.js ",version:process.version}));
if (settings.UNSUPPORTED_VERSION) {
log.error("*****************************************************************");
2019-08-06 12:24:45 +02:00
log.error("* "+log._("runtime.unsupported_version",{component:"Node.js",version:process.version,requires: ">=8.9.0"})+" *");
log.error("*****************************************************************");
events.emit("runtime-event",{id:"runtime-unsupported-version",payload:{type:"error",text:"notification.errors.unsupportedVersion"},retain:true});
}
2016-02-22 18:47:16 +01:00
log.info(os.type()+" "+os.release()+" "+os.arch()+" "+os.endianness());
return redNodes.load().then(function() {
let autoInstallModules = false;
if (settings.hasOwnProperty('autoInstallModules')) {
log.warn(log._("server.deprecatedOption",{old:"autoInstallModules", new:"externalModules.autoInstall"}));
autoInstallModules = true;
}
if (settings.externalModules) {
// autoInstallModules = autoInstall enabled && (no palette setting || palette install not disabled)
autoInstallModules = settings.externalModules.autoInstall && (!settings.externalModules.palette || settings.externalModules.palette.allowInstall !== false) ;
}
2014-11-04 12:34:49 +01:00
var i;
var nodeErrors = redNodes.getNodeList(function(n) { return n.err!=null;});
var nodeMissing = redNodes.getNodeList(function(n) { return n.module && n.enabled && !n.loaded && !n.err;});
2014-11-04 12:34:49 +01:00
if (nodeErrors.length > 0) {
log.warn("------------------------------------------------------");
for (i=0;i<nodeErrors.length;i+=1) {
if (nodeErrors[i].err.code === "type_already_registered") {
log.warn("["+nodeErrors[i].id+"] "+log._("server.type-already-registered",{type:nodeErrors[i].err.details.type,module: nodeErrors[i].err.details.moduleA}));
} else {
log.warn("["+nodeErrors[i].id+"] "+nodeErrors[i].err);
}
}
log.warn("------------------------------------------------------");
2014-09-22 15:33:26 +02:00
}
2014-11-04 12:34:49 +01:00
if (nodeMissing.length > 0) {
2015-05-08 15:21:01 +02:00
log.warn(log._("server.missing-modules"));
2014-11-04 12:34:49 +01:00
var missingModules = {};
for (i=0;i<nodeMissing.length;i++) {
var missing = nodeMissing[i];
missingModules[missing.module] = missingModules[missing.module]||{
module:missing.module,
version:missing.pending_version||missing.version,
types:[]
}
missingModules[missing.module].types = missingModules[missing.module].types.concat(missing.types);
2014-11-04 12:34:49 +01:00
}
var moduleList = [];
2014-11-04 12:34:49 +01:00
var promises = [];
var installingModules = [];
2014-11-04 12:34:49 +01:00
for (i in missingModules) {
if (missingModules.hasOwnProperty(i)) {
log.warn(" - "+i+" ("+missingModules[i].version+"): "+missingModules[i].types.join(", "));
if (autoInstallModules && i != "node-red") {
installingModules.push({id:i,version:missingModules[i].version});
2014-09-22 15:33:26 +02:00
}
}
}
if (!autoInstallModules) {
2015-05-08 15:21:01 +02:00
log.info(log._("server.removing-modules"));
redNodes.cleanModuleList();
} else if (installingModules.length > 0) {
reinstallAttempts = 0;
reinstallModules(installingModules);
2014-11-04 12:34:49 +01:00
}
}
2015-12-07 00:29:58 +01:00
if (settings.settingsFile) {
log.info(log._("runtime.paths.settings",{path:settings.settingsFile}));
}
if (settings.httpStatic) {
log.info(log._("runtime.paths.httpStatic",{path:path.resolve(settings.httpStatic)}));
}
return redNodes.loadContextsPlugin().then(function () {
2018-07-20 16:26:47 +02:00
redNodes.loadFlows().then(redNodes.startFlows).catch(function(err) {});
started = true;
});
2014-11-04 12:34:49 +01:00
});
});
}
2014-11-04 12:34:49 +01:00
2020-11-30 15:38:48 +01:00
var reinstallAttempts = 0;
var reinstallTimeout;
function reinstallModules(moduleList) {
const promises = [];
const reinstallList = [];
const installRetry = 30000;
if (settings.hasOwnProperty('autoInstallModulesRetry')) {
log.warn(log._("server.deprecatedOption",{old:"autoInstallModulesRetry", new:"externalModules.autoInstallRetry"}));
installRetry = settings.autoInstallModulesRetry;
}
if (settings.externalModules && settings.externalModules.hasOwnProperty('autoInstallRetry')) {
installRetry = settings.externalModules.autoInstallRetry * 1000;
}
for (var i=0;i<moduleList.length;i++) {
if (moduleList[i].id != "node-red") {
2020-11-30 15:38:48 +01:00
(function(mod) {
promises.push(redNodes.installModule(mod.id,mod.version).then(m => {
events.emit("runtime-event",{id:"node/added",retain:false,payload:m.nodes});
}).catch(err => {
reinstallList.push(mod);
}));
})(moduleList[i])
}
}
2020-11-30 15:38:48 +01:00
Promise.all(promises).then(function(results) {
if (reinstallList.length > 0) {
reinstallAttempts++;
// First 5 at 1x timeout, next 5 at 2x, next 5 at 4x, then 8x
var timeout = installRetry * Math.pow(2,Math.min(Math.floor(reinstallAttempts/5),3));
reinstallTimeout = setTimeout(function() {
reinstallModules(reinstallList);
},timeout);
}
});
}
2015-02-04 23:28:17 +01:00
function reportMetrics() {
var memUsage = process.memoryUsage();
2015-03-21 18:42:06 +01:00
log.log({
level: log.METRIC,
event: "runtime.memory.rss",
value: memUsage.rss
});
log.log({
level: log.METRIC,
event: "runtime.memory.heapTotal",
value: memUsage.heapTotal
});
log.log({
level: log.METRIC,
event: "runtime.memory.heapUsed",
value: memUsage.heapUsed
});
2015-02-04 23:28:17 +01:00
}
/**
* Stops the runtime.
*
* Once called, Node-RED should not be restarted until the Node.JS process is
* restarted.
*
* @return {Promise} - resolves when the runtime is stopped.
* @memberof @node-red/runtime
*/
function stop() {
2015-02-04 23:28:17 +01:00
if (runtimeMetricInterval) {
clearInterval(runtimeMetricInterval);
runtimeMetricInterval = null;
}
if (reinstallTimeout) {
clearTimeout(reinstallTimeout);
}
started = false;
2018-05-30 03:24:27 +02:00
return redNodes.stopFlows().then(function(){
return redNodes.closeContextsPlugin();
});
}
2018-08-04 23:23:06 +02:00
// This is the internal api
var runtime = {
version: getVersion,
log: log,
i18n: i18n,
events: events,
settings: settings,
storage: storage,
2020-07-30 18:52:11 +02:00
hooks: hooks,
2015-11-24 23:38:42 +01:00
nodes: redNodes,
plugins: plugins,
flows: flows,
library: library,
exec: exec,
util: util,
get adminApi() { return adminApi },
2018-12-04 16:59:43 +01:00
get adminApp() { return adminApp },
get nodeApp() { return nodeApp },
get server() { return server },
isStarted: function() {
return started;
}
2018-08-04 23:23:06 +02:00
};
/**
* This module provides the core runtime component of Node-RED.
* It does *not* include the Node-RED editor. All interaction with
* this module is done using the api provided.
*
* @namespace @node-red/runtime
*/
2018-08-04 23:23:06 +02:00
module.exports = {
init: init,
start: start,
stop: stop,
/**
* @memberof @node-red/runtime
* @mixes @node-red/runtime_comms
*/
2018-08-04 23:23:06 +02:00
comms: externalAPI.comms,
/**
* @memberof @node-red/runtime
* @mixes @node-red/runtime_flows
*/
2018-08-04 23:23:06 +02:00
flows: externalAPI.flows,
/**
* @memberof @node-red/runtime
* @mixes @node-red/runtime_library
*/
2018-08-04 23:23:06 +02:00
library: externalAPI.library,
/**
* @memberof @node-red/runtime
* @mixes @node-red/runtime_nodes
*/
2018-08-04 23:23:06 +02:00
nodes: externalAPI.nodes,
/**
* @memberof @node-red/runtime
* @mixes @node-red/runtime_settings
*/
2018-08-04 23:23:06 +02:00
settings: externalAPI.settings,
/**
* @memberof @node-red/runtime
* @mixes @node-red/runtime_projects
*/
2018-08-04 23:23:06 +02:00
projects: externalAPI.projects,
/**
* @memberof @node-red/runtime
* @mixes @node-red/runtime_context
*/
2018-08-04 23:23:06 +02:00
context: externalAPI.context,
/**
* @memberof @node-red/runtime
* @mixes @node-red/runtime_plugins
*/
plugins: externalAPI.plugins,
/**
* Returns whether the runtime is started
* @param {Object} opts
* @param {User} opts.user - the user calling the api
* @return {Promise<Boolean>} - whether the runtime is started
* @function
* @memberof @node-red/runtime
*/
2018-08-04 23:23:06 +02:00
isStarted: externalAPI.isStarted,
/**
* Returns version number of the runtime
* @param {Object} opts
* @param {User} opts.user - the user calling the api
* @return {Promise<String>} - the runtime version number
* @function
* @memberof @node-red/runtime
*/
version: externalAPI.version,
storage: storage,
events: events,
2020-07-30 18:52:11 +02:00
hooks: hooks,
2018-12-04 16:59:43 +01:00
util: require("@node-red/util").util,
get httpNode() { return nodeApp },
2018-12-04 16:59:43 +01:00
get httpAdmin() { return adminApp },
get server() { return server },
"_": runtime
}
/**
* A user accessing the API
* @typedef User
* @type {object}
*/