#puppet-salt
####Table of Contents
- Overview
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with salt
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- 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.