Categories:
Agents Manager API plugins
agents-manager plugins are components that provide different functionalities to agents-manager
Introduction
agents-manager is composed of plugins, which provide functionality to this component. Plugins work independently, the same way as a service in microservices oriented architecture: isolated, self-contained and without affecting other existing functionalities in the system.
From the different types of plugins, only Api plugins are available in agents-manager.
The following plugins are currently available in agents-manager. Certain plugins are used by all or some of the other plugins and others are specific for one capability.
-
agent-dispatcher-api plugin
This plugin manages request to Agent Dispatcher API. -
development-api plugin
This plugin manages configuration in development environments. Only available in development environments. -
configuration-service plugin
This plugin manages requests to Agent Configuration. -
redis-connector-service plugin
This plugin manages requests to Redis. -
session-service plugin
This plugin manages the sessions. -
agent-deployment plugin, that provides deployment functionalities for agents within the agents-manager. Plugin currently deactivated.
Discover detailed information regarding the available plugins in the left index.
Plugins management
agents-manager uses the @architect/architect library for the management of plugins, so it is the architect library that is responsible for managing the dependencies injection in each module.
To create the architect application, agents-manager uses the PluginManager module (located in the modules/plugin-manager folder). This module starts as the rest of modules at the agents-manager start-up.
The PluginManager performs the following tasks:
- It starts the architect application with the plugins defined in
plugin-config.jsonfile, located at the root of the agents-manager component. - It adds the core modules to the IOC context. See the section plugins modules.
- It stores the information of each module defined in the plugins.
Apart from the agents-manager core environment variables, each plugin can define its own specific variables. Access the document agents-manager environment variables and find them in the section corresponding to your plugin.
Plugin basic structure
Currently, agents-manager uses @architect/architect library for plugins management.
A basic plugin must define at least:
- A
package.jsonfile defining the library, like any other JavaScript library, with apluginsection defining which modules it consumes and supplies. - A source code file that defines the modules that it supplies (
index.tsfor example).
The structure of this basic plugin is as follows:
session-api
├── index.ts
└── package.json
Plugins modules
agents-manager currently adds one module that can be used by the different plugins. To use it, it is only necessary to add the package.json dependencies on plugin.consumes (like any other module/component).
- configurationManager: Module with the agents-manager configuration information.
- redisConnector: Module with the agents-manager Redis connection.
A plugin can provide one or more plugin modules and each plugin module can be of a different type. Each type of module is intended to add a specific functionality to agents-manager.