blob: b6debba24eeece84d9ec21267131bc4497f27418 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
|
.. -*- mode: rst -*-
.. _development-plugins:
Bcfg2 Plugin development
------------------------
While the Bcfg2 server provides a good interface for representing
general system configurations, its plugin interface offers the ability
to implement configuration interfaces and representation tailored to
problems encountered by a particular site. This chapter describes what
plugins are good for, what they can do, and how to implement them.
Bcfg2 Plugins
^^^^^^^^^^^^^
Bcfg2 plugins are loadable python modules that the Bcfg2 server loads at
initialization time. These plugins can contribute to the functions already
offered by the Bcfg2 server or can extend its functionality. In general,
plugins will provide some portion of the configuration for clients, with a
data representation that is tuned for a set of common tasks. Much of the
core functionality of Bcfg2 is implemented by several plugins, however,
they are not special in any way; new plugins could easily supplant one
or all of them.
The following table describes the various functions of bcfg2 plugins.
+--------------------+---------------------------------------------+
| Name | Description |
+====================+=============================================+
| Probes | Plugins can issue commands to collect |
| | client-side state (like hardware inventory) |
| | to include in client configurations |
+--------------------+---------------------------------------------+
| ConfigurationEntry | Plugins can construct a list of per-client |
| List | configuration entry lists to include in |
| | client configurations. |
+--------------------+---------------------------------------------+
| ConfigurationEntry | Literal values for configuration entries |
| contents | |
+--------------------+---------------------------------------------+
| XML-RPC functions | Plugins can export function calls that |
| | expose internal functions. |
+--------------------+---------------------------------------------+
|
