DEPRECATED!
Due to low interest from the StackStorm Communitychef-stackstormcookbook support and development is discontinued.Help Wanted!
If you're using this deployment method and interested in maintaining it, please contact StackStorm project Owners.
Cookbook to install and configure StackStorm components using Chef.
StackStorm is event-driven automation platform written in Python. With over 100+ integrations like GitHub, Docker, Nagios, NewRelic, AWS, Chef, Slack it allows you to wire together existing infrastructure into complex Workflows with auto-remediation and many more. Aka IFTTT orchestration for Ops.
- Ubuntu 14.04 LTS
- RHEL7 / CentOS7
Minimum 2GB of memory and 3.5GB of disk space is required, since StackStorm is shipped with RabbitMQ, PostgreSQL, Mongo and OpenStack Mistral workflow engine. See System Requirements for production use.
For those who want to play with StackStorm, a recipe already exists to get you setup and going with minimal effort:
recipe[stackstorm::bundle]Installs and configures st2.
Mind that the valid config options must be provided such as RabbitMQ and MongoDB endpoints.
Otherwise StackStorm services fail when trying to establish connections.
All-in-one solution which installs and configures st2 system services as well as all required dependencies such as RabbitMQ, MongoDB, st2mistral, Nginx and st2web.
Installs StackStorm Web UI control panel (st2web) and configures nginx as a proxy for StackStorm services.
It will generate self-signed certificate by default, see Install WebUI and setup SSL termination.
| Key | Type | Description | Default |
|---|---|---|---|
['stackstorm']['config'] | Hash | Various options used to build up the st2.conf configuration file. | see config.rb |
['stackstorm']['username'] | String | StackStorm username for simple htpasswd-based authentication. | st2admin |
['stackstorm']['password'] | String | StackStorm password. | Ch@ngeMe |
To run local and remote shell actions, StackStorm uses a special system user (default stanley). For remote Linux actions, SSH is used. It is advised to configure SSH key-based authentication on all remote hosts.
| Key | Type | Description | Default |
|---|---|---|---|
['stackstorm']['user']['user'] | String | System user used by stackstorm stack. | stanley |
['stackstorm']['user']['group'] | String | System group used by stackstorm stack. | stanley |
['stackstorm']['user']['home'] | String | Path to stanley's home directory. | /home/stanley |
['stackstorm']['user']['authorized_keys'] | Array | List of ssh public keys added to stanley's ~/.ssh/authorized_keys file. | [] |
['stackstorm']['user']['ssh_key'] | String | Stanley's ssh private key. | nil |
['stackstorm']['user']['ssh_pub'] | String | Stanley's ssh public key. | nil |
['stackstorm']['user']['ssh_key_bits'] | Integer | Specifies the number of bits for ssh key creation. | 2048 |
['stackstorm']['user']['enable_sudo'] | Boolean | Enables sudo privileges for stanley. | true |
Stanley's ssh key is automatically generated if no ssh_key is provided. If root privileges for running actions are required stanley must be a valid sudoer. This is the default behavior. |
Settings for StackStorm Web UI st2web and nginx.
| Key | Type | Description | Default |
|---|---|---|---|
['stackstorm']['web']['ssl']['self_signed']['enabled'] | Boolean | Enable self-signed certificate generation. | true |
['stackstorm']['web']['ssl']['self_signed']['org'] | String | Self-signed certificate O field. | StackStorm |
['stackstorm']['web']['ssl']['self_signed']['org_unit'] | String | Self-signed certificate OU field. | Information Technology |
['stackstorm']['web']['ssl']['self_signed']['country'] | String | Self-signed certificate C field. | US |
- Author:: StackStorm (st2-dev) (info@stackstorm.com)
- Author:: Eugen C. (armab@stackstorm.com)
- Author:: Denis Baryshev (dennybaa@gmail.com)
- Contributor:: Bao Nguyen (ngqbao@gmail.com)
- Contributor:: Grant Ridder
- Contributor:: Javier Palomo Almena
You might be interested in other methods to deploy StackStorm engine:
Configuration Management
Manual Instructions