Name: puppet-heat
Owner: Example42
Description: Minimal Puppet module for OpenStack Heat
Created: 2014-02-19 12:05:53.0
Updated: 2014-09-25 23:21:33.0
Pushed: 2014-02-19 14:07:42.0
Homepage: null
Size: 112
Language: Puppet
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
This module installs, manages and configures heat and its services.
The module is based on stdmod naming standards version 0.9.0.
Refer to http://github.com/stdmod/ for complete documentation on the common parameters.
For a fully automated Puppet setup of OpenStack you'd better use the official StackForge modules. This module is intended to be a quick replacement for setups where you want to manage configurations based on plain template files or where you want to puppettize an existing OpenStack installation.
To install the package provided by the module just include it:
include heat
The main class arguments can be provided either via Hiera (from Puppet 3.x) or direct parameters:
class { 'heat':
parameter => value,
}
The module provides a generic define to manage any heat configuration file in /etc/heat:
heat::conf { 'sample.conf':
content => '# Test',
}
A define to manage the package/service/configfile of single heat services. To install the package and run the service:
heat::generic_service { 'heat-registry': }
heat::generic_service { 'heat-api': }
To provide a configuration file for the service (alternative to heat::conf):
heat::generic_service { 'heat-registry':
config_file_template => 'site/heat/heat-registry.conf
}
A common way to use this module involves the management of the main configuration file via a custom template (provided in a custom site module):
class { 'heat':
config_file_template => 'site/heat/heat.conf.erb',
}
You can write custom templates that use setting provided but the config_file_options_hash paramenter
class { 'heat':
config_file_template => 'site/heat/heat.conf.erb',
config_file_options_hash => {
opt => 'value',
opt2 => 'value2',
},
}
Use custom source (here an array) for main configuration file. Note that template and source arguments are alternative.
class { 'heat':
config_file_source => [ "puppet:///modules/site/heat/heat.conf-${hostname}" ,
"puppet:///modules/site/heat/heat.conf" ],
}
Recurse from a custom source directory for the whole configuration directory (/etc/heat).
class { 'heat':
config_dir_source => 'puppet:///modules/site/heat/conf/',
}
Use custom source directory for the whole configuration directory and purge all the local files that are not on the dir. Note: This option can be used to be sure that the content of a directory is exactly the same you expect, but it is desctructive and may remove files.
class { 'heat':
config_dir_source => 'puppet:///modules/site/heat/conf/',
config_dir_purge => true, # Default: false.
}
Use custom source directory for the whole configuration dir and define recursing policy.
class { 'heat':
config_dir_source => 'puppet:///modules/site/heat/conf/',
config_dir_recursion => false, # Default: true.
}
Do not trigger a service restart when a config file changes.
class { 'heat':
config_dir_notify => '', # Default: Service[heat]
}
This is tested on these OS:
Pull requests (PR) and bug reports via GitHub are welcomed.
When submitting PR please follow these quidelines:
When submitting bug report please include or link: