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

karaf (13) Versions 1.2.0

Installs/Configures karaf

Policyfile
Berkshelf
Knife
cookbook 'karaf', '= 1.2.0', :supermarket
cookbook 'karaf', '= 1.2.0'
knife supermarket install karaf
knife supermarket download karaf
README
Dependencies
Changelog
Quality 100%

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)
  • retry_count - The number of times to retry when performing Karaf client actions. This is important for slower platforms but generally shouldn't need to be changed. (default: 20)
  • retry_delay - The number of seconds to wait when retrying a Karaf client action. This is important for slower platforms but generally shouldn't need to be changed. (default: 3)

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_bundle

karaf_bundle 'com.fasterxml.jackson.core/jackson-core' do
  version '2.4.3'
  :install
end

Actions

  • :install - Installs the specified bundle.

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)
  • bundle_name - The name of the feature to add. (name attribute)
  • version - The version of the feature to add. (default: '')
  • wrap - If this bundle needs to be wrapped. Prepends . (default: false)

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. Run foodcritic and rubocop to make sure code is clean.
  7. Submit a Pull Request using Github

License and Authors

Authors: Jason Capriotti

Dependent cookbooks

ark >= 0.0.0
java >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

karaf CHANGELOG

This file is used to list changes made in each version of the karaf cookbook.

1.2.0 - 3/1/2016

  • Add bundle install feature.

1.1.0 - 2/25/2016

  • Add retry logic around core installation steps

1.0.2

  • Stabilizing race conditions with initial start and installing service-wrapper.

1.0.0

  • Major update to use custom resource vs attribute-driven recipe
  • Default install version to latest, 4.0.4
  • Add support for customizing users and groups in users.properties

0.2.1 - 1/27/2016

  • Fixed issue where the initial start of karaf would not start as the defined service_user, which could cause problems for subsequent starts as service_user.

0.2.0 - 1/25/2016

  • Add support for specifying user with which to run service

0.1.0

  • Initial release of karaf

Foodcritic Metric
            

1.2.0 passed this metric