Version information
Start using this module
Add this module to your Puppetfile:
mod 'stackstorm-st2', '0.2.1'
Learn more about managing modules with a PuppetfileDocumentation
st2
Module to manage StackStorm
Currently tested with:
- Ubuntu 14.04
Compatability currently being tested:
- Debian 7
- Ubuntu 12.04
- RHEL/Centos 6/7
Maintainers
- James Fryman james@stackstorm.com
- Patrick Hoolboom patrick@stackstorm.com
Quick Start
For a full installation on a single node, a profile already exists to get you setup and going with minimal effort. Simply:
include ::st2::profile::fullinstall
Configuration
This module aims to provide sane default configurations, but also stay out of your way in the event you need something more custom. To accomplish this, this module uses the Roles/Profiles pattern. Included in this module are several modules that come with sane defaults that you can use directly or use to compose your own site-specific profile for StackStorm installation.
Configuration can be done directly via code composition, or set via Hiera data bindings. A few notable parameters to take note of:
st2::version
- Version of ST2 to install. (Latest version w/o value)st2::release
- Release of ST2 to install (Latest version w/o value)
All other classes are documented with Puppetdoc. Please refer to specific classes for use and configuration.
Profiles:
st2::profile::client
- Profile to install all client libraries for st2st2::profile::fullinstall
- Full installation of StackStorm and dependenciesst2::profile::mistral
- Install of OpenStack Mistralst2::profile::mongodb
- st2 configured MongoDB installationst2::profile::nodejs
- st2 configured NodeJS installationst2::profile::python
- Python installed and configured for st2st2::profile::rabbitmq
- st2 configured RabbitMQ installationst2::proflle::server
- st2 server componentsst2::profile::web
- st2 web components
Installing and configuring Packs
StackStorm packs can be installed and configured directly from Puppet. This
can be done via the st2::pack
and st2::pack::config
defined types.
Installation/Configuration via modules:
st2::pack { 'linux': }
st2::pack { ['librato', 'consul']:
repo_url => 'https://github.com/StackStorm/st2incubator.git',
}
st2::pack { 'slack':
repo_url => 'https://github.com/StackStorm/st2incubator.git',
config => {
'post_message_action' => {
'webhook_url' => 'XXX',
},
},
}
Installation/Configuration via Hiera:
st2::packs:
linux:
ensure: present
cicd:
ensure: present
repo_url: https://github.com/StackStorm/st2incubator.git
slack:
ensure: present
repo_url: https://github.com/StackStorm/st2incubator.git
config:
post_message_action:
webhook_url: XXX
st2web
st2web
is now included! To access the WebUI, simply point your browser at
http://(ipaddress):9101/webui.
Dependencies
- puppetlabs-stdlib (>= 1.0.0)
- nanliu-staging (>= 1.0.2)
- puppetlabs-apt (>= 1.7.0)
- maestrodev-git (>= 1.0.6)
- maestrodev-wget (>= 1.5.6)
- saz-sudo (>= 3.0.9)
- stankevich-python (>= 1.7.15)
- puppetlabs-gcc (>= 0.2.0)
- puppetlabs-inifile (>= 1.2.0)
- puppetlabs-mongodb (>= 0.8.0)
- puppetlabs-mysql (>= 3.0.0)
- puppetlabs-rabbitmq (>= 4.1.0)
- puppetlabs-vcsrepo (>= 1.2.0)