Ansible-st2

Ansible роли и плейбуки для развертывания StackStorm.

StackStorm — это платформа для автоматизации на основе событий, написанная на Python. С более чем 50 интеграциями такими как GitHub, Docker, Nagios, NewRelic, AWS, Ansible, она позволяет соединить вашу существующую инфраструктуру в сложные рабочие процессы с автоматизированным реагированием и многим другим. Это аналог IFTTT для операций.

Поддерживаемые платформы

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

Если вы используете предоставленный Vagrantfile, учтите, что по умолчанию используется Focal.

Чтобы получить доступ к Web UI StackStorm, не забудьте убедиться, что порты http и https разрешены в вашем файрволе.

Требования

Поддерживаемая версия Ansible и его зависимости. Необходимо как минимум 2 ГБ оперативной памяти и 3,5 ГБ свободного места на диске, так как StackStorm поставляется с RabbitMQ, Mongo, Redis и nginx.

Установка

# Развертывание StackStorm
ansible-playbook stackstorm.yml

Переменные

Ниже приведен список переменных, которые вы можете переопределить в своем плейбуке или инвентаре для настройки развертывания StackStorm:

Примеры

Установите последнюю stable версию StackStorm со всеми его компонентами на локальной машине:

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

Чтобы установить StackStorm на удаленной машине с именем stackstorm.example.com, создайте и укажите инвентарь:

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

Сохранение версии latest полезно для обновления StackStorm путем повторного выполнения плейбука, так как он переустановит (обновит) st2, когда будет доступна новая версия.

Это поведение по умолчанию. Если вы не хотите обновлений, рассмотрите возможность закрепления конкретной версии и номера ревизии.

Установите конкретную версию st2 с закрепленным номером ревизии:

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

Установка за прокси

Если вы устанавливаете за прокси, вы можете использовать переменные окружения http_proxy, https_proxy и no_proxy в плейбуке. Для st2smoketests вам нужно будет отключить прокси для localhost.

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

Разработка

Есть несколько требований при разработке на ansible-st2.

Это платформы, которые мы должны поддерживать (должны пройти крайние тесты):

• Ubuntu Focal (20.04)
• CentOS 7
• Rocky Linux 8
• RHEL 7 (через AWS)
• RHEL 8 (через AWS)

Плейбуки и роли должны поддерживать идемпотентность Ansible. То есть повторный запуск плейбука stackstorm.yml должен завершиться с результатом changed=0.*failed=0 (при условии, что версии и ревизии закреплены).

Для локальной разработки доступен Vagrantfile. По умолчанию следующая команда настроит виртуальную машину Ubuntu 20 (ubuntu/focal64):

vagrant up

Другие поддерживаемые дистрибутивы:

vagrant up ubuntu20
vagrant up centos7
vagrant up rockylinux8

Другие методы установки

Вас могут заинтересовать другие методы развертывания StackStorm:

• Управление конфигурацией

  • Модуль Puppet

• Ручные инструкции

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

Получение помощи

Если у вас возникли какие-либо проблемы, наше сообщество готово помочь, не стесняйтесь:

• Задавать вопросы в нашем публичном канале Slack
• Сообщать о проблемах, предоставлять запросы на новые функции или просто поставить этому проекту ✮ звезду

Ваши вопросы, комментарии и вклады более чем приветствуются и очень ценятся!