Forge Home

mcollective

Camptocamp MCollective Module

33,690 downloads

10,711 latest version

4.1 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 3.1.3 (latest)
  • 3.1.2
  • 3.1.1
  • 3.1.0
  • 3.0.6
  • 3.0.5
  • 3.0.4
  • 3.0.3
  • 3.0.2
  • 3.0.1
  • 3.0.0
  • 2.1.0
  • 2.0.7
  • 2.0.6
  • 2.0.4
  • 2.0.3
  • 2.0.2
  • 2.0.1
  • 2.0.0
  • 1.1.1
  • 1.1.0
  • 1.0.7
  • 1.0.6
  • 1.0.5
  • 1.0.4
  • 1.0.3
  • 1.0.2
  • 1.0.1
  • 0.8.1
  • 0.8.0
  • 0.7.0
  • 0.6.0
  • 0.5.0 (deleted)
  • 0.4.2 (deleted)
  • 0.4.1
  • 0.4.0
  • 0.3.4
  • 0.3.3
  • 0.3.2
  • 0.3.1
  • 0.3.0
  • 0.2.0
  • 0.1.0
  • 0.0.1
released Aug 18th 2015
This version is compatible with:
  • ,
This module has been deprecated by its author since Nov 25th 2021.

The reason given was: Deprecated

Start using this module

Documentation

camptocamp/mcollective — version 3.1.3 Aug 18th 2015

MCollective Puppet Module

Puppet Forge Version Puppet Forge Downloads Build Status Gemnasium By Camptocamp

This module manages MCollective.

It supports:

  • generic STOMP, ActiveMQ and RabbitMQ connectors (optionally over SSL)
  • PSK and SSL security providers
  • Action policy rules

This module is provided by Camptocamp

Simple usage

This module has a single access point class:

class { '::mcollective':
  broker_host       => 'rabbitmq.example.com',
  broker_port       => '61613',
  broker_ssl        => false,
  security_provider => 'psk',
  security_secret   => 'P@S5w0rD',
  use_node          => true,
  use_client        => false,
}

class { '::mcollective':
  broker_host       => 'rabbitmq.example.com',
  broker_port       => '61614',
  security_provider => 'ssl',
  use_node          => true,
  use_client        => true,
}

Classes

This module provides two classes to configure MCollective nodes and clients.

mcollective::node

Installs and configures an MCollective node:

class { '::mcollective':
  broker_host       => 'rabbitmq.example.com',
  broker_port       => '61614',
  security_provider => 'psk',
  security_secret   => 'P@S5w0rD',
  use_node          => false,
}
include ::mcollective::node

mcollective::client

Installs and configures an MCollective client:

class { '::mcollective':
  broker_host       => 'rabbitmq.example.com',
  broker_port       => '61614',
  security_provider => 'psk',
  security_secret   => 'P@S5w0rD',
  use_node          => false,
}
include ::mcollective::client

Definitions

Several definitions allow to enhance MCollective nodes and clients.

mcollective::plugin

Installs an MCollective plugin using packages:

mcollective::plugin { 'puppetca':
  ensure => present,
}

mcollective::application

Installs an MCollective application from a file:

mcollective::application { 'healthcheck':
  ensure => present,
}

mcollective::client::certificate

Deploys a public client SSL certificate for authentication:

mcollective::client::certificate { 'foo':
  ensure         => present,
  key_source_dir => 'puppet:///modules/module_name/path/to/dir/',
}

mcollective::actionpolicy::base

Sets up an base action policy file for an agent:

mcollective::actionpolicy::base { 'puppetd':
  ensure => present,
}

mcollective::actionpolicy

Sets up an action policy rule for an agent:

mcollective::actionpolicy { 'Allow puppetd status for cert foo':
  ensure    => present,
  agent     => 'puppetd',
  rpccaller => 'cert=foo',
  actions   => 'status',
}

Contributing

Please report bugs and feature request using GitHub issue tracker.

For pull requests, it is very much appreciated to check your Puppet manifest with puppet-lint to follow the recommended Puppet style guidelines from the Puppet Labs style guide.

License

Copyright (c) 2013 puppet@camptocamp.com All rights reserved.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.