Ansible-st2

Ansible est un outil qui permet de déployer StackStorm.

StackStorm est une plateforme d'automatisation basée sur des événements, écrite en Python. Avec plus de 50+ intégrations comme GitHub, Docker, Nagios, NewRelic, AWS et Ansible, elle vous permet de connecter votre infrastructure existante en des flux de travail complexes avec auto-rémédiation et bien plus encore. En gros, c'est une orchestration similaire à IFTTT pour les opérations.

Plateformes prises en charge

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

Si vous utilisez le fichier Vagrantfile fourni, sachez qu'il utilise Focal par défaut.

Pour accéder à l'interface Web de StackStorm, n'oubliez pas de vous assurer que les ports http et https sont autorisés par le pare-feu.

Exigences

Une version prise en charge d'Ansible et ses dépendances. Il est nécessaire d'avoir au moins 2 Go de mémoire et 3,5 Go d'espace disque, car StackStorm est livré avec RabbitMQ, Mongo, Redis et nginx.

Installation

# Déployer StackStorm
ansible-playbook stackstorm.yml

Variables

Voici la liste des variables que vous pouvez redéfinir dans votre playbook ou votre inventaire pour personnaliser le déploiement de StackStorm :

Exemples

Installer la dernière version stable de StackStorm avec tous ses composants sur une machine locale :

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

Pour installer StackStorm sur une machine distante nommée stackstorm.example.com, créez et référencez un inventaire :

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

Conserver la version latest est utile pour mettre à jour StackStorm en exécutant de nouveau le playbook, car il réinstallera (mettra à niveau) st2 lorsqu'une nouvelle version sera disponible.

C'est le comportement par défaut. Si vous ne souhaitez pas de mises à jour, envisagez d'épingler des numéros de version et de révision spécifiques.

Installer une version spécifique de st2 avec un numéro de révision épinglé :

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

Installation derrière un proxy

Si vous installez derrière un proxy, vous pouvez utiliser les variables d'environnement http_proxy, https_proxy et no_proxy dans le playbook. Pour les tests st2smoketests, vous devrez désactiver le proxy pour localhost.

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

Développement

Il y a quelques exigences lors du développement sur ansible-st2.

Voici les plateformes que nous devons prendre en charge (doivent passer des tests de bout en bout) :

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

Les playbooks et rôles doivent prendre en charge l'idempotence d'Ansible. C'est-à-dire que relancer le playbook stackstorm.yml doit se terminer avec le résultat changed=0.*failed=0 (à condition que les versions et révisions soient épinglées).

Pour le développement local, un Vagrantfile est disponible. Par défaut, la commande suivante mettra en place une machine virtuelle Ubuntu 20 (ubuntu/focal64) :

vagrant up

Autres distributions prises en charge :

vagrant up ubuntu20
vagrant up centos7
vagrant up rockylinux8

Autres méthodes d'installation

Vous pourriez être intéressé par d'autres méthodes pour déployer StackStorm :

• Gestion de configuration

  • Module Puppet

• Instructions manuelles

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

Obtenir de l'aide

Si vous rencontrez des problèmes, notre communauté est prête à aider, n'hésitez pas à :

• Poser des questions dans notre canal Slack public
• Signaler des problèmes, proposer des demandes de fonctionnalités, ou simplement donner une étoile à ce projet ✮

Vos questions, commentaires et contributions sont les bienvenus et grandement appréciés !