Updated mcollective.init according to OSCI-658

[packages/precise/mcollective.git] / website / reference / integration / puppet.md

diff --git a/website/reference/integration/puppet.md b/website/reference/integration/puppet.md
new file mode 100644 (file)
index 0000000..b7933c2
--- /dev/null
+++ b/website/reference/integration/puppet.md
@@ -0,0 +1,74 @@
+---
+layout: default
+title: Using with Puppet
+toc: false
+---
+[FactsRLFacter]: http://projects.puppetlabs.com/projects/mcollective-plugins/wiki/FactsFacterYAML
+[PluginSync]: http://docs.reductivelabs.com/guides/plugins_in_modules.html
+[AgentPuppetd]: http://projects.puppetlabs.com/projects/mcollective-plugins/wiki/AgentPuppetd
+[AgentPuppetca]: http://github.com/puppetlabs/mcollective-plugins/tree/master/agent/puppetca/
+[AgentPuppetRal]: http://github.com/puppetlabs/mcollective-plugins/tree/master/agent/puppetral/
+[PuppetCommander]: http://github.com/puppetlabs/mcollective-plugins/tree/master/agent/puppetd/commander/
+[RapidRuns]: http://www.devco.net/archives/2010/08/05/rapid_puppet_runs_with_mcollective.php
+[EC2Bootstrap]: http://www.devco.net/archives/2010/07/14/bootstrapping_puppet_on_ec2_with_mcollective.php
+[PuppetRalBlog]: http://www.devco.net/archives/2010/07/07/puppet_resources_on_demand.php
+[SchedulingPuppet]: http://www.devco.net/archives/2010/03/17/scheduling_puppet_with_mcollective.php
+[ManagingPuppetd]: http://www.devco.net/archives/2009/11/30/managing_puppetd_with_mcollective.php
+[CloudBootstrap]: http://vuksan.com/blog/2010/07/28/bootstraping-your-cloud-environment-with-puppet-and-mcollective/
+[ServiceAgent]: http://projects.puppetlabs.com/projects/mcollective-plugins/wiki/AgentService
+[PackageAgent]: http://projects.puppetlabs.com/projects/mcollective-plugins/wiki/AgentPackage
+[Facter2YAML]: http://www.semicomplete.com/blog/geekery/puppet-facts-into-mcollective.html
+
+If you're a Puppet user you are supported in both facts and classes filters.
+
+There are a number of community plugins related to Puppet:
+
+ * Manage the Puppetd, request runs, enable and disable - [AgentPuppetd]
+ * Manage the Puppet CA, sign, list and revoke certificates - [AgentPuppetca]
+ * Use the Puppet Ral to create resources on demand, a distributed *ralsh* - [AgentPuppetRal]
+ * Schedule your puppetd's controlling concurrency and resource usage - [PuppetCommander]
+ * The [ServiceAgent] and [PackageAgent] use the Puppet RAL to function on many operating systems
+
+There are also several blog posts related to Puppet and MCollective:
+
+ * Running puppet on a number of nodes as quick as possible - [RapidRuns]
+ * Bootstrapping a Puppet + EC2 environment with Puppet - [EC2Bootstrap]
+ * Using the Puppet RAL with MCollective - [PuppetRalBlog]
+ * General scheduling of Puppet Runs - [SchedulingPuppet]
+ * Managing Puppetd - [ManagingPuppetd]
+ * Bootstrapping your cloud environment - [CloudBootstrap]
+
+## Facts
+There is a [community plugin to enable Facter][FactsRLFacter] as a fact source.
+
+So you can use the facts provided by Facter in filters, reports etc.
+
+{% highlight console %}
+$ mco find --with-fact lsbdistrelease=5.4
+{% endhighlight %}
+
+This includes facts pushed out with [Plugin Sync][PluginSync].
+
+A less resource intensive approach has can be found [here][Facter2YAML], it converts the Puppet scope into a YAML file that the YAML fact source then loads.  This is both less resource intensive and much faster.
+
+## Class Filters
+Puppet provides a list of classes applied to a node by default in */var/puppet/state/classes.txt* or */var/lib/puppet/state/classes.txt* (depending on which Puppet version you are using. The latter is true for 0.25.5 onwards) , we'll use this data with *--with-class* filters.
+
+You should configure MCollective to use this file by putting the following in your *server.cfg*
+
+
+{% highlight ini %}
+classesfile = /var/lib/puppet/classes.txt
+{% endhighlight %}
+
+or if using Puppet 0.23.0 and onwards
+
+{% highlight ini %}
+classesfile = /var/lib/puppet/state/classes.txt
+{% endhighlight %}
+
+You can now use your classes lists in filters:
+
+{% highlight console %}
+$ mco find --with-class /apache/
+{% endhighlight %}