summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNarayan Desai <desai@mcs.anl.gov>2005-02-16 21:50:09 +0000
committerNarayan Desai <desai@mcs.anl.gov>2005-02-16 21:50:09 +0000
commit5553b1454aefdf7c833bf047f83c1b42ceb2a1d2 (patch)
tree24ae54a0bde77687212498b7f358bebe884e2be2
parent8cd647f4c415ae67d8caa79816cfdefd7f3478b1 (diff)
downloadbcfg2-5553b1454aefdf7c833bf047f83c1b42ceb2a1d2.tar.gz
bcfg2-5553b1454aefdf7c833bf047f83c1b42ceb2a1d2.tar.bz2
bcfg2-5553b1454aefdf7c833bf047f83c1b42ceb2a1d2.zip
add more generator writing docs
(Logical change 1.205) git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@872 ce84e21b-d406-0410-9b95-82705330c041
-rw-r--r--doc/generators.xml49
1 files changed, 49 insertions, 0 deletions
diff --git a/doc/generators.xml b/doc/generators.xml
index ee7a6a8be..fe23b8445 100644
--- a/doc/generators.xml
+++ b/doc/generators.xml
@@ -177,5 +177,54 @@
written that executed logic in another language, but this
functionality is currently not implemented.
</para>
+
+ <example>
+ <title>Simple Generator</title>
+ <programlisting>
+ from socket import gethostbyname, gaierror
+ from syslog import syslog, LOG_ERR
+ from Bcfg2.Server.Generator import Generator, DirectoryBacked, SingleXMLFileBacked, GeneratorError
+
+class Chiba(Generator):
+ '''the Chiba generator builds the following files:
+ -> /etc/network/interfaces'''
+
+ __name__ = 'Chiba'
+ __version__ = '$Id: Chiba.py 1.12 05/01/15 11:05:02-06:00 desai@topaz.mcs.anl.gov $'
+ __author__ = 'bcfg-dev@mcs.anl.gov'
+ __provides__ = {'ConfigFile':{}}
+
+ def __init__(self, core, datastore):
+ Generator.__init__(self, core, datastore)
+ self.repo = DirectoryBacked(self.data, self.core.fam)
+ self.__provides__['ConfigFile']['/etc/network/interfaces'] = self.build_interfaces
+
+ def build_interfaces(self, entry, metadata):
+ '''build network configs for clients'''
+ entry.attrib['owner'] = 'root'
+ entry.attrib['group'] = 'root'
+ entry.attrib['perms'] = '0644'
+ try:
+ myriaddr = gethostbyname("%s-myr" % metadata.hostname)
+ except gaierror:
+ syslog(LOG_ERR, "Failed to resolve %s-myr"% metadata.hostname)
+ raise GeneratorError, ("%s-myr" % metadata.hostname, 'lookup')
+ entry.text = self.repo.entries['interfaces-template'].data % myriaddr
+ </programlisting>
+ </example>
+
+ <para>
+ Generators must subclass the Bcfg2.Server.Generator.Generator
+ class. Generator constructors must take two arguments: an
+ instance of a Bcfg2.Core object, and a location for a
+ datastore. __name__, __version__, __author__, and __provides__
+ are used to describe what the generator is and how it
+ works. __provides__ describes a set of configuration entries
+ that can be provided by the generator, and a set of handlers
+ that can bind in the proper data. build_interfaces is an example
+ of a handler. It gets client metadata and an configuration entry
+ passed in, and binds data into entry as appropriate.
+ </para>
+
</section>
</chapter> \ No newline at end of file