Ansible-st2

Roles y playbooks de Ansible para desplegar StackStorm.

StackStorm es una plataforma de automatización impulsada por eventos escrita en Python. Con más de 50 integraciones como GitHub, Docker, Nagios, NewRelic, AWS y Ansible, te permite conectar tu infraestructura existente en flujos de trabajo complejos con auto-remediación y mucho más. Es la orquestación de IFTTT para operaciones.

Plataformas soportadas

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

Si estás usando el Vagrantfile proporcionado, ten en cuenta que usa Focal por defecto.

Para acceder a la interfaz web de StackStorm, no olvides asegurarte de que los puertos http y https están permitidos por el cortafuegos.

Requisitos

Una versión soportada de Ansible y sus dependencias. Se requieren al menos 2 GB de memoria y 3.5 GB de espacio en disco, ya que StackStorm se envía con RabbitMQ, Mongo, Redis y nginx.

Instalación

# Desplegar StackStorm
ansible-playbook stackstorm.yml

Variables

A continuación se presenta una lista de variables que puedes redefinir en tu playbook o inventario para personalizar el despliegue de StackStorm:

Ejemplos

Instala la versión stable más reciente de StackStorm con todos sus componentes en la máquina local:

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

Para instalar StackStorm en una máquina remota llamada stackstorm.example.com, crea y referencia un inventario:

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

Mantener la versión latest es útil para actualizar StackStorm volviendo a ejecutar el playbook, ya que reinstalará (actualizará) st2 cuando haya una nueva versión disponible.

Este es el comportamiento predeterminado. Si no deseas actualizaciones, considera fijar números de versión y revisión específicos.

Instala una versión específica de st2 con un número de revisión fijado:

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

Instalación detrás de un proxy

Si estás instalando detrás de un proxy, puedes usar las variables de entorno http_proxy, https_proxy y no_proxy en el playbook. Para las pruebas de humo de st2, necesitarás desactivar el proxy para localhost.

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

Desarrollo

Hay algunos requisitos a la hora de desarrollar sobre ansible-st2.

Estas son las plataformas que debemos soportar (deben pasar pruebas de extremo a extremo):

• Ubuntu Focal (20.04)
• CentOS 7
• Rocky Linux 8
• RHEL 7 (a través de AWS)
• RHEL 8 (a través de AWS)

Los playbooks y roles deben soportar la idempotencia de Ansible. Es decir, volver a ejecutar el playbook stackstorm.yml debe acabar con el resultado changed=0.*failed=0 (siempre que las versiones y revisiones estén fijadas).

Para el desarrollo local, hay un Vagrantfile disponible. Por defecto, el siguiente comando configurará una máquina virtual Ubuntu 20 (ubuntu/focal64):

vagrant up

Otras distribuciones soportadas:

vagrant up ubuntu20
vagrant up centos7
vagrant up rockylinux8

Otros métodos de instalación

Quizás te interese otros métodos para desplegar StackStorm:

• Gestión de Configuración

  • Módulo Puppet

• Instrucciones Manuales

  • Ubuntu Bionic (18.04)
  • Ubuntu Focal (20.04)
  • RHEL 8 / Rocky Linux 8
  • RHEL 7 / CentOS 7

Obtener ayuda

Si encuentras algún problema, nuestra comunidad está lista para ayudar, no dudes en:

• Hacer preguntas en nuestro canal público de Slack
• Reportar problemas, proporcionar solicitudes de funciones, o simplemente dar una ✮ estrella a este proyecto

¡Tus preguntas, comentarios y contribuciones son más que bienvenidos y muy apreciados!