StackStorm chef cookbook

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

Compatibility

Cookbook works with recent chef versions, but <12.4.0 due to a bug in platform detection code. (Method Chef::Platform.find_provider doesn't work properly in chef ~>12.4.0).

Supported Platforms

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

Attributes

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 optional and 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)