st2

Module to manage StackStorm

Currently tested with:

• Ubuntu 14.04
• RHEL/Centos 6/7

Compatability currently being tested:

• Debian 7
• Ubuntu 12.04

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.

NG-Init

As of StackStorm v0.12.0, the transition to init scripts has begun. To enable init scripts (Upstart only, currently. SystemD in progress), add the following flag to hiera or via code composition.

• st2::ng_init - Boolean

This will apply init scripts to be managed by the OS.

Each of the network services has an environment variable that can be passed that will disable the spawning of the stand-alone service. This is useful when setting up uWSGI or other services. This is necessary to remain compatability with st2ctl during the transition period to init scripts.

• ST2_DISABLE_HTTPSERVER - Disable SimpleHTTPServer for WebUI
• ST2_DISABLE_API - Disable StandAlone API Server
• ST2_DISABLE_AUTH - Disable StandAlone Auth Server

Profiles:

• st2::profile::client - Profile to install all client libraries for st2
• st2::profile::fullinstall - Full installation of StackStorm and dependencies
• st2::profile::mistral - Install of OpenStack Mistral
• st2::profile::mongodb - st2 configured MongoDB installation
• st2::profile::nodejs - st2 configured NodeJS installation
• st2::profile::python - Python installed and configured for st2
• st2::profile::rabbitmq - st2 configured RabbitMQ installation
• st2::proflle::server - st2 server components
• st2::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

Changelog

0.10.13 (Oct 22, 2015)

• Add st2packs to default deploy and ensure Stanley exists
• Limit setting of api_url to st2::helper::auth_manager

0.10.8 (Oct 21, 2015)

• Adding api_url parameter to server profile

0.10.7 (Oct 21, 2015)

• Adding backend kwargs attribute to st2::helper::auth_manager
• Disable static UID for auto-generated users

0.10.4 (Oct 19. 2015)

• Fix for RHEL 6 client package installation
• Re-enable ng_init env flag to compat with st2ctl
• Fix issue with actionrunners outputting to STDOUT/STDERR
• All SysV init scripts ensure sourcing from /etc/environment

0.10.1 (Oct 16. 2015)

• Init scripts default install now

0.10.0 (Oct 15, 2015)

• Bug fixes
• Service restart with Ini_setting { tag => 'st2::config' }

0.9.19 (Oct 14, 2015)

• Repair init scripts for Mistral on RHEL 6/7 and Debian

0.9.17 (Oct 14, 2015)

• Repair package map with CentOS 7 systems

0.9.15 (Oct 13, 2015)

• Support for SysV and SystemD Init types

0.9.14 (Oct 2, 2015)

• Ensure postgresql is setup and running before starting Mistral service.

0.9.12 (Oct 1, 2015)

• Refresh services on ini setting change.

0.9.11 (Oct 1, 2015)

• Add ability for user to change SSH key location in /etc/st2/st2.conf

0.9.10 (Sept 28, 2015)

• Fix typo in RBAC type.

0.9.8 (Sept 25, 2015)

• Add ability to manage StackStorm RBAC roles (improvement)

0.9.7 (Sept 22, 2015)

• Restart mistral on init script update

0.9.6 (Sept 22, 2015)

• Add silence_ssl_warnings option to the client profile.

0.9.5 (Sept 21, 2015)

• pin stahnma-epel to 1.1.0

0.9.4 (Sept 18, 2015)

• Restart services on package update (bugfix)

0.9.3 (Sept 17, 2015)

• Fix condition where autoupdate: false would result in missing resources (bugfix)

0.9.2 (Sept 17, 2015)

• Configure WebUI to integrate with Flow (feature)
• Configure st2client CLI settings for any user (improvement)

0.9.0 (Sept 16, 2015)

• Add support for RHEL/CentOS 6 & 7

0.8.0 (Sept 10, 2015)

• Release StackStorm v0.13.2
• Stop st2::pack resource restarting StackStorm (improvement)

0.7.10 (Sept 2, 2015)

• Fix manage_mysql -> manage_postgresql in st2::profile::server (bugfix)
• Fix error with stanley user UID change (bugfix)

0.7.9 (Sept 1, 2015)

• Fix path for logging config with st2auth subsystem (bugfix)

0.7.8 (Aug 30, 2015)

• Allow user to adjust username of 'st2::stanley' resource (improvement)

0.7.7 (Aug 29, 2015)

• Bump default StackStorm version to 0.13.1 (upgrade)