This is an Ansible role for Hubot, the wonderful chatting robot that is sure to bring your team much delight and various values of increased productivity throughout the livelong day!

By default this Hubot role uses the Slack adapter, but you can change the role to work with another adapter like HipChat by editing defaults/main.yml, updating the value of hubot_adapter, and adding the appropriate environment variables to defaults.main.yml file.

This role requires a Ubuntu or CentOS based Linux host; it's known to function on Ubuntu and CentOS with the following software versions:

• Ansible: 2.2.0.0
• Hubot: GitHub Master
• Node.js: 6.9.1
• CentOS: 6
• Ubuntu: 14.04, 13.10, 13.04, 12.10, 12.04

You can install this role with the ansible-galaxy command instead of running directly from the git repository.

Install it like this:

ansible-galaxy install brianshumate.hubot

You'll want to make sure you have write access to /etc/ansible/roles/ since that is the default installation path, or define your own Ansible role path by creating a $HOME/.ansible.cfg file with these contents:

[defaults]
roles_path = <path_to_your_preferred_role_location>

Change <path_to_your_preferred_role_location> to a directory you have write access to.

See the ansible-galaxy documentation for more details.

All role variables should be in defaults/main.yml.

The hubot_node_packages defines the following Node.js dependency packages:

• cheerio
• chrono-node
• clark
• htmlparser
• hubot-ascii-art
• hubot-coin
• hubot-calculator
• hubot-hipchat-emoticons
• hubot-{{ hubot_adapter }}
• hubot-redis-brain
• hubot-scripts
• hubot-xkcd
• hubot-youtube
• lodash
• moment
• nodepie
• soupselect
• textspark

Note that newer Hubot scripts are now also node modules.

The hubot_centos_os_packages and hubot_ubuntu_os_packages variables define OS packages required by Hubot; they should be fine as-is.

The hubot_os_packages defines following OS dependency packages:

• build-essential
• curl
• git-core
• libssl-dev
• libexpat1-dev
• redis-server

Redis required for redis brain functionality.

You can enable more Hubot scripts by adding them to the hubot_node_packages and hubot_external_scripts variables.

First, edit the variables defined in defaults/main.yml as necessary.

Then, copy the necessary templates/hubot_?.env.j2 to templates/_hubot_?.env.j2 where ? is your hubot_adapter value, and update as necessary with the particular environment variables you need for your Hubot instance.

Copy hosts.example to hosts and edit it to update the values for your Hubot host. Be sure to change the following values:

• 0.0.0.0
• ubuntu
• ~/.ssh/hubot_id

Update the site.yml playbook if you plan to use it and set hubot_identity to the short user name of your bot.

After configuration a basic Hubot installation and activation is possible using the included site.yml playbook:

ansible-playbook -i hosts site.yml

You can also pass variables in using the --extra-vars option to the ansible-playbook command:

ansible-playbook -i hosts site.yml --extra-vars "hubot_admin=penelope hubot_adapter=hipchat hubot_identity=penelope hubot_owner='Penelope <[email protected]>' hubot_description='A stunning mermaid bot'"

You can test the role with Molecule.

The molecule configuration resides at the root of the role in the molecule.yml file. This role is tested against Ubuntu Trusty 64 and Centos 7, but you can add other platforms if needed.

To setup the test environment run the following commands:

mkvirtualenv -p $(which python2) molecule
pip install molecule ansible

To test the role run molecule test --platform trusty64 or molecule test --platform centos7.

None

Apache 2

Brian Shumate

See CONTIRBUTORS.MD