Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

lita (15) Versions 0.0.3

Installs/configures the Lita chatbot

Policyfile
Berkshelf
Knife
cookbook 'lita', '= 0.0.3', :supermarket
cookbook 'lita', '= 0.0.3'
knife supermarket install lita
knife supermarket download lita
README
Dependencies
Changelog
Quality -%

lita-cookbook

Installs and configures the lita chatbot.

Supported Platforms

  • Ubuntu
    • 12.04 (precise)
    • 14.04 (precise)

It will likely work on other Ubuntu versions, however the automatic methods of installing ruby and redis will have issues.

Tunable Attributes

All tunable attributes are in the lita heirarchy.

Key Type Description Default
name String Name of chatbot Lita Chatbot
mention_name String Name chatbot listens for Value of name
version String Gemfile-style version dependency of lita to install nil (latest)
config_coookbook String Name of cookbook where config template stored lita (current)
config_template String Name of config template file lita_config.rb.erb
locale String/Symbol Language to use ":en"
log_level String/Symbol Locale ":info"
admin Array of Strings Adapter specific IDs of Lita admins empty
adapter String/Symbol Adapter to use for Lita instance ":shell"
adapter_version Fixed Version of adapter to use nil (latest)
adapter_config Hash Hash of adapter specific configuration emtpy
plugins Array of Strings and/or Hashes List of plugins to install and, optionally, Gemfile line options empty
plugin_config Hash of Hashes Hash of plugin specific configuration empty
gems Array of Strings and/or Hashes List of gems to install and, optionally, Gemfile line options empty
packages Array of Strings List of system packages to install SSL related stuff
http_host String IP address to bind http server 0.0.0.0
http_port Numeric Port to bind http server 8080
http_min_threads Numeric Min number of http threads 0
http_max_threads Numeric Max number of http threads 0
redis_host String IP address of redis instance 127.0.0.1
redis_port Numeric Port of redis instance 6379
install_dir String Lita home directory /opt/lita
log_dir String Lita log directory /opt/lita/logs
run_dir String Lita var/run directory /opt/lita/run
daemon_user String User to run daemon as nobody
ruby_install_type String How to install ruby depedency auto
redis_install_type String How to install redis depedency auto

Important Note

Many of the configuration elements (particularly in adapter or plugins) require symbols instead of strings. Since:

  • The cookbook is using Chef templates (ERB) to generate more ruby AND
  • ERB calls to_s on variables in the template
  • Even if I try to do var.inspect on the ERB variable, I can't handle those who pass their attributes via JSON (i.e. environment, role, or node)

you'll need to put your items that should be symbols in as strings For example:

default["lita"]["adapter"] = ":shell"

For the adapter and plugin config the template will try to detect strings that begin with : and not quote them in the lita_config.rb.

Usage

lita::default

Installs and configures the lita chatbot.

Configuration

Adapter

To make this effective you'll need to choose a non-default adapter from the Lita plugin page. The :shell adapter will not startup in daemon mode so the only way to test with it is to spin up a node, change into the node["lita"]["install_dir"] and run lita

Adapter Configuration

The adapter config is simply key/value pairs. If you need more complicated ruby configuratino (as some adapters do) you'll likely want to create a wrapper cookbook and set the config_cookbook and config_template attributes to your own template.

Plugins

Plugins can be listed in an array or, optionally listed as an array of hashes using plugin name as the key and Gemfile line syntax:

default["lita"]["plugins"] = [
  "ping",
  { "jenkins" => ">= 0.0.1" }
  { "foo" => ">= 1.2.3, :git => 'git://github.com/foo/foo.git'" }
]

Plugin Configuration

The plugins can be configured with a hash of hashes that are keyed off the plugin name:

default["lita"]["plugin_config"] = {
  "jenkins" => {
    "url" => "http://test.com"
    "auth" => "user1:sekret"
  }
}

Ruby and Redis

Lita requires recent versions of Ruby and Redis. By default, the lita cookbook will automatically try to find appropriate ruyb and redis versions for your platform and version.

To install those dependencies yourself, simple set the install type attributes to none as such:

node.default["lita"]["ruby_install_type"] = "none"
node.default["lita"]["redit_install_type"] = "none"

If these versions don't work for you (or the cookbook doesn't currently support your platform/version), you can manage the installation of ruby and redis yourself through various methods:

  • Add ruby and redis using community cookbooks in your node/role run_list
  • Creating a wrapper cookbook that does the same
  • Using a base image that already includes the dependencies

The only requirement for the lita cookbook is that ruby, gem and bundler are in the system path and provide the appropriate versions to work with lita.

Example

Here's an example node configuration for leveraging lita-hipchat:

{
  "lita": {
    "adapter": "hipchat",
    "adapter_config": {
      "jid": "99999_0000000@chat.hipchat.com",
      "password": "sekret1",
      "rooms": ":all",
      "muc_domain": "conf.hipchat.com"
    },
    "gems": {
      "pagerduty-sdk", ":git => \"https://github.com/kryptek/pagerduty-sdk.git\""
    },
    "plugins": [
      "jenkins",
      "pagerduty",
      "cron",
      "dig",
      "youtube",
      "xkcd",
      "jenkins",
      "wikipedia"
    ],
    "plugin_config": {
      "jenkins": {
        "url": "http://jenkins.notreally.com/",
        "auth": "lita:sekret1"
      },
      "pagerduty": {
        "api_key": "kkkkkkkkkkkkkkkkkkkkkk",
        "subdomain": "notreally"
      }
    }
}

License and Authors

Copyright:: 2014 Harlan Barnes

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

apt >= 0.0.0
build-essential >= 0.0.0
ruby-ng ~> 0.1.1
redis2 ~> 0.5.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

lita Cookbook Changelog

v0.0.3 (2014-08-12)

  • Added the rest of the standard Lita attributes (mention name and http properties) (issue #2)
  • Added new "gems" attribute to add in custom gem setups. This allowed me to remove the pagerduty-sdk logic in the Gemfile.erb
  • Turned the package installation into an attribute so native packages can be added as needed by adapter or handlers
  • Fixed single/double quote stuff in the recipe. I'm not very consistent with that stuff

v0.0.2 (2014-07-23)

  • Initial version

No quality metric results found