Ansible-st2

This contains Ansible roles and playbooks to set up StackStorm.

StackStorm is an automation platform that runs on events and is written in Python. It integrates with over 50 tools like GitHub, Docker, Nagios, and AWS, allowing you to connect your current infrastructure into complex workflows for tasks like automatic recovery.

Supported Platforms

• Ubuntu Focal (20.04)
• RHEL 7 and CentOS 7
• RHEL 8 and Rocky Linux 8

If you use the provided Vagrantfile, it defaults to Ubuntu Focal.

Remember to allow HTTP and HTTPS ports in your firewall to access the StackStorm Web UI.

Requirements

You need a compatible version of Ansible and its dependencies. You also need at least 2 GB of RAM and 3.5 GB of disk space, as StackStorm includes RabbitMQ, Mongo, Redis, and nginx.

Installation

# Deploy StackStorm
ansible-playbook stackstorm.yml

Variables

Here are the variables you can change in your playbook or inventory to customize your StackStorm setup:

Examples

To install the latest stable StackStorm on a local machine:

ansible-playbook --inventory localhost, --connection local stackstorm.yml

To install StackStorm on a remote machine named stackstorm.example.com, create an inventory file:

echo "stackstorm.example.com" > inventory
ansible-playbook --inventory inventory stackstorm.yml

You can keep StackStorm updated by re-running the playbook with the latest version setting.

To install a specific version of StackStorm:

ansible-playbook stackstorm.yml --extra-vars "st2_version=2.2.0 st2_revision=8"

Installing Behind a Proxy

If you're installing from behind a proxy, you can specify environment variables in the playbook:

environment:
  http_proxy: http://proxy.example.net:3128
  https_proxy: http://proxy.example.net:3128
  no_proxy: 127.0.0.1,localhost

Development

For development with ansible-st2, ensure compatibility with the following platforms:

• Ubuntu Focal (20.04)
• CentOS 7
• RHEL 7 (via AWS)
• RHEL 8 (via AWS)

The playbooks should support Ansible idempotence, which means running the playbook multiple times should not produce changes unless you've updated versions.

For local development, you can use the provided Vagrantfile:

vagrant up

You can also set up other supported distributions:

vagrant up centos7
vagrant up rockylinux8

Other Installation Methods

Other ways to deploy StackStorm include:

• Configuration Management

  • Puppet Module

• Manual Instructions

  • Ubuntu Bionic (18.04)
  • RHEL 8 / Rocky Linux 8

Getting Help

If you run into issues, join our community for support:

• Ask questions in our public Slack channel
• Report issues, request features, or give this project a star.

We welcome your input and contributions!