cookbook 'bluepill', '~> 4.1.1'
The bluepill cookbook has been deprecated
Author provided reason for deprecation:
The bluepill cookbook has been deprecated and is no longer being maintained by its authors. Use of the bluepill cookbook is no longer recommended.
bluepill
(26) Versions
4.1.1
-
Follow31
Installs bluepill gem and configures to manage services, includes bluepill_service LWRP
cookbook 'bluepill', '~> 4.1.1', :supermarket
knife supermarket install bluepill
knife supermarket download bluepill
bluepill Cookbook
Installs bluepill Ruby Gem and configures it to manage services. Also includes a LWRP.
Requirements
Platforms
Bluepill is a pure Ruby service management tool/library, so this cookbook should work on any system. The attributes do set up paths based on FHS locations, see below.
Chef
- Chef 12.7+
Cookbooks
- none
Attributes
Default locations for bluepill are in "FHS compliant" locations.
-
node["bluepill"]["bin"]
- Path to bluepill program, default is 'bluepill' in the RubyGems binary directory. -
node["bluepill"]["logfile"]
- Location of the bluepill log file, default "/var/log/bluepill.log". -
node["bluepill"]["conf_dir"]
- Location of service config files (pills), default "/etc/bluepill". -
node["bluepill"]["pid_dir"]
- Location of pidfiles, default "/var/run/bluepill" -
node["bluepill"]["state_dir"]
- Location of state directory, default "/var/lib/bluepill" -
node["bluepill"]["init_dir"]
- Location of init script directory, default selected by platform. -
node["bluepill"]["version"]
- Version of bluepill to install, default is latest. -
node["bluepill"]["use_rsyslog"]
- Enable configuration and use of rsyslog for bluepill.
Resources
This cookbook contains a resource, bluepill_service
. This can be used with the normal Chef service resource, by using the provider
parameter, or by specifying the bluepill_service
shortcut. These two resources are equivalent.
bluepill_service 'my_app' do action [:enable, :load, :start] end
The load action should probably always be specified, to ensure that if bluepill isn't running already it gets started. The The recipe using the service must contain a template resource for the pill and it must be named my_app.pill.erb
, where my_app
is the service name passed to the bluepill service resource.
Usage
Be sure to include the bluepill recipe in the run list to ensure that the gem and bluepill-related directories are created. This will also make the cookbook available on the system and other cookbooks won't need to explicitly depend on it in the metadata.
If the default directory locations in the attributes/default.rb aren't what you want, change them by setting them either in the attributes file itself, or create attributes in a role applied to any systems that will use bluepill.
Bluepill uses configuration files named my_app.pill that are stored in /etc/bluepill
. Here is an example pill:
Bluepill.application('my_app') do |app| app.process('my_app') do |process| process.pid_file = '/var/run/my_app.pid' process.start_command = '/usr/bin/my_app' end end
You can create this file with cookbook_file
as follows:
cookbook_file '/etc/bluepill/my_app.pill' do source 'my_app.pill' end
See bluepill's documentation for more information on creating pill templates.
License & Authors
Author: Cookbook Engineering Team (cookbooks@chef.io)
Copyright: 2010-2016, Chef Software, Inc.
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.
bluepill Cookbook CHANGELOG
This file is used to list changes made in each version of the bluepill cookbook.
4.1.1 (2018-10-03)
- Removes a deprecated dependency 'chef/mixin/language'
4.1.0 (2018-05-14)
- Update dokken config
- Remove Chefspec matchers which are autogenerated by ChefSpec now
- Cookstyle fix
4.0.2 (2017-07-11)
- Fixes a typo in LSB init which triggers an abort during deploy (#34)
4.0.1 (2017-05-06)
- Add supported platforms to the metadata
- Remove extra include of mixlib-shell in the resource
- Fix the license string to be a SPDX standard string
4.0.0 (2017-03-06)
- Test with local delivery and not Rake
- Removed the unused / undocumented
supports
attribute from the bluepill_service resource - Convert bluepill_service to a custom resource, requiring chef-client 12.5 or later
- Add Chef 13 testing
3.0.0 (2016-08-31)
- This cookbook now requirements Chef 12
- Added Chefspec matchers
- Add chef_version metadata
- Test in Travis CI using kitchen-dokken
- Remove minitest_handler requirement and the minitest files
- Use cookstyle instead of rubocop
2.4.3 (04-18-2016)
- Added ChefSpec custom matchers and examples
2.4.2 (02-19-2016)
- Loosened the dependecy on rsyslog so the latest cookbook can be used
- Updated testing dependencies and configurations
WARNING: It was noted after the release of 2.4.2 that the loosened dependency on rsyslog increased the minimum required Chef release to 12.0 for this cookbook. Chef 11 users will need to use 2.4.1.
2.4.1 (11-10-2015)
- Require rsyslog ~> 2.0.0 to preserve Chef 11 compatibility
- Fix rsyslog restarting on RHEL
- Use platform_family when setting platform specific node attributes and fix bad syntax. This should improve RHEL support
v2.4.0 (09-17-2015)
- Updated the LSB Required-Start and Required-Stop comments of the LSB init script template to be valid
- Added name to the bluepill_test cookbook metadata for Chef 12
- If a defaults file on RHEL or Debian based systems exist for the service source that within the init scripts. Example if /etc/default/bar exists on debian for the bar service then source that
- Added .kitchen.yml file with vagrant based testing for local testing and moved the cloud based kitchen to .kitchen.cloud.yml
- Add Travis CI config
- Added rubocop config
- Updated Berksfile to 3.X format and removed yum cookbook that wasn't used
- Updated contributing.md and added testing.md documentation
- Updated development and testing dependencies in the Gemfile
- Added maintainers.md and .toml and added Rake task for generating the MD file
- Opscode -> Chef Software everywhere
- Added Travis and cookbook version badges to the readme
- Add rake file to easy testing
- Resolved all Rubocop warnings
- Added a chefignore file and added additional files to the gitignore
- Added source_url and issues_url metadata for Supermarket
v2.3.2
- Never actually released
v2.3.1
New Feature
- COOK-3705 - Add init.d script with LSB style
v2.3.0
Improvement
- COOK-3503 - Add why-run support
v2.2.2
- [COOK-2507] - stringify language attributes
v2.2.0
- [COOK-547] - Add
load
action to provider to reload services when template changes.
v2.1.0
- [COOK-1295] - The bluepill cookbook does not create the default log file
- [COOK-1840] - Enable bluepill to log to rsyslog
v2.0.0
This version uses platform_family attribute (in the provider), making the cookbook incompatible with older versions of Chef/Ohai, hence the major version bump.
- [COOK-1644] - Bluepill cookbook fails on Redhat due to missing default or redhat template directory.
- [COOK-1920] - init script should have a template file named after platform_family instead of using file specificity
v1.1.2
- [COOK-1730] - Add ability to specify which version of bluepill to install
v1.1.0
- [COOK-1592] - use mixlib-shellout instead of execute, add test-kitchen
v1.0.6
- [COOK-1304] - support amazon linux
- [COOK-1427] - resolve foodcritic warnings
v1.0.4
- [COOK-1106] - fix chkconfig loader for CentOS 5
- [COOK-1107] - use integer for GID instead of string
v1.0.2
- [COOK-1043] - Bluepill cookbook fails on OS X because it tries to use root group
v1.0.0
- [COOK-943] - add init script for freebsd
v0.3.0
- [COOK-867] - enable bluepill service on RHEL family
- [COOK-550] - add freebsd support
v0.2.2
- Fixes COOK-524, COOK-632
Collaborator Number Metric
4.1.1 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
4.1.1 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
Cookstyle Metric
4.1.1 failed this metric
Chef/Correctness/PropertyWithoutType: Resource properties or attributes should always define a type to help users understand the correct allowed values. (https://docs.chef.io/workstation/cookstyle/chef_correctness_propertywithouttype): bluepill/resources/service.rb: 20
Chef/Deprecations/ResourceWithoutUnifiedTrue: Set `unified_mode true` in Chef Infra Client 15.3+ custom resources to ensure they work correctly in Chef Infra Client 18 (April 2022) when Unified Mode becomes the default. (https://docs.chef.io/workstation/cookstyle/chef_deprecations_resourcewithoutunifiedtrue): bluepill/resources/service.rb: 1
Run with Cookstyle Version 7.32.1 with cops Chef/Deprecations,Chef/Correctness,Chef/Sharing,Chef/RedundantCode,Chef/Modernize,Chef/Security,InSpec/Deprecations
No Binaries Metric
4.1.1 passed this metric
Testing File Metric
4.1.1 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
4.1.1 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
4.1.1 failed this metric
4.1.1 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
Cookstyle Metric
4.1.1 failed this metric
Chef/Correctness/PropertyWithoutType: Resource properties or attributes should always define a type to help users understand the correct allowed values. (https://docs.chef.io/workstation/cookstyle/chef_correctness_propertywithouttype): bluepill/resources/service.rb: 20
Chef/Deprecations/ResourceWithoutUnifiedTrue: Set `unified_mode true` in Chef Infra Client 15.3+ custom resources to ensure they work correctly in Chef Infra Client 18 (April 2022) when Unified Mode becomes the default. (https://docs.chef.io/workstation/cookstyle/chef_deprecations_resourcewithoutunifiedtrue): bluepill/resources/service.rb: 1
Run with Cookstyle Version 7.32.1 with cops Chef/Deprecations,Chef/Correctness,Chef/Sharing,Chef/RedundantCode,Chef/Modernize,Chef/Security,InSpec/Deprecations
No Binaries Metric
4.1.1 passed this metric
Testing File Metric
4.1.1 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
4.1.1 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
4.1.1 failed this metric
Chef/Deprecations/ResourceWithoutUnifiedTrue: Set `unified_mode true` in Chef Infra Client 15.3+ custom resources to ensure they work correctly in Chef Infra Client 18 (April 2022) when Unified Mode becomes the default. (https://docs.chef.io/workstation/cookstyle/chef_deprecations_resourcewithoutunifiedtrue): bluepill/resources/service.rb: 1
Run with Cookstyle Version 7.32.1 with cops Chef/Deprecations,Chef/Correctness,Chef/Sharing,Chef/RedundantCode,Chef/Modernize,Chef/Security,InSpec/Deprecations
4.1.1 passed this metric
Testing File Metric
4.1.1 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
4.1.1 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
4.1.1 failed this metric
4.1.1 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