Installs and configures the Cloudkick Agent, and integrates it with Chef.
Requires Chef 0.10.10+
chef_gem
in default recipedefault_action
in check and monitor LWRPs
Requires Ohai 0.6.12+ for node['platform_family']
.
Platform families Debian, RHEL and Fedora are supported in the general sense, though not all may have appropriate Cloudkick packages available upstream.
- apt
- yum
The apt_repository
and yum_repository
LWRPs are used from these
cookbooks to create the proper repository entries so the Cloudkick
agent can be downloaded and installed.
node['cloudkick']['oauth_key']
- the OAuth key used for authentication with the Cloudkick API.node['cloudkick']['oauth_secret']
- the OAuth secret used for authentication with the Cloudkick API.node['cloudkick']['data']
- data for the Cloudkick API about the node
This cookbook contains two Resource Providers:
cloudkick_check
- For creating & manipulating Cloudkick Checks.cloudkick_monitor
- For creating & manipulating Cloudkick Monitors.
-
Create a Cloudkick Monitor for all of our appservers:
cloudkick_monitor "appserver monitor" do oauth_key 'xxx' oauth_secret 'yyy' query 'tag:appserver' action :create end
-
Create a Cloudkick Check for the root partition on our appservers:
cloudkick_check "root check" do oauth_key 'xxx' oauth_secret 'yyy' code 51 # 'DISK' details({:path => '/', :fs_critical => 99, :fs_warn => 95}) monitor_id 'q1234' action :create end
In order for the agent to function, you'll need to have defined your Cloudkick API key and secret. We recommend you do this in a Role, which should also take care of applying the cloudkick::default recipe.
Assuming you name the role 'cloudkick', here is the required json:
{
"name": "cloudkick",
"chef_type": "role",
"json_class": "Chef::Role",
"default_attributes": {
},
"description": "Configures Cloudkick",
"run_list": [
"recipe[cloudkick]"
],
"override_attributes": {
"cloudkick": {
"oauth_key": "YOUR KEY HERE"
"oauth_secret": "YOUR SECRET HERE"
}
}
}
If you want Cloudkick installed everywhere, we recommend you just add the cloudkick attributes to a base role.
All of the data about the node from Cloudkick is available in node['cloudkick'] - for example:
"cloudkick": {
"oauth_key": "YOUR KEY HERE",
"oauth_secret": "YOUR SECRET HERE",
"data": {
"name": "slice204393",
"status": "running",
"ipaddress": "173.203.83.199",
"provider_id": "padc2665",
"tags": [
"agent",
"cloudkick"
],
"agent_state": "connected",
"id": "n87cfc79c5",
"provider_name": "Rackspace",
"color": "#fffffff"
}
}
Of particular interest is the inclusion of the Cloudkick tags. This will allow you to search Chef via tags placed on nodes within Cloudkick:
$ knife search node 'cloudkick_data_tags:agent' -a fqdn
{
"rows": [
{
"fqdn": "slice204393",
"id": "slice204393"
}
],
"start": 0,
"total": 1
}
We automatically add a tag for each Role applied to your node. For example, if your node had a run list of:
"run_list": [ "role[webserver]", "role[database_master]" ]
The node will automatically have the 'webserver' and 'database_master' tags within Cloudkick.
Author:: Adam Jacob ([email protected]) Author:: Seth Chisamore ([email protected]) Copyright:: 2010-2011, Opscode, 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.