Class: Chef::Node

Inherits:
Object show all
Extended by:
Forwardable
Includes:
DSL::IncludeAttribute, DSL::PlatformIntrospection, Mixin::FromFile, Mixin::ParamsValidate
Defined in:
lib/chef/node.rb,
lib/chef/node/attribute.rb,
lib/chef/node/attribute_collections.rb,
lib/chef/node/immutable_collections.rb

Defined Under Namespace

Modules: Immutablize Classes: AttrArray, Attribute, ImmutableArray, ImmutableMash, VividMash

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Mixin::ParamsValidate

#set_or_return, #validate

Methods included from DSL::PlatformIntrospection

#platform?, #platform_family?, #value_for_platform, #value_for_platform_family

Methods included from DSL::IncludeAttribute

#include_attribute, #parse_attribute_file_spec

Methods included from Mixin::FromFile

#class_from_file, #from_file

Constructor Details

#initializeNode

Create a new Chef::Node object.



62
63
64
65
66
67
68
69
70
71
# File 'lib/chef/node.rb', line 62

def initialize
  @name = nil

  @chef_environment = '_default'
  @run_list = Chef::RunList.new

  @attributes = Chef::Node::Attribute.new({}, {}, {}, {})

  @run_state = {}
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(symbol, *args) ⇒ Object

Only works for attribute fetches, setting is no longer supported



235
236
237
# File 'lib/chef/node.rb', line 235

def method_missing(symbol, *args)
  attributes.send(symbol, *args)
end

Instance Attribute Details

#recipe_listObject

Returns the value of attribute recipe_list.



45
46
47
# File 'lib/chef/node.rb', line 45

def recipe_list
  @recipe_list
end

#run_contextObject

RunContext will set itself as run_context via this setter when initialized. This is needed so DSL::IncludeAttribute (in particular, #include_recipe) can access the run_context to determine if an attributes file has been seen yet. – TODO: This is a pretty ugly way to solve that problem.



53
54
55
# File 'lib/chef/node.rb', line 53

def run_context
  @run_context
end

#run_list(*args) ⇒ Object

Returns an Array of roles and recipes, in the order they will be applied. If you call it with arguments, they will become the new list of roles and recipes.



257
258
259
# File 'lib/chef/node.rb', line 257

def run_list
  @run_list
end

#run_stateObject

Returns the value of attribute run_state.



45
46
47
# File 'lib/chef/node.rb', line 45

def run_state
  @run_state
end

Class Method Details

.build(node_name) ⇒ Object



464
465
466
467
468
469
# File 'lib/chef/node.rb', line 464

def self.build(node_name)
  node = new
  node.name(node_name)
  node.chef_environment(Chef::Config[:environment]) unless Chef::Config[:environment].nil? || Chef::Config[:environment].chop.empty?
  node
end

.find_or_create(node_name) ⇒ Object



456
457
458
459
460
461
462
# File 'lib/chef/node.rb', line 456

def self.find_or_create(node_name)
  load(node_name)
rescue Net::HTTPServerException => e
  raise unless e.response.code == '404'
  node = build(node_name)
  node.create
end

.json_create(o) ⇒ Object

Create a Chef::Node from JSON



414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
# File 'lib/chef/node.rb', line 414

def self.json_create(o)
  node = new
  node.name(o["name"])
  node.chef_environment(o["chef_environment"])
  if o.has_key?("attributes")
    node.normal_attrs = o["attributes"]
  end
  node.automatic_attrs = Mash.new(o["automatic"]) if o.has_key?("automatic")
  node.normal_attrs = Mash.new(o["normal"]) if o.has_key?("normal")
  node.default_attrs = Mash.new(o["default"]) if o.has_key?("default")
  node.override_attrs = Mash.new(o["override"]) if o.has_key?("override")

  if o.has_key?("run_list")
    node.run_list.reset!(o["run_list"])
  else
    o["recipes"].each { |r| node.recipes << r }
  end
  node
end

.list(inflate = false) ⇒ Object



444
445
446
447
448
449
450
451
452
453
454
# File 'lib/chef/node.rb', line 444

def self.list(inflate=false)
  if inflate
    response = Hash.new
    Chef::Search::Query.new.search(:node) do |n|
      response[n.name] = n unless n.nil?
    end
    response
  else
    Chef::REST.new(Chef::Config[:chef_server_url]).get_rest("nodes")
  end
end

.list_by_environment(environment, inflate = false) ⇒ Object



434
435
436
437
438
439
440
441
442
# File 'lib/chef/node.rb', line 434

def self.list_by_environment(environment, inflate=false)
  if inflate
    response = Hash.new
    Chef::Search::Query.new.search(:node, "chef_environment:#{environment}") {|n| response[n.name] = n unless n.nil?}
    response
  else
    Chef::REST.new(Chef::Config[:chef_server_url]).get_rest("environments/#{environment}/nodes")
  end
end

.load(name) ⇒ Object

Load a node by name



472
473
474
# File 'lib/chef/node.rb', line 472

def self.load(name)
  Chef::REST.new(Chef::Config[:chef_server_url]).get_rest("nodes/#{name}")
end

Instance Method Details

#[](attrib) ⇒ Object

Return an attribute of this node. Returns nil if the attribute is not found.



119
120
121
# File 'lib/chef/node.rb', line 119

def [](attrib)
  attributes[attrib]
end

#apply_expansion_attributes(expansion) ⇒ Object

Apply the default and overrides attributes from the expansion passed in, which came from roles.



341
342
343
344
345
346
347
348
349
350
351
352
353
# File 'lib/chef/node.rb', line 341

def apply_expansion_attributes(expansion)
  loaded_environment = if chef_environment == "_default"
                         Chef::Environment.new.tap {|e| e.name("_default")}
                       else
                         Chef::Environment.load(chef_environment)
                       end

  attributes.env_default = loaded_environment.default_attributes
  attributes.env_override = loaded_environment.override_attributes

  attribute.role_default = expansion.default_attrs
  attributes.role_override = expansion.override_attrs
end

#attribute?(attrib) ⇒ Boolean

Return true if this Node has a given attribute, false if not. Takes either a symbol or a string.

Only works on the top level. Preferred way is to use the normal [] style lookup and call attribute?()

Returns:

  • (Boolean)


220
221
222
# File 'lib/chef/node.rb', line 220

def attribute?(attrib)
  attributes.attribute?(attrib)
end

#attributesObject Also known as: attribute, construct_attributes



111
112
113
# File 'lib/chef/node.rb', line 111

def attributes
  @attributes
end

#automatic_attrsObject



207
208
209
# File 'lib/chef/node.rb', line 207

def automatic_attrs
  attributes.automatic
end

#automatic_attrs=(new_values) ⇒ Object



211
212
213
# File 'lib/chef/node.rb', line 211

def automatic_attrs=(new_values)
  attributes.automatic = new_values
end

#chef_environment(arg = nil) ⇒ Object Also known as: environment



97
98
99
100
101
102
103
# File 'lib/chef/node.rb', line 97

def chef_environment(arg=nil)
  set_or_return(
    :chef_environment,
    arg,
    { :regex => /^[\-[:alnum:]_]+$/, :kind_of => String }
  )
end

#chef_environment=(environment) ⇒ Object



105
106
107
# File 'lib/chef/node.rb', line 105

def chef_environment=(environment)
  chef_environment(environment)
end

#chef_server_restObject



78
79
80
# File 'lib/chef/node.rb', line 78

def chef_server_rest
  Chef::REST.new(Chef::Config[:chef_server_url])
end

#consume_attributes(attrs) ⇒ Object

Consumes the combined run_list and other attributes in attrs



280
281
282
283
284
285
# File 'lib/chef/node.rb', line 280

def consume_attributes(attrs)
  normal_attrs_to_merge = consume_run_list(attrs)
  Chef::Log.debug("Applying attributes from json file")
  self.normal_attrs = Chef::Mixin::DeepMerge.merge(normal_attrs,normal_attrs_to_merge)
  self.tags # make sure they're defined
end

#consume_external_attrs(ohai_data, json_cli_attrs) ⇒ Object

Consume data from ohai and Attributes provided as JSON on the command line.



267
268
269
270
271
272
273
274
275
276
277
# File 'lib/chef/node.rb', line 267

def consume_external_attrs(ohai_data, json_cli_attrs)
  Chef::Log.debug("Extracting run list from JSON attributes provided on command line")
  consume_attributes(json_cli_attrs)

  self.automatic_attrs = ohai_data

  platform, version = Chef::Platform.find_platform_and_version(self)
  Chef::Log.debug("Platform is #{platform} version #{version}")
  self.automatic[:platform] = platform
  self.automatic[:platform_version] = version
end

#consume_run_list(attrs) ⇒ Object

Extracts the run list from attrs and applies it. Returns the remaining attributes



294
295
296
297
298
299
300
301
302
303
304
# File 'lib/chef/node.rb', line 294

def consume_run_list(attrs)
  attrs = attrs ? attrs.dup : {}
  if new_run_list = attrs.delete("recipes") || attrs.delete("run_list")
    if attrs.key?("recipes") || attrs.key?("run_list")
      raise Chef::Exceptions::AmbiguousRunlistSpecification, "please set the node's run list using the 'run_list' attribute only."
    end
    Chef::Log.info("Setting the run_list to #{new_run_list.inspect} from JSON")
    run_list(new_run_list)
  end
  attrs
end

#createObject

Create the node via the REST API



499
500
501
502
# File 'lib/chef/node.rb', line 499

def create
  chef_server_rest.post_rest("nodes", self)
  self
end

#defaultObject

Set a default of this node, but auto-vivify any Mashes that might be missing



142
143
144
145
# File 'lib/chef/node.rb', line 142

def default
  attributes.set_unless_value_present = false
  attributes.default
end

#default!Object

Set a force default attribute. Intermediate mashes will be created by auto-vivify if necessary.



149
150
151
152
# File 'lib/chef/node.rb', line 149

def default!
  attributes.set_unless_value_present = false
  attributes.default!
end

#default_attrsObject



191
192
193
# File 'lib/chef/node.rb', line 191

def default_attrs
  attributes.default
end

#default_attrs=(new_values) ⇒ Object



195
196
197
# File 'lib/chef/node.rb', line 195

def default_attrs=(new_values)
  attributes.default = new_values
end

#default_unlessObject

Set a default attribute of this node, auto-vivifying any mashes that are missing, but if the final value already exists, don’t set it



156
157
158
159
# File 'lib/chef/node.rb', line 156

def default_unless
  attributes.set_unless_value_present = true
  attributes.default
end

#destroyObject

Remove this node via the REST API



477
478
479
# File 'lib/chef/node.rb', line 477

def destroy
  chef_server_rest.delete_rest("nodes/#{name}")
end

#display_hashObject



370
371
372
373
374
375
376
377
378
379
380
# File 'lib/chef/node.rb', line 370

def display_hash
  display = {}
  display["name"]             = name
  display["chef_environment"] = chef_environment
  display["automatic"]        = automatic_attrs
  display["normal"]           = normal_attrs
  display["default"]          = attributes.combined_default
  display["override"]         = attributes.combined_override
  display["run_list"]         = run_list.run_list
  display
end

#each(&block) ⇒ Object

Yield each key of the top level to the block.



225
226
227
# File 'lib/chef/node.rb', line 225

def each(&block)
  attributes.each(&block)
end

#each_attribute(&block) ⇒ Object

Iterates over each attribute, passing the attribute and value to the block.



230
231
232
# File 'lib/chef/node.rb', line 230

def each_attribute(&block)
  attributes.each_attribute(&block)
end

#expand!(data_source = 'server') ⇒ Object

Expands the node’s run list and sets the default and override attributes. Also applies stored attributes (from json provided on the command line)

Returns the fully-expanded list of recipes, a RunListExpansion.

– TODO: timh/cw, 5-14-2010: Should this method exist? Should we instead modify default_attrs and override_attrs whenever our run_list is mutated? Or perhaps do something smarter like on-demand generation of default_attrs and override_attrs, invalidated only when run_list is mutated?



325
326
327
328
329
330
331
332
333
334
335
336
337
# File 'lib/chef/node.rb', line 325

def expand!(data_source = 'server')
  expansion = run_list.expand(chef_environment, data_source)
  raise Chef::Exceptions::MissingRole, expansion if expansion.errors?

  self.tags # make sure they're defined

  automatic_attrs[:recipes] = expansion.recipes
  automatic_attrs[:roles] = expansion.roles

  apply_expansion_attributes(expansion)

  expansion
end

#for_jsonObject



387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
# File 'lib/chef/node.rb', line 387

def for_json
  result = {
    "name" => name,
    "chef_environment" => chef_environment,
    'json_class' => self.class.name,
    "automatic" => attributes.automatic,
    "normal" => attributes.normal,
    "chef_type" => "node",
    "default" => attributes.combined_default,
    "override" => attributes.combined_override,
    #Render correctly for run_list items so malformed json does not result
    "run_list" => run_list.run_list.map { |item| item.to_s }
  }
  result
end

#name(arg = nil) ⇒ Object

Set the name of this Node, or return the current name.



83
84
85
86
87
88
89
90
91
92
93
94
95
# File 'lib/chef/node.rb', line 83

def name(arg=nil)
  if arg != nil
    validate(
             {:name => arg },
             {:name => { :kind_of => String,
                 :cannot_be => :blank,
                 :regex => /^[\-[:alnum:]_:.]+$/}
             })
    @name = arg
  else
    @name
  end
end

#nodeObject

Used by DSL



74
75
76
# File 'lib/chef/node.rb', line 74

def node
  self
end

#normalObject Also known as: set

Set a normal attribute of this node, but auto-vivify any Mashes that might be missing



125
126
127
128
# File 'lib/chef/node.rb', line 125

def normal
  attributes.set_unless_value_present = false
  attributes.normal
end

#normal_attrsObject



199
200
201
# File 'lib/chef/node.rb', line 199

def normal_attrs
  attributes.normal
end

#normal_attrs=(new_values) ⇒ Object



203
204
205
# File 'lib/chef/node.rb', line 203

def normal_attrs=(new_values)
  attributes.normal = new_values
end

#normal_unlessObject Also known as: set_unless

Set a normal attribute of this node, auto-vivifying any mashes that are missing, but if the final value already exists, don’t set it



134
135
136
137
# File 'lib/chef/node.rb', line 134

def normal_unless
  attributes.set_unless_value_present = true
  attributes.normal
end

#overrideObject

Set an override attribute of this node, but auto-vivify any Mashes that might be missing



163
164
165
166
# File 'lib/chef/node.rb', line 163

def override
  attributes.set_unless_value_present = false
  attributes.override
end

#override!Object

Set a force override attribute. Intermediate mashes will be created by auto-vivify if needed.



170
171
172
173
# File 'lib/chef/node.rb', line 170

def override!
  attributes.set_unless_value_present = false
  attributes.override!
end

#override_attrsObject



183
184
185
# File 'lib/chef/node.rb', line 183

def override_attrs
 attributes.override
end

#override_attrs=(new_values) ⇒ Object



187
188
189
# File 'lib/chef/node.rb', line 187

def override_attrs=(new_values)
  attributes.override = new_values
end

#override_unlessObject

Set an override attribute of this node, auto-vivifying any mashes that are missing, but if the final value already exists, don’t set it



177
178
179
180
# File 'lib/chef/node.rb', line 177

def override_unless
  attributes.set_unless_value_present = true
  attributes.override
end

#recipe?(recipe_name) ⇒ Boolean

Returns true if this Node expects a given recipe, false if not.

First, the run list is consulted to see whether the recipe is explicitly included. If it’s not there, it looks in ‘node`, which is populated when the run_list is expanded

NOTE: It’s used by cookbook authors

Returns:

  • (Boolean)


246
247
248
# File 'lib/chef/node.rb', line 246

def recipe?(recipe_name)
  run_list.include?(recipe_name) || Array(self[:recipes]).include?(recipe_name)
end

#reset_defaults_and_overridesObject

Clear defaults and overrides, so that any deleted attributes between runs are still gone.



308
309
310
311
# File 'lib/chef/node.rb', line 308

def reset_defaults_and_overrides
  self.default.clear
  self.override.clear
end

#role?(role_name) ⇒ Boolean

Returns true if this Node expects a given role, false if not.

Returns:

  • (Boolean)


251
252
253
# File 'lib/chef/node.rb', line 251

def role?(role_name)
  run_list.include?("role[#{role_name}]")
end

#run_list?(item) ⇒ Boolean

Returns true if this Node expects a given role, false if not.

Returns:

  • (Boolean)


262
263
264
# File 'lib/chef/node.rb', line 262

def run_list?(item)
  run_list.detect { |r| r == item } ? true : false
end

#saveObject

Save this node via the REST API



482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
# File 'lib/chef/node.rb', line 482

def save
  # Try PUT. If the node doesn't yet exist, PUT will return 404,
  # so then POST to create.
  begin
    if Chef::Config[:why_run]
      Chef::Log.warn("In whyrun mode, so NOT performing node save.")
    else
      chef_server_rest.put_rest("nodes/#{name}", self)
    end
  rescue Net::HTTPServerException => e
    raise e unless e.response.code == "404"
    chef_server_rest.post_rest("nodes", self)
  end
  self
end

#tagsObject

Lazy initializer for tags attribute



288
289
290
291
# File 'lib/chef/node.rb', line 288

def tags
  normal[:tags] = [] unless attribute?(:tags)
  normal[:tags]
end

#to_hashObject

Transform the node to a Hash



356
357
358
359
360
361
362
363
364
365
366
367
368
# File 'lib/chef/node.rb', line 356

def to_hash
  index_hash = Hash.new
  index_hash["chef_type"] = "node"
  index_hash["name"] = name
  index_hash["chef_environment"] = chef_environment
  attribute.each do |key, value|
    index_hash[key] = value
  end
  index_hash["recipe"] = run_list.recipe_names if run_list.recipe_names.length > 0
  index_hash["role"] = run_list.role_names if run_list.role_names.length > 0
  index_hash["run_list"] = run_list.run_list if run_list.run_list.length > 0
  index_hash
end

#to_json(*a) ⇒ Object

Serialize this object as a hash



383
384
385
# File 'lib/chef/node.rb', line 383

def to_json(*a)
  for_json.to_json(*a)
end

#to_sObject



504
505
506
# File 'lib/chef/node.rb', line 504

def to_s
  "node[#{name}]"
end

#update_from!(o) ⇒ Object



403
404
405
406
407
408
409
410
411
# File 'lib/chef/node.rb', line 403

def update_from!(o)
  run_list.reset!(o.run_list)
  self.automatic_attrs = o.automatic_attrs
  self.normal_attrs = o.normal_attrs
  self.override_attrs = o.override_attrs
  self.default_attrs = o.default_attrs
  chef_environment(o.chef_environment)
  self
end