diff options
Diffstat (limited to 'doc/plugins')
-rw-r--r-- | doc/plugins/account.txt | 5 | ||||
-rw-r--r-- | doc/plugins/base.txt | 5 | ||||
-rw-r--r-- | doc/plugins/bb.txt | 5 | ||||
-rw-r--r-- | doc/plugins/bundler.txt | 5 | ||||
-rw-r--r-- | doc/plugins/bzr.txt | 5 | ||||
-rw-r--r-- | doc/plugins/cfg.txt | 5 | ||||
-rw-r--r-- | doc/plugins/dbstats.txt | 5 | ||||
-rw-r--r-- | doc/plugins/decisions.txt | 5 | ||||
-rw-r--r-- | doc/plugins/deps.txt | 5 | ||||
-rw-r--r-- | doc/plugins/fossil.txt | 5 | ||||
-rw-r--r-- | doc/plugins/git.txt | 5 | ||||
-rw-r--r-- | doc/plugins/hostbase.txt | 5 | ||||
-rw-r--r-- | doc/plugins/index.txt | 83 | ||||
-rw-r--r-- | doc/plugins/metadata.txt | 5 | ||||
-rw-r--r-- | doc/plugins/nagiosgen.txt | 5 | ||||
-rw-r--r-- | doc/plugins/packages.txt | 5 | ||||
-rw-r--r-- | doc/plugins/pkgmgr.txt | 5 | ||||
-rw-r--r-- | doc/plugins/plugin-roles.txt | 127 | ||||
-rw-r--r-- | doc/plugins/probes.txt | 5 | ||||
-rw-r--r-- | doc/plugins/rules.txt | 5 | ||||
-rw-r--r-- | doc/plugins/sshbase.txt | 5 | ||||
-rw-r--r-- | doc/plugins/statistics.txt | 5 | ||||
-rw-r--r-- | doc/plugins/svn.txt | 5 | ||||
-rw-r--r-- | doc/plugins/tcheetah.txt | 5 | ||||
-rw-r--r-- | doc/plugins/tgenshi.txt | 5 |
25 files changed, 325 insertions, 0 deletions
diff --git a/doc/plugins/account.txt b/doc/plugins/account.txt new file mode 100644 index 000000000..311d91b24 --- /dev/null +++ b/doc/plugins/account.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +======= +Account +======= diff --git a/doc/plugins/base.txt b/doc/plugins/base.txt new file mode 100644 index 000000000..ead775c10 --- /dev/null +++ b/doc/plugins/base.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +==== +Base +==== diff --git a/doc/plugins/bb.txt b/doc/plugins/bb.txt new file mode 100644 index 000000000..806f180e8 --- /dev/null +++ b/doc/plugins/bb.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +== +BB +== diff --git a/doc/plugins/bundler.txt b/doc/plugins/bundler.txt new file mode 100644 index 000000000..1efbca878 --- /dev/null +++ b/doc/plugins/bundler.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +======= +Bundler +======= diff --git a/doc/plugins/bzr.txt b/doc/plugins/bzr.txt new file mode 100644 index 000000000..83bea745e --- /dev/null +++ b/doc/plugins/bzr.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +=== +Bzr +=== diff --git a/doc/plugins/cfg.txt b/doc/plugins/cfg.txt new file mode 100644 index 000000000..5701f2327 --- /dev/null +++ b/doc/plugins/cfg.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +=== +Cfg +=== diff --git a/doc/plugins/dbstats.txt b/doc/plugins/dbstats.txt new file mode 100644 index 000000000..4afca4afe --- /dev/null +++ b/doc/plugins/dbstats.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +======= +DBStats +======= diff --git a/doc/plugins/decisions.txt b/doc/plugins/decisions.txt new file mode 100644 index 000000000..3e32bd803 --- /dev/null +++ b/doc/plugins/decisions.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +========= +Decisions +========= diff --git a/doc/plugins/deps.txt b/doc/plugins/deps.txt new file mode 100644 index 000000000..86b3a272e --- /dev/null +++ b/doc/plugins/deps.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +==== +Deps +==== diff --git a/doc/plugins/fossil.txt b/doc/plugins/fossil.txt new file mode 100644 index 000000000..893ab266e --- /dev/null +++ b/doc/plugins/fossil.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +====== +Fossil +====== diff --git a/doc/plugins/git.txt b/doc/plugins/git.txt new file mode 100644 index 000000000..621c64127 --- /dev/null +++ b/doc/plugins/git.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +=== +Git +=== diff --git a/doc/plugins/hostbase.txt b/doc/plugins/hostbase.txt new file mode 100644 index 000000000..38580598a --- /dev/null +++ b/doc/plugins/hostbase.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +======== +Hostbase +======== diff --git a/doc/plugins/index.txt b/doc/plugins/index.txt new file mode 100644 index 000000000..0d46fc102 --- /dev/null +++ b/doc/plugins/index.txt @@ -0,0 +1,83 @@ +.. -*- mode: rst -*- + +======= +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 :doc:`probes`. +#. Automating administrative tasks (e.g. :doc:`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`_ has the default plugin list currently distributed with Bcfg2: http://trac.mcs.anl.gov/projects/bcfg2/browser/trunk/bcfg2/src/lib/Server/Plugins. + +.. _Bcfg2 repository: http://trac.mcs.anl.gov/projects/bcfg2/browser/trunk/bcfg2/src/lib/Server/Plugins. + +Metadata (Grouping) +------------------- + +* :doc:`bb` +* :doc:`metadata` + +Each of these plugins has a corresponding subdirectory with the same name in the Bcfg2 repository. + +Abstract Configuration (Structures) +----------------------------------- + +* :doc:`base` +* :doc:`bundler` + +Each of these plugins has a corresponding subdirectory with the same name in the Bcfg2 repository. + +Literal Configuration (Generators) +---------------------------------- + +* :doc:`account` +* :doc:`actions` +* :doc:`cfg` +* :doc:`decisions` +* :doc:`deps` +* :doc:`hostbase` +* :doc:`nagiosgen` +* :doc:`packages` +* :doc:`pkgmgr` +* :doc:`rules` +* :doc:`sshbase` +* :doc:`tcheetah` +* :doc:`tgenshi` + +Each of these plugins has a corresponding subdirectory with the same name in the Bcfg2 repository. + +Statistics Plugins +------------------ + +* :doc:`dbstats` +* :doc:`statistics` + +DBStats can be enabled by adding it to the plugins line in /etc/bcfg2.conf. + +Version Plugins +--------------- + +* :doc:`bzr` +* :doc:`fossil` +* :doc:`git` +* :doc:`svn` + +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 :doc:`plugin-roles` diff --git a/doc/plugins/metadata.txt b/doc/plugins/metadata.txt new file mode 100644 index 000000000..2c169318f --- /dev/null +++ b/doc/plugins/metadata.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +======== +Metadata +======== diff --git a/doc/plugins/nagiosgen.txt b/doc/plugins/nagiosgen.txt new file mode 100644 index 000000000..f157cd82b --- /dev/null +++ b/doc/plugins/nagiosgen.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +========= +NagiosGen +========= diff --git a/doc/plugins/packages.txt b/doc/plugins/packages.txt new file mode 100644 index 000000000..b2dbfd1ab --- /dev/null +++ b/doc/plugins/packages.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +======== +Packages +======== diff --git a/doc/plugins/pkgmgr.txt b/doc/plugins/pkgmgr.txt new file mode 100644 index 000000000..63cb7de1c --- /dev/null +++ b/doc/plugins/pkgmgr.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +====== +Pkgmgr +====== diff --git a/doc/plugins/plugin-roles.txt b/doc/plugins/plugin-roles.txt new file mode 100644 index 000000000..f26c79cee --- /dev/null +++ b/doc/plugins/plugin-roles.txt @@ -0,0 +1,127 @@ +.. -*- mode: rst -*- + +============ +Plugin Roles +============ + +This documents available plugin roles. + +1. list of plugin roles + + +---------------+--------------------+--------+ + | Role | Class | Status | + +===============+====================+========+ + | Metadata | Metadata | done | + +---------------+--------------------+--------+ + | Connector | Connector | done | + +---------------+--------------------+--------+ + | Probing | Probing | done | + +---------------+--------------------+--------+ + | Structure | Structure | done | + +---------------+--------------------+--------+ + | Structure Val | StructureValidator | done | + +---------------+--------------------+--------+ + | Generator | Generator | done | + +---------------+--------------------+--------+ + | Goals Val | GoalValidator | done | + +---------------+--------------------+--------+ + | Statistics | Statistics | done | + +---------------+--------------------+--------+ + | Pull Source | PullSource | done | + +---------------+--------------------+--------+ + | Pull Target | PullTarget | done | + +---------------+--------------------+--------+ + | Version | Version | done | + +---------------+--------------------+--------+ + | Decision | Decision | done | + +---------------+--------------------+--------+ + | Remote | Remote | none | + +---------------+--------------------+--------+ + | Syncing | Syncing | none | + +---------------+--------------------+--------+ + +2. Plugin Capabilities + + * Metadata + + * Initial metadata construction + * Connector data accumulation + * ClientMetadata instance delivery + * Introspection interface (for bcfg2-info & co) + + * Connector + + * Provide additional data for ClientMetadata instances + + * Probing + + * send executable probes to clients and receive data responses + + * Structure + + * Produce a list of configuration entries that should be included in client configurations + * Each structure plugin is produces a list of structures + * Core verifies that each bundle listed has been constructed + + * Structure Validation + + * Validate a client entry list's internal consistency, modifying if needed + + * Generator + * Goals Validation + + * Validate client goals, modifying if needed + + * Pull Source + + * Plugin can provide entry information about clients + + * Pull Target + + * Plugin can accept entry data and merge it into the specification + + * Version + + * Plugin can read revision information from VCS of choice + * Will provide an interface for producing commits made by the bcfg2-server + + * Decision + +3. Configuration of plugins + + Plugin configuration will be simplified substantially. Now, a single + list of plugins (including plugins of all capabilities) is specified + upon startup (either via bcfg2.conf or equivalent). This mechanism + replaces the current split configuration mechanism where generators, + structures, and other plugins are listed independently. Instead, all + plugins included in the startup list will be initialized, and each + will be enabled in all roles that it supports. This will remove a + current source of confusion and potential configuration errors, + wherein a plugin is enabled for an improper set of goals. (ie Cfg + enabled as a structure, etc) This does remove the possibility of + partially enabling a plugin for one of its roles without activating it + across the board, but I think this is a corner case, which will be + poorly supported by plugin implementers. If needed, this use case can + be explicitly supported by the plugin author, through use of a config + file directive. + +4. User Visible Changes + + Connector data is added to ClientMetadata instances using the name of + the connector plugin. This means that the dictionary of key/val probe + pairs included with metadata is now available as metadata.Probes + (instead of metadata.probes). Once properties are available the same + way, they will likewise change names to metadata.Properties from their + current name. + + Plugin configuration will change. A single field "plugins" in + bcfg2.conf will supercede the combination of the "generators" and + "structures" fields. + + Default loading of needed plugins is now explicit; this means that + Statistics (if used) should be listed in the plugins line of + bcfg2.conf. + +5. Notes + + * Need to ensure bundle accumulation occurs with connector groups diff --git a/doc/plugins/probes.txt b/doc/plugins/probes.txt new file mode 100644 index 000000000..62dab61e7 --- /dev/null +++ b/doc/plugins/probes.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +====== +Probes +====== diff --git a/doc/plugins/rules.txt b/doc/plugins/rules.txt new file mode 100644 index 000000000..8d32df856 --- /dev/null +++ b/doc/plugins/rules.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +===== +Rules +===== diff --git a/doc/plugins/sshbase.txt b/doc/plugins/sshbase.txt new file mode 100644 index 000000000..28b541732 --- /dev/null +++ b/doc/plugins/sshbase.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +======= +SSHbase +======= diff --git a/doc/plugins/statistics.txt b/doc/plugins/statistics.txt new file mode 100644 index 000000000..4aae9c0f2 --- /dev/null +++ b/doc/plugins/statistics.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +========== +Statistics +========== diff --git a/doc/plugins/svn.txt b/doc/plugins/svn.txt new file mode 100644 index 000000000..cfe44c707 --- /dev/null +++ b/doc/plugins/svn.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +=== +Svn +=== diff --git a/doc/plugins/tcheetah.txt b/doc/plugins/tcheetah.txt new file mode 100644 index 000000000..1b0b4907d --- /dev/null +++ b/doc/plugins/tcheetah.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +======== +TCheetah +======== diff --git a/doc/plugins/tgenshi.txt b/doc/plugins/tgenshi.txt new file mode 100644 index 000000000..f8acb9933 --- /dev/null +++ b/doc/plugins/tgenshi.txt @@ -0,0 +1,5 @@ +.. -*- mode: rst -*- + +======= +TGenshi +======= |