karaf

This cookbook installs Apache Karaf.

Usage

Use the provided resources to install karaf and configure users and features.

Requirements

• java cookbook
• ark cookbook

Platform

• Tested on CentOS 6.6 and Ubuntu 14.04 (via Kitchen)

Resources

karaf

karaf 'install karaf' do
  install_java  true
  version       '4.0.4'
  user         'someuser'  
  action        :install
end

Actions

• :install - Installs Karaf and the karaf-service wrapper feature, and starts the service.
• :remove - Removes Karaf and the karaf-service wrapper

Attributes

• install_java - Whether or not to install Java. (default: true)
• source_url - Optional URL to download the Karaf file tar file from.
• version - The version of Karaf to install.
• install_path - Optional install path. (default: /usr/local)
• user - The user to run karaf-service as. (default: root)

Note:
When setting the user to run Karaf as, it is assumed the user is already configured properly. When installing features, Maven may use a local repository for the user, which may require a home directory to be set.

karaf_feature_repository

karaf_feature_repository 'hawtio' do
  version       '1.4.51'
  client_user   'karaf'
  :install
end

Actions

• :install - Installs the specified feature repository.

Attributes

• install_path - The path to the installation folder. Needs to match the value in karaf. Will be cleaned-up/deprecated once a link is added from this resource to karaf. (default: '/usr/local')
• client_user - The user to run the karaf client as. (default: karaf)
• repository_name - The name of the repository to add. (name attribute)
• version - The version of the repository to add. (default: '')

karaf_feature

karaf_feature 'hawtio' do
  :install
end

Actions

• :install - Installs the specified feature.

Attributes

• install_path - The path to the installation folder. Needs to match the value in karaf. Will be cleaned-up/deprecated once a link is added from this resource to karaf. (default: '/usr/local')
• client_user - The user to run the karaf client as. (default: karaf)
• feature_name - The name of the feature to add. (name attribute)
• version - The version of the feature to add. (default: '')

karaf_user

karaf_user 'newuser' do
  groups    ['group1', 'group2']
  password  'ultrafubar'
  :create
end

Actions

• :create - Creates or updates the specified karaf user.

Attributes

• install_path - The path to the installation folder. Needs to match the value in karaf. Will be cleaned-up/deprecated once a link is added from this resource to karaf. (default: '/usr/local')
• user_name - The name of the user to create. (name attribute)
• password - The password for the user.
• groups - An array of groups to add the user to.

karaf_group

karaf_group 'newgroup' do
  roles   ['role1', 'role2']
  :create
end

Actions

• :create - Creates or updates the specified karaf group.

Attributes

• install_path - The path to the installation folder. Needs to match the value in karaf. Will be cleaned-up/deprecated once a link is added from this resource to karaf. (default: '/usr/local')
• group_name - The name of the group to create. (name attribute)
• roles - An array of roles to add the group to.

Contributing

1. Fork the repository on Github
2. Create a named feature branch (like add_component_x)
3. Write your change
4. Write tests for your change
5. Run the tests, ensuring they all pass
6. Submit a Pull Request using Github

License and Authors

Authors: Jason Capriotti