Ansible-st2

Ansible role i playbooki do wdrożenia StackStorm.

StackStorm to platforma automatyzacji oparta na zdarzeniach napisana w Pythonie. Z ponad 50 integracjami takimi jak GitHub, Docker, Nagios, NewRelic, AWS, Ansible umożliwia połączenie istniejącej infrastruktury w złożone przepływy pracy z automatycznym usuwaniem błędów i wiele więcej. To jak IFTTT dla operacji.

Obsługiwane platformy

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

Jeśli korzystasz z dostarczonego Vagrantfile, pamiętaj, że domyślnie używa Focal.

Aby uzyskać dostęp do interfejsu użytkownika StackStorm, nie zapomnij upewnić się, że porty http i https są dozwolone przez zaporę.

Wymagania

Wymagana jest obsługiwana wersja Ansible oraz jej zależności. Potrzebne jest co najmniej 2 GB pamięci i 3,5 GB przestrzeni dyskowej, ponieważ StackStorm jest dostarczany z RabbitMQ, Mongo, Redis i nginx.

Instalacja

# Wdróż StackStorm
ansible-playbook stackstorm.yml

Zmienne

Poniżej znajduje się lista zmiennych, które można zdefiniować w swoim playbooku lub inwentarzu, aby dostosować wdrożenie StackStorm:

Przykłady

Zainstaluj najnowszą wersję stable StackStorm ze wszystkimi jego komponentami na lokalnej maszynie:

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

Aby zainstalować StackStorm na zdalnej maszynie nazwanej stackstorm.example.com, utwórz i odwołaj się do inwentarza:

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

Utrzymywanie wersji latest jest przydatne do aktualizacji StackStorm poprzez ponowne uruchomienie playbooka, ponieważ zainstaluje (zaktualizuje) st2, gdy dostępna jest nowa wersja.

To jest domyślne zachowanie. Jeśli nie chcesz aktualizacji, rozważ przypięcie do konkretnych wersji i numerów rewizji.

Zainstaluj konkretną wersję st2 z przypiętym numerem rewizji:

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

Instalacja za proxy

Jeśli instalujesz za proxy, możesz użyć zmiennych środowiskowych http_proxy, https_proxy i no_proxy w playbooku. Dla testów st2smoketests musisz wyłączyć proxy na localhost.

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

Rozwój

Istnieje kilka wymagań podczas rozwijania ansible-st2.

Oto platformy, które musimy obsługiwać (muszą przechodzić testy end-to-end):

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

Playbooki i role muszą wspierać idempotencję Ansible. To znaczy, ponowne uruchomienie playbooka stackstorm.yml musi kończyć się wynikiem changed=0.*failed=0 (pod warunkiem, że wersje i rewizje są przypięte).

Dla lokalnego rozwoju jest dostępny Vagrantfile. Domyślnie, następujące polecenie skonfiguruje pudełko ubuntu20 (ubuntu/focal64):

vagrant up

Inne wspierane dystrybucje:

vagrant up ubuntu20
vagrant up centos7
vagrant up rockylinux8

Inne metody instalacji

Możesz być zainteresowany innymi metodami wdrożenia StackStorm:

• Zarządzanie konfiguracją

  • Moduł Puppet

• Instrukcje ręczne

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

Uzyskiwanie pomocy

Jeśli napotkasz jakiekolwiek problemy, nasza społeczność jest gotowa do pomocy, nie wahaj się:

• Zadawaj pytania w naszym publicznym kanale Slack
• Zgłaszaj problemy, dostarczaj prośby o funkcje lub po prostu daj temu projektowi ✮ gwiazdkę

Twoje pytania, uwagi i wkłady są bardzo mile widziane i doceniane!