cookbook 'thruk', '~> 2.0.0'
thruk (10) Versions 2.0.0 Follow1
Installs/Configures thruk
cookbook 'thruk', '~> 2.0.0', :supermarket
knife supermarket install thruk
knife supermarket download thruk
Description
Thruk is a multibackend monitoring web interface which currently
supports Nagios, Icinga and Shinken as backend using the Livestatus
API. It is designed to be a drop in replacement and covers almost all
of the original features plus adds additional enhancements for large
installations.
See http://www.thruk.org/ for more information.
Requirements
cookbooks
apache2
yum
yum-epel
apt
Attributes
Usage
The 2.0.0 version of this cookbook moves the configuration attributes
for thruk_local.conf to a hash (node['thruk']['conf']). This allows
you to configure any settings for thruk, but you must change your
current configuration.
thruk::default
Use the recipe directly, or include it in a role to customize it:
% cat roles/thruk.rb
name 'thruk'
run_list( 'recipe[thruk]' )
override_attributes(
'thruk' => {
'server_name' => 'monitor.example.com'
'use_ssl' => true,
'htpasswd' => '/etc/shinken/htpasswd.users',
'cert_cookbook' => 'my_cookbook',
'cert_name' => '_.example.com',
'cert_ca_name' => 'gd_bundle',
'icon_cookbook' => 'my_cookbook',
'conf' => {
'start_page' => '/thruk/cgi-bin/tac.cgi',
'first_day_of_week' => 0,
'csrf_allowed_hosts' => '192.168.0.1',
'disable_user_password_change' => 1,
'enable_shinken_features' => 1,
'logo_path_prefix' => '/thruk/icons/',
'use_strict_host_authorization' => 1,
},
'shinken_priorities' => {
'5' => 'Top Production',
'4' => 'Production',
'3' => 'Integration',
'2' => 'Internal',
'1' => 'Testing',
'0' => 'Development',
},
'backends' => {
'shinken' => {
'name' => 'External Shinken',
'type' => 'livestatus',
'options' => {
'peer' => '127.0.0.1:50000',
},
},
},
'cmd_defaults' => {
'ahas' => 1,
'force_check' => 1,
'persistent_ack' => 1,
'sticky_ack' => 0,
'send_notification' => 0,
'persistent_comments' => 0,
},
'cgi' => {
'admin_group' => 'sysadmin',
'read_groups' => 'dev,misc',
'lock_authors_names' => 0,
},
},
)
Contributing
- Fork the repository on Github
- Create a named feature branch (like
add_component_x
) - Write your change
- Write tests for your change (if applicable)
- Run the tests, ensuring they all pass
- Submit a Pull Request using Github
License and Authors
Authors: Martha Greenberg
Dependent cookbooks
yum >= 0.0.0 |
yum-epel >= 0.0.0 |
apache2 >= 0.0.0 |
apt >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
CHANGELOG for thruk
This file is used to list changes made in each version of thruk.
2.0.0
- Change all of the thruk_local.conf settings to hashes, so that it is more configurable.
- Upgrade thruk to 2.00-2.
- Force apache restart before thruk service starts, so that recipes converge on first run.
- Add default file so that init script works with SSL redirect.
- Fix for fcgid module for Apache 2.4 on CentOS.
- Directory permissions for Apache 2.4.
- Allow loading of SSL certificates and icons from different cookbooks.
- Integration tests for thruk with SSL.
- Integration tests and fixes for CentOS 7.1, Debian 7.8, Debian 8.1, Ubuntu 12.04 and Ubuntu 15.04.
1.1.0
- Bugfixes based on new tests! Make sure we are not using mpm_event on apache 2.4, disable new apache thruk.conf, fix apt key import and force thruk to restart whenever apache restarts or reloads.
- Add integration tests with ServerSpec on CentOS 6.6 and Ubuntu 14.10.
- Add unit tests with ChefSpec.
1.0.0
- Change default thruk version to 2.00-1
- add ability to install thruk version 2.00 via labs repository for rhel
- add additional configuration properties for shinken and strict_host_authorization
0.4.1
- add ability to install thruk version 2.00 via labs repository for debian
0.1.0:
- Initial release of thruk
Check the Markdown Syntax Guide for help with Markdown.
The Github Flavored Markdown page describes the differences between markdown on github and standard markdown.
Collaborator Number Metric
2.0.0 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.0.0 failed this metric
FC053: Metadata uses the deprecated "recommends" keyword: thruk/metadata.rb:15
FC064: Ensure issues_url is set in metadata: thruk/metadata.rb:1
FC065: Ensure source_url is set in metadata: thruk/metadata.rb:1
FC066: Ensure chef_version is set in metadata: thruk/metadata.rb:1
FC069: Ensure standardized license defined in metadata: thruk/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
2.0.0 passed this metric
Testing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 failed this metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.0.0 failed this metric
FC053: Metadata uses the deprecated "recommends" keyword: thruk/metadata.rb:15
FC064: Ensure issues_url is set in metadata: thruk/metadata.rb:1
FC065: Ensure source_url is set in metadata: thruk/metadata.rb:1
FC066: Ensure chef_version is set in metadata: thruk/metadata.rb:1
FC069: Ensure standardized license defined in metadata: thruk/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
2.0.0 passed this metric
Testing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 failed this metric
FC064: Ensure issues_url is set in metadata: thruk/metadata.rb:1
FC065: Ensure source_url is set in metadata: thruk/metadata.rb:1
FC066: Ensure chef_version is set in metadata: thruk/metadata.rb:1
FC069: Ensure standardized license defined in metadata: thruk/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
2.0.0 passed this metric
Testing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 failed this metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number