brendanhill / puppet-salt

Puppet module to install salt server/client

#puppet-salt

####Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with salt
   • What salt affects
   • Setup requirements
   • Beginning with salt
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.

salt Puppet Module

Manage salt client and server via Puppet.

##Module Description

This module can be used to install a single salt master/minion or both on one machine.

##Setup

###What salt affects

• salt master/minion package.
• salt master/minion configuration files.
• salt master/minion service.

###Beginning with salt

Just add manifest:

include salt

Or if you want to change params you need to include the underlying modules:

class { 'salt::minion': minion_package_name => 'salt-minion-git', }
class { 'salt::master': master_package_name => 'salt-master-git', }

##Usage

All interaction with the salt module can be done through the main salt class.

###I just want salt, what's the minimum I need?

include '::salt'

###I just want a salt minion?

include '::salt::minion'

###I just want a salt master?

this will install a salt master and a minion for itself.

include '::salt'

##Reference

###Classes

• salt: Main class, includes all the rest.
• salt::minion: Handles the minion.
• salt::master: Handles the master
• salt::params: all parameters needed for the rest.

###Parameters salt::minion

Here are just a few parameters that are available in the salt::minion module The rest you can look up in salt::params

####minion_config

This sets the file to write minion configuration into.

####minion_package_name

This determines the name of the package to install.

####minion_service_name

This selects the name of the salt minion service for puppet to manage.

###Parameters salt::master

Here are just a few parameters that are available in the salt::master module The rest you can look up in salt::params

####master_service_name

This selects the name of the salt minion service for puppet to manage.

####master_package_name

This determines the name of the package to install.

####master_config

This sets the file to write salt master configuration into.

##Limitations

This module has been built on and tested against Puppet 3.2.3 and higher.