Class: Ridley::NodeObject

Inherits:
ChefObject show all
Defined in:
lib/ridley/chef_objects/node_object.rb

Overview

Author:

Instance Method Summary collapse

Methods inherited from ChefObject

#<=>, #==, chef_id, #chef_id, chef_json_class, chef_type, #eql?, #hash, #initialize, #inspect, #reload, #save, set_chef_id, set_chef_json_class, set_chef_type, #update

Constructor Details

This class inherits a constructor from Ridley::ChefObject

Instance Method Details

#chef_run ⇒ HostConnector::Response

Executes a Chef run on the node

Returns:



128
129
130
 
# File 'lib/ridley/chef_objects/node_object.rb', line 128

def chef_run
  resource.chef_run(self.public_hostname)
end

#cloud? ⇒ Boolean

Returns true if the node is identified as a cloud node.

Returns:

  • (Boolean) 


100
101
102
 
# File 'lib/ridley/chef_objects/node_object.rb', line 100

def cloud?
  self.automatic.has_key?(:cloud)
end

#cloud_provider ⇒ nil, String

Returns the cloud provider of the instantiated node. If the node is not identified as a cloud node, then nil is returned.

Examples:

node_1.cloud_provider => "eucalyptus"
node_2.cloud_provider => "ec2"
node_3.cloud_provider => "rackspace"
node_4.cloud_provider => nil

Returns:

  • (nil, String) 


93
94
95
 
# File 'lib/ridley/chef_objects/node_object.rb', line 93

def cloud_provider
  self.cloud? ? self.automatic[:cloud][:provider] : nil
end

#ec2? ⇒ Boolean

Returns true if the node is identified as a cloud node using the ec2 provider.

Returns:

  • (Boolean) 


114
115
116
 
# File 'lib/ridley/chef_objects/node_object.rb', line 114

def ec2?
  self.cloud_provider == "ec2"
end

#eucalyptus? ⇒ Boolean

Returns true if the node is identified as a cloud node using the eucalyptus provider.

Returns:

  • (Boolean) 


107
108
109
 
# File 'lib/ridley/chef_objects/node_object.rb', line 107

def eucalyptus?
  self.cloud_provider == "eucalyptus"
end

#merge_data(options = {}) ⇒ Ridley::NodeResource

Merges the instaniated nodes data with the given data and updates the remote with the merged results

Parameters:

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :run_list (Array) —

    run list items to merge

  • :attributes (Hash) —

    attributes of normal precedence to merge

Returns:



148
149
150
151
152
153
154
155
156
157
158
 
# File 'lib/ridley/chef_objects/node_object.rb', line 148

def merge_data(options = {})
  unless options[:run_list].nil?
    self.run_list = (self.run_list + Array(options[:run_list])).uniq
  end

  unless options[:attributes].nil?
    self.normal = self.normal.deep_merge(options[:attributes])
  end

  self
end

#public_hostname ⇒ String

Returns the public hostname of the instantiated node. This hostname should be used for public communications to the node.

Examples:

node.public_hostname => "reset.riotgames.com"

Returns:

  • (String) 


67
68
69
 
# File 'lib/ridley/chef_objects/node_object.rb', line 67

def public_hostname
  self.cloud? ? self.automatic[:cloud][:public_hostname] : self.automatic[:fqdn]
end

#public_ipv4 ⇒ String Also known as: public_ipaddress

Returns the public IPv4 address of the instantiated node. This ip address should be used for public communications to the node.

Examples:

node.public_ipv4 => "10.33.33.1"

Returns:

  • (String) 


78
79
80
 
# File 'lib/ridley/chef_objects/node_object.rb', line 78

def public_ipv4
  self.cloud? ? self.automatic[:cloud][:public_ipv4] : self.automatic[:ipaddress]
end

#put_secret ⇒ HostConnector::Response

Puts the configured encrypted data bag secret on the node

Returns:



135
136
137
 
# File 'lib/ridley/chef_objects/node_object.rb', line 135

def put_secret
  resource.put_secret(self.public_hostname)
end

#rackspace? ⇒ Boolean

Returns true if the node is identified as a cloud node using the rackspace provider.

Returns:

  • (Boolean) 


121
122
123
 
# File 'lib/ridley/chef_objects/node_object.rb', line 121

def rackspace?
  self.cloud_provider == "rackspace"
end

#set_chef_attribute(key, value) ⇒ Hashie::Mash

Note:

It is not possible to set any other attribute level on a node and have it persist after a Chef Run. This is because all other attribute levels are truncated at the start of a Chef Run.

Set a node level normal attribute given the dotted path representation of the Chef attribute and value.

Examples:

setting and saving a node level normal attribute


obj = node.find("jwinsor-1")
obj.set_chef_attribute("my_app.billing.enabled", false)
obj.save

Parameters:

  • key (String)
  • value (Object)

Returns:

  • (Hashie::Mash) 


55
56
57
58
 
# File 'lib/ridley/chef_objects/node_object.rb', line 55

def set_chef_attribute(key, value)
  attr_hash   = Hashie::Mash.from_dotted_path(key, value)
  self.normal = self.normal.deep_merge(attr_hash)
end