Packaging Plugins

MCollective has many plugins, the most common ones are agents.

In the past packaging was done via RPM or Deb packages, this was extremely limited requiring extra work to make configuration modules and of course only worked on those operating systems.


Choria includes a packager that turns a common MCollective plugin into a Puppet Module like the Puppet Agent one. It supports packaging plugins in the typical layout you might see in our official plugins, a good example is the Puppet Agent and others in the Choria Plugins organisation.


You need to have the Puppet Development Kit installed locally for this to work

You can package your own modules in this manner:

$ cd youragent
$ mco plugin package --vendor yourco

This will produce a Puppet module that you can install using Choria by adding it to the list of plugins to manage:

  - mcollective_agent_youragent

Additional Files

You can add additional files into the resulting module by creating a puppet directory within your repository. These files will be copied into the final module after any templates and README files were generated.

Use this to add additional files like functions, tasks and plans into your modules. You can also override any generated files in this manner. For example the Puppet Agent has a number of Plans included.

Plugin Configuration

Many MCollective plugins have extensive configuration, sometimes Server and Client side.

The choria-mcollective module lets you configure any setting in any plugin via Hiera data, here’s an example of configuring the Puppet one:

  "splay": false
  "signal_daemon": true

This creates files in /etc/puppetlabs/mcollective/plugin.d with the per plugin settings. This will only work on plugins distributed using the method shown above.

You can ship your own custom configuration items in the Plugin directory that gets mixed into the final default data, this can be used to add for example default Action Policies that allow read-only action.

Placing this in the .plugin.yaml of the top directory of the Puppet Agent causes a default ACL where anyone can run the last_run_summary and status actions:

  - action: "allow"
    callers: "*"
    actions: "last_run_summary status"
    facts: "*"
    classes: "*"

This can be used for any setting including config keys.