stuvusit / ansible_mattermost_hubot

Ansible role to deploy and configure a mattermost-hubot

mattermost-hubot

Installs and configure hubot for the use with a Mattermost instance. The NodeJS 10 PPA is used to have an up2date npm version.

Requirements

A Debian-based system

Role Variables

Name	Required/Default	Description
mattermost_hubot_install_path	/var/www/mattermost-hubot	Path where to install the hubot files to
mattermost_hubot_user	www-data	User under which the hubot should run. The user has to exist
mattermost_hubot_group	www-data	Group under which the hubot should run. The group has to exist
mattermost_hubot_mattermost_host	✔️	URL to the mattermost instance
mattermost_hubot_mattermost_team	✔️	Team name where the hubot should run under
mattermost_hubot_mattermost_user	✔️	The user that should be used to login
mattermost_hubot_mattermost_password	✔️	The password for mattermost_hubot_mattermost_user
mattermost_hubot_websocket_port	443	Overrides the default port 443 for websocket (wss://) connections
mattermost_hubot_http_port	443	Overrides the default port (80 or 443) for http:// or https:// connections
mattermost_hubot_tls_verify	True	Set to False to disable certificate verfication
mattermost_hubot_use_tls	True	Set to False to switch to http/ws protocols
mattermost_hubot_log_level	info	Set log level
mattermost_hubot_reply	True	Set to False to stop posting reply responses as comments
mattermost_hubot_ignore_users		List of users that should be ignored
mattermost_hubot_owner	✔️	Mail of person that runs this bot
mattermost_hubot_name	James	Name under which the bot should react
mattermost_hubot_description	Your friendly and helpful bot	Description which the bot should use
mattermost_hubot_environment	{}	Dictionary to set more enviroment variables. The key is the variable name and the value the value
mattermost_hubot_plugins	See below	List of plugins to be installed. Name of the package is the same name used in the npm package repository.

mattermost_hubot_plugins default

Per default following packages are installed:

• hubot-diagnostics
• hubot-help
• hubot-heroku-keepalive
• hubot-google-images
• hubot-google-translate
• hubot-pugme
• hubot-maps
• hubot-redis-brain
• hubot-rules
• hubot-shipit

Example Playbook

- hosts: all
  become: true
  vars:
    mattermost_hubot_mattermost_team: teamname
    mattermost_hubot_mattermost_user: hubot
    mattermost_hubot_mattermost_password: yourpassword
    mattermost_hubot_mattermost_host: url.to.your.mattermost.instance.com
    mattermost_hubot_owner: [email protected]
    mattermost_hubot_environment:
      - REDIS_URL: redis://:[email protected]:16379/prefix
    mattermost_hubot_plugins:
      - hubot-diagnostics
      - hubot-help
      - hubot-google-images
      - hubot-google-translate
      - hubot-pugme
      - hubot-maps
      - hubot-redis-brain
      - hubot-rules
      - hubot-shipit
      - hubot-tell-a-joke
      - hubot-voting
  roles:
    - mattermost-hubot

License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Author Information

• Fritz Otlinghaus (Scriptkiddi) [email protected]

ansible_mattermost_hubot's Issues

How does one deploy this with ansible?

Is this for remote deployment? Or for local ansible deployment, can you provide some startup steps? It is not clear if the recipe to be used remotely or local on ubuntu.

Add repository description and tags (github meta)