Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/StackStorm/showcase-ansible-chatops
Vagrant Demo showing ChatOps with Ansible
https://github.com/StackStorm/showcase-ansible-chatops
ansible chatops demo hubot showcase slack st2 stackstorm vagrant
Last synced: 3 months ago
JSON representation
Vagrant Demo showing ChatOps with Ansible
- Host: GitHub
- URL: https://github.com/StackStorm/showcase-ansible-chatops
- Owner: StackStorm
- License: apache-2.0
- Created: 2015-06-04T11:38:37.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-12-19T22:33:15.000Z (over 5 years ago)
- Last Synced: 2024-01-20T02:44:10.427Z (5 months ago)
- Topics: ansible, chatops, demo, hubot, showcase, slack, st2, stackstorm, vagrant
- Language: Shell
- Homepage: https://stackstorm.com/2015/06/24/ansible-chatops-get-started-%f0%9f%9a%80/
- Size: 58.6 KB
- Stars: 76
- Watchers: 22
- Forks: 22
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-list-ansible - showcase-ansible-chatops
README
Ansible & ChatOps with Slack, Hubot and StackStorm - Vagrant demo
===========
> Part of tutorial: [Ansible and ChatOps. Get started :rocket:](https://stackstorm.com/2015/06/24/ansible-chatops-get-started-%f0%9f%9a%80/)
### Introduction
This is quick demonstration of the [StackStorm](http://stackstorm.com/) event-driven automation platform running with [Ansible](http://ansible.com/) configuration management tool and [Hubot](https://hubot.github.com/) ChatOps engine. The objective is to operate servers with Ansible directly from [Slack](http://slack.com/) chat.
[](https://stackstorm.com/2015/06/24/ansible-chatops-get-started-%f0%9f%9a%80/)
It will get you up and running with `chatops` control VM with all St2 components prepared as well as Ansible and Hubot configured.
Additionally, it installs 2 Ubuntu VMs: `web` server with nginx and `db` server with mysql.
As a result you should get 100% ready environment allowing you to execute [Ansible ad-hoc commands](http://docs.ansible.com/intro_adhoc.html) and run [Ansible playbooks](http://docs.ansible.com/playbooks.html) against VMs directly from your Slack chat. In this showcase we already crafted some simple, but useful real world ChatOps commands.
### Getting started
#### 1. Prepare Slack
* Create [slack.com](http://slack.com/) account if you don't have it yet.
* Navigate `Configure Integrations -> Filter -> Hubot` and generate Slack & Hubot API Token.
#### 2. Vagrant up
Edit [`Vagrantfile`](Vagrantfile#L5) and add the just generated API token under `HUBOT_SLACK_TOKEN` constant, or just export it:
```sh
export HUBOT_SLACK_TOKEN=xoxb-1234-5678-91011-00e4dd
```
To provision the environment run:
```sh
vagrant up
```
Installation takes some time (st2 engine comes with Python, RabbitMQ, PostgreSQL, MongoDB, OpenStack Mistral).
#### 3. Try ChatOps
You should see your bot online in Slack and now you're ready to type some chat commands. Don't forget to invite your bot into the Slack channel: `/invite @stanley`. Your first ChatOps command is:
```
!help
```
Full list of available commands from [st2_chatops_aliases](https://github.com/armab/st2_chatops_aliases) pack:
* [`!ansible `](https://i.imgur.com/9xEgfP6.png) - Run ansible command on local machine
* [`!status `](https://i.imgur.com/ZOZgGnz.png) - Show status for hosts (ansible ping module)
* [`!show nginx stats on `](https://i.imgur.com/Wsvdx3W.png) - Show sorted http status codes from nginx on hosts
* [`!show mysql processlist `](https://i.imgur.com/RxePho1.png) - Show MySQL processlist
* [`!service restart on `](https://i.imgur.com/rNsHdtK.png) - Restart service on remote hosts
* [`!show version on `](https://i.imgur.com/M8hTv9W.png) - Show package versions on hosts
* [`!update on `](https://i.imgur.com/aOEApkR.png) - Update package on remote hosts
* [`!cowsay `](https://i.imgur.com/mCYHFM6.png) - Draws a cow that says what you want
> Additionally check the results of performed commands in StackStorm control panel:
https://www.chatops/
username: `demo`
password: `demo`
#### 4. Don't stop!
Try it, explore the internals. For configuration see: [`ansible.sh`](ansible.sh), [`chatops.sh`](chatops.sh) which are usual Vagrant shell provisioner scripts.
Integrate your custom workflows and deployment mechanisms, you'll see how your work becomes more efficient during time.
Feel the power of control center and may the force will be with you!
#### Need Help? Want to talk?
[](https://stackstorm.com/community-signup) [](http://webchat.freenode.net/?channels=stackstorm)
We're always ready to help, feel free to:
* Ask questions on our public Slack or IRC
* Report bug, provide feature request or just give us a ✮ star at [GitHub st2](https://github.com/StackStorm/st2)
* Tell us how you use st2, share your StackStorm story. We love stories!