Plugins¶
Plugins are the source of all logic used in building a config. They can perform one of several tasks:
- Generating configuration inventory lists for clients
- Generating configuration entry contents for clients
- Probing client-side state (like hardware inventory, etc) – the generic client probing mechanism is described at Probes.
- Automating administrative tasks (e.g. SSHbase which automates ssh key management)
- Generating client per-entry installation decision-lists
Enabling Plugins¶
In order for the Bcfg2 server to use a plugin, it needs to be listed on
the plugins line in bcfg2.conf
.
Default Plugins¶
The Bcfg2 repository contains the all plugins currently distributed with Bcfg2.
Metadata (Grouping)¶
Each of these plugins has a corresponding subdirectory with the same name in the Bcfg2 repository.
Abstract Configuration (Structures)¶
Each of these plugins has a corresponding subdirectory with the same name in the Bcfg2 repository.
Literal Configuration (Generators)¶
Each of these plugins has a corresponding subdirectory with the same name in the Bcfg2 repository.
Connector Plugins¶
Statistics Plugins¶
Reporting can be enabled by adding it to the plugins line in
/etc/bcfg2.conf
.
Plugin Roles (in 1.0)¶
In version 1.0, plugins have been refactored into a series of roles. This are fine-grained plugin capabilities that govern how the server core interacts with plugins.
More details can be found in Plugin Roles