lita

Installs and configures lita
EvenUp Inc

EvenUp Inc

evenup

8,518 downloads

8,289 latest version

4.6 quality score

Version information

  • 0.1.1 (latest)
  • 0.1.0
released Jul 3rd 2019
This version is compatible with:
  • RedHat
    ,
    CentOS

Start using this module

Tags: lita, jira

Documentation

evenup/lita — version 0.1.1 Jul 3rd 2019

Puppet Forge Build Status

Table of Contents

  1. Overview
  2. Module Description
  3. Setup
  4. Usage
  5. Reference
  6. Limitations
  7. Development
  8. Changelog/Contributors

Overview

A Puppet module that installs and configures Lita bots

Module Description

Lita is a Chatbot written in ruby supporting various chat services and handlers. This puppet module will configure a system for Lita and configure one or multiple bots.

Setup

What lita affects

  • (optional) Manage bundler and packages required to build lita gems
  • Lita bots and associated services

Beginning with lita

Installation of the lita module:

  puppet module install evenup-lita

Usage

Insallation and creation of 'test bot' using the irc adapter

      class { 'lita':
        bundler_binpath => '/usr/bin'
      }

      lita::bot { 'test bot':
        adapter        => ':irc',
        adapter_config => { 'server' => 'irc.freenode.net', 'channels' => ['#litabot'] }
      }

Reference

Public methods

Class: lita

Main class for setting bot global defaults and global configuration

#####base_path

String. Path Lita bots should be installed in

Default: /opt/lita

#####manage_bundler

Boolean. Should the bundler gem be managed by this module

Default: false

#####bundler_package

String. Name of the package to install if managing the bundler gem

Default: bundler

#####bundler_provider

String. Provider used to install the bundler gem if managed by this module

Default: gem

#####bundler_binpath

String. Path to the bundler binary

Default: /bin

#####extra_packages

String/Array of Strings. If needed, a list of packages to manage with this module to support gem building for bots

#####version

String. Default version of lita to use for bots

Default: latest

#####adapter

String. Default adapter to use for bots

Default: :shell

#####adapter_config

Hash. Default adapter configuration to use for bots

Default: {}

Format: {'key' => 'value'}

#####bot_name

String. Default name to use for bots

Default: lita

#####gems

Array of Strings. Default gems to use for bots

Default: []

#####mention_name

String. Default mention name to use for bots

Default: lita

#####plugins

String. Default plugins to use for bots

Default: []

#####plugin_config

Hash. Default plugin configuration to use for bots

Default: []

Format: { 'plugin_name' => { 'key' => 'value' } }

#####admins

Array of Strings. Default list of admins to use for bots

Default: []

#####locale

String. Default localeto use for bots

Default: en

#####log_level

String. Default log_level to use for bots

Default: :info

#####http_host

String. Default host to listen for HTTP requests on for bots

Default: '0.0.0.0'

#####http_port

Integer. Default port to listen for HTTP requests on for bots

Default: 8080

#####redis_host

String. Default redis host to use for bots

Default: '127.0.0.1'

#####redis_port

Integer. Default redis port to use for bots

Default: 6379

Define: lita::bot

Configures individual lita bots.

#####version

String. Version of lita to use

Default: latest

#####adapter

String. Adapter to be used by this bot

Default: :shell

#####adapter_config

Hash. Adapter configuration for this bot

Default: {}

Format: {'key' => 'value'}

#####bot_name

String. Name to be used by the bot

Default: lita

#####gems

Array of Strings. Gems needed for this bot

Default: []

#####mention_name

String. Mention name for this bot

Default: lita

#####plugins

String. Plugins to be used by this bot

Default: []

#####plugin_config

Hash. Plugin configuration to be used by this bot

Default: []

Format: { 'plugin_name' => { 'key' => 'value' } }

#####admins

Array of Strings. Admin names of this bot

Default: []

#####locale

String. Locale to be used by this bot

Default: en

#####log_level

String. Log_level for this bot

Default: :info

#####http_host

String. Address to open listening port on for this bot

Default: '0.0.0.0'

#####http_port

Integer. Port to listen on for this bot

Default: 8080

#####redis_host

String. Redis host to use for this bot

Default: '127.0.0.1'

#####redis_port

Integer. Port to connect to redis on

Default: 6379

Private classes

  • lita::params: Default lita configuration

Limitations

  • Only tested on RHEL/CentOS 7

Development

Improvements and bug fixes are greatly appreciated. See the contributing guide for information on adding and validating tests for PRs.

Changelog / Contributors

Changelog

Contributors