cookbook 'copperegg', '= 0.2.1'
copperegg (4) Versions 0.2.1 Follow3
Installs/Configures CopperEgg services
cookbook 'copperegg', '= 0.2.1', :supermarket
knife supermarket install copperegg
knife supermarket download copperegg
Chef Cookbook for CopperEgg services
- Chef cookbook for the CopperEgg collector agent and website / port probes.
- Requires a CopperEgg account to use. Free trial available.
Chef 10 and up.
- Any Linux 2.6+ OS, including: Ubuntu, Debian, Vyatta, RedHat Enterprise, CentOS, Fedora, Amazon, SuSE, openSuSE, Gentoo, and many derivatives.
default[:copperegg][:apikey]= Your API Key available from the CopperEgg App Settings Page.
default[:copperegg][:tags]= A comma separated list of tags to apply. Optional. Manage your tags.
default[:copperegg][:label]= Label to apply in place of hostname when displaying in the dashboard. WARNING: If you want the same label applied to multiple systems, you may want to consider tags instead. This is most useful if you intend a recipe for a single server. Optional.
default[:copperegg][:oom_protect]= Flag for determining if the Linux Out Of Memory manager (OOM) should be allowed to kill the RevealCloud process. Default false (allow OOM to kill the process). Optional.
default[:copperegg][:proxy]= Proxy server required to talk to the revealcloud api servers, such as
myproxy.mycorp.com:8080. Optional. Leave blank unless you know what you are doing.
- `default[:copperegg][:use_fqdn] = Flag for using the fqdn as the uuid. true => Agent will be started with -U node.fqdn . Default false. Optional.
default[:copperegg][:include_chef_tags]= Propagate Chef node tags to CopperEgg tags. Default true.
default[:copperegg][:include_roles_astags]= Propagate Chef node Roles to CopperEgg tags. Default true.
default[:copperegg][:include_env_astag]= Propagate the Chef environment to a CopperEgg tag. Default true.
default[:copperegg][:annotate_chefrun_success]= Send CopperEgg an annotation for each successful chef run. Default false.
default[:copperegg][:annotate_chefrun_fail]= Send CopperEgg an annotation for each failed chef run. Default true.
- Download the CopperEgg cookbook into your
chef-repo/cookbooks/coppereggdirectory: (the cookbook directory name must be copperegg)
git clone https://github.com/CopperEgg/chef-copperegg.git ./copperegg, or
- manually download from the Opscode community site
knife cookbook site download copperegg
- Set your apikey as described in the
copperegg/attributes/default.rband change YOUR_USER_API_KEY to be correct.
- Set any other optional attributes described above, as desired.
- Upload the cookbook to your chef server or hosted chef:
knife cookbook upload -a -o copperegg
recipe[revealcloud]in the run_list for all of your servers.
knife node run_list add NODES 'recipe[copperegg]'
- Run chef-client on your nodes in whatever manner suits you, such as
sudo chef-clientor a batch job.
- View your systems within 10 seconds in the RevealCloud App
Creating and managing website and port probes
- The CopperEgg Cookbook contains a LightWeight Resource Provider (LWRP) for simplifying the automation of CopperEgg probes.
- To create a copperegg probe, you need to include something similar to the following example:
copperegg_probe "ChefProbe2" do provider "copperegg_probe" action :update # update will create or update probe_desc 'ChefProbe2' # the 'name' of the probe probe_dest "http://yoursite.com" # the URL to test type 'GET' # the test type; in this case, an HTTP GET request stations ['dal','nrk'] # override the defaults and specify testing from Dallas and Fremont end
- You can find descriptions of all required and optional fields in copperegg/resources/probe.rb.
- Refer to the Probe section of the CopperEgg API for further details: CopperEgg Probe API
Creating Annotations in the CopperEgg UI for chef run events.
- The CopperEgg Cookbook includes integration with the Chef Report and Exception Handlers. To enable this functionality:
- include the chef_handler cookbook from Opscode in your chef repo, and in your run list.
- include the recipe copperegg-handler.rb in your run list. That's it!
- By default, each chef run will create a annotation at copperegg only when the chef run fails.
- You can change this behavior by changing the [:copperegg][:annotate_chefrun_success] and [:copperegg][:annotate_chefrun_fail] attributes.
License and Author
Authors:: Ross Dickey, Scott Johnson
(The MIT License)
Copyright © 2013 CopperEgg Corporation
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without
limitation the rights to use, copy, modify, merge, publish, distribute,
sublicense, and/or sell copies of the Software, and to permit persons
to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
This cookbook has no specified dependencies.
There are no cookbooks that are contingent upon this one.