RightScale Cookbook¶ ↑

DESCRIPTION:¶ ↑

This cookbook provides base recipes used to set up services used by the RightScale Cloud Management Platform.

REQUIREMENTS:¶ ↑

Requires a virtual machine launched from a RightScale managed RightImage.

COOKBOOKS DEPENDENCIES:¶ ↑

Please see the metadata.rb file for the latest dependencies.

KNOWN LIMITATIONS:¶ ↑

There are no known limitations.

SETUP/USAGE:¶ ↑

The rightscale::default recipe performs common server configuration steps such as enabling monitoring on an instance so that graphs cane be displayed in the RightScale Dashboard.

The rightscale::install_tools recipe installs the rightscale_tools gem which provides tools for dealing with databases, volumes, and remote object storage providers.

DETAILS:¶ ↑

Definitions:¶ ↑

rightscale_enable_collectd_plugin¶ ↑

• Accepts only one parameter “name” which is the name of the collectd plugin to enable.

• The plugin name is added to node[:plugin_list_array] which is used to create the list of plugins in the /etc/collectd/collectd.conf file.

• The node[:rightscale][:plugin_list_array] will have any plugins listed in the node[:rightscale][:plugin_list] merged into it, which supports any legacy recipes, as well as allow the input to be manipulated in the RightScale Dashboard.

Syntax:

rightscale_enable_collectd_plugin "curl_json"

rightscale_monitor_process¶ ↑

• Accepts only one parameter, “name” which is the name of the process to monitor.

• The process name is added to the node[:rightscale][:process_list_array] which is used to create the list of processes in the /etc/collectd/conf/processes.conf file.

• The node[:rightscale][:process_list_array] will have any processes listed in node[:process_list] merged into it, which supports any legacy recipes, as well as allow the input to be manipulated in the RightScale Dashboard.

Syntax:

rightscale_monitor_process "nginx"

rightscale_marker¶ ↑

• Accepts only one parameter, “location” which can be used to denote the :start or :end of a recipe. It can also be :begin, :stop, and the string versions.

• Used to log the start and end of a recipe using the ‘log’ chef resource. Should be added at the beginning and end of a recipe.

• Log marker: “‘========================= recipe::name : START/END =========================“`

Syntax:

rightscale_marker :start

rightscale_marker :end

Resources:¶ ↑

rightscale_server_collection¶ ↑

The server collection resource finds a set of servers in a deployment with a set of tags. The tags attribute specifies the tag or tags to search for (if multiple tags are specified, servers with any of the tags will match) and the optional secondary_tags attribute specifies tags that need to also appear on the servers, it will wait one minute for the secondary_tags to appear, which can be overridden with the timeout attribute.

Syntax:

rightscale_server_collection "rightscale_servers" do
  tags "rs_login:state=active"
  secondary_tags "server:uuid=*"
end

LICENSE:¶ ↑

Copyright RightScale, Inc. All rights reserved. All access and use subject to the RightScale Terms of Service available at www.rightscale.com/terms.php and, if applicable, other agreements such as a RightScale Master Subscription Agreement.