StackStorm chef cookbook

Cookbook for StackStorm Automation as a Service. This cookbook is used to install and bring up St2 components using Chef.

Compatibility

Use version <0.2.5 of this cookbook with chef <12.4.0.

Starting with version *0.3.0, Packagecloud repo will be used to install Stackstorm packages instead of building from source.

Supported Platforms

Tested to work on ubuntu 14.04, fedora 20 and centos 7.0.

Attributes

NOTE: By default, latest stable version of st2 and st2mistral will be installed. Overwrite this behavior using custom wrapper cookbook.

Common attributes

User management

StackStorm uses system_user option to specify privileges used to execute local or remote actions. This user is managed and configured by this cookbook. Stanley user is different from run_user whose privileges used for running all St2 services (except action runners). Action runners are started with root privileges and StackStorm drops them to stanley's privileges during action execution. If root privileges for running actions are required stanley must be valid sudoer.

Stanley's ssh key is automatically generated if no ssh_key is provided. This is the default behavior.

stackstorm.config attributes

There are different attributes providing options values which are substituted into st2.conf file. For more details have look at the [config.rb](attributes/config.rb).

Usage

StackStorm nodes can have several roles these are controller and worker. Controller nodes run API service, sensor container and others. While workers execute actions on nodes so they run only action runner and mistral executor services.

Usage of mistral is provided by the mistral cookbook, details are here

To chose specific roles for a node define ['stackstorm']['roles'] attribute to contain one of the following roles: controller, worker, client, or their combination combination. For example with a json attribute file.

{
  "run_list": [ "recipe[stackstorm::default]" ],
  "attributes": {
    "stackstorm": {
      "roles": [ "worker", "client" ],
      "config": { "lots of": "configuration" }
    }
  }
}

Invocation

Define roles with the stackstorm.roles attribute, provide valid configuration options and include "recipe[stackstorm::default]" into your run list. The default recipe downloads and installs StackStorm packages required for given roles, writes configuration files and filnally brings up StackStorm system services.

Mind that the valid configuration must be provided such as RabbitMQ and MongoDB endpoints. Otherwise StackStorm services fail when trying to establish connections.

stackstorm::bundle

For those who wants to play with StackStorm there's an all-in-one solution which installs and configures StackStorm system services as well as all required components such as RabbitMQ, MongoDB and Mistral . To install pre-configured StackStorm bundle just include the "recipe[stackstorm::bundle]" into your run list.

License and Authors

• Author:: StackStorm (st2-dev) (info@stackstorm.com)
• Author:: Denis Baryshev (dennybaa@gmail.com)

Contributors

• Bao Nguyen (ngqbao@gmail.com)