cookbook 'karaf', '= 1.2.0'
karaf (13) Versions 1.2.0 Follow0
Installs/Configures karaf
cookbook 'karaf', '= 1.2.0', :supermarket
knife supermarket install karaf
knife supermarket download karaf
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 inkaraf
. Will be cleaned-up/deprecated once a link is added from this resource tokaraf
. (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 inkaraf
. Will be cleaned-up/deprecated once a link is added from this resource tokaraf
. (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 inkaraf
. Will be cleaned-up/deprecated once a link is added from this resource tokaraf
. (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 inkaraf
. Will be cleaned-up/deprecated once a link is added from this resource tokaraf
. (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 inkaraf
. Will be cleaned-up/deprecated once a link is added from this resource tokaraf
. (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
- Fork the repository on Github
- Create a named feature branch (like
add_component_x
) - Write your change
- Write tests for your change
- Run the tests, ensuring they all pass
- Run foodcritic and rubocop to make sure code is clean.
- 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
1.2.0 passed this metric