Class: Chef::Recipe

Inherits:
Object
  • Object
show all
Includes:
DSL::Recipe::FullDSL, Mixin::Deprecation, Mixin::FromFile
Defined in:
lib/chef/recipe.rb

Overview

Chef::Recipe

A Recipe object is the context in which Chef recipes are evaluated.

Constant Summary

Constants included from Mixin::ShellOut

Mixin::ShellOut::DEPRECATED_OPTIONS

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Mixin::Deprecation

#deprecated_attr, #deprecated_attr_reader, #deprecated_attr_writer, #deprecated_ivar

Methods included from Mixin::FromFile

#class_from_file, #from_file

Methods included from DSL::Powershell

#ps_credential

Methods included from DSL::Audit

#control_group

Methods included from DSL::RebootPending

#reboot_pending?

Methods included from DSL::PlatformIntrospection

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

Methods included from DSL::RegistryHelper

#registry_data_exists?, #registry_get_subkeys, #registry_get_values, #registry_has_subkeys?, #registry_key_exists?, #registry_value_exists?

Methods included from DSL::Recipe

#describe_self_for_error, #exec, #have_resource_class_for?, #method_missing, #resource_class_for

Methods included from DSL::DeclareResource

#build_resource, #declare_resource

Methods included from DSL::Definitions

add_definition, #evaluate_resource_definition, #has_resource_definition?

Methods included from DSL::Resources

add_resource_dsl, remove_resource_dsl

Methods included from DSL::ChefProvisioning

load_chef_provisioning

Methods included from DSL::Cheffish

load_cheffish

Methods included from Mixin::PowershellOut

#powershell_out, #powershell_out!

Methods included from Mixin::WindowsArchitectureHelper

#assert_valid_windows_architecture!, #disable_wow64_file_redirection, #forced_32bit_override_required?, #is_i386_process_on_x86_64_windows?, #node_supports_windows_architecture?, #node_windows_architecture, #restore_wow64_file_redirection, #valid_windows_architecture?, #with_os_architecture, #wow64_architecture_override_required?, #wow64_directory

Methods included from Mixin::ShellOut

#run_command_compatible_options, #shell_out, #shell_out!, #shell_out_with_systems_locale, #shell_out_with_systems_locale!

Methods included from DSL::IncludeRecipe

#include_recipe, #load_recipe, #require_recipe

Methods included from DSL::DataQuery

#data_bag, #data_bag_item, #search

Methods included from EncryptedDataBagItem::CheckEncrypted

#encrypted?

Constructor Details

#initialize(cookbook_name, recipe_name, run_context) ⇒ Recipe 



66
67
68
69
70
71
72
 
# File 'lib/chef/recipe.rb', line 66

def initialize(cookbook_name, recipe_name, run_context)
  @cookbook_name = cookbook_name
  @recipe_name = recipe_name
  @run_context = run_context
  # TODO: 5/19/2010 cw/tim: determine whether this can be removed

  @params = Hash.new
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Chef::DSL::Recipe

Instance Attribute Details

#cookbook_name ⇒ Object

Returns the value of attribute cookbook_name.



43
44
45
 
# File 'lib/chef/recipe.rb', line 43

def cookbook_name
  @cookbook_name
end

#params ⇒ Object

Returns the value of attribute params.



43
44
45
 
# File 'lib/chef/recipe.rb', line 43

def params
  @params
end

#recipe ⇒ Object

Returns the value of attribute recipe.



43
44
45
 
# File 'lib/chef/recipe.rb', line 43

def recipe
  @recipe
end

#recipe_name ⇒ Object

Returns the value of attribute recipe_name.



43
44
45
 
# File 'lib/chef/recipe.rb', line 43

def recipe_name
  @recipe_name
end

#run_context ⇒ Object

Returns the value of attribute run_context.



43
44
45
 
# File 'lib/chef/recipe.rb', line 43

def run_context
  @run_context
end

Class Method Details

.parse_recipe_name(recipe_name, current_cookbook: nil) ⇒ Object

Parses a potentially fully-qualified recipe name into its cookbook name and recipe short name.

For example:

"aws::elastic_ip" returns [:aws, "elastic_ip"]
"aws" returns [:aws, "default"]
"::elastic_ip" returns [ current_cookbook, "elastic_ip" ]

– TODO: Duplicates functionality of RunListItem



54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/chef/recipe.rb', line 54

def self.parse_recipe_name(recipe_name, current_cookbook: nil)
  case recipe_name
  when /(.+?)::(.+)/
    [ $1.to_sym, $2 ]
  when /^::(.+)/
    raise "current_cookbook is nil, cannot resolve #{recipe_name}" if current_cookbook.nil?
    [ current_cookbook.to_sym, $1 ]
  else
    [ recipe_name.to_sym, "default" ]
  end
end

Instance Method Details

#node ⇒ Object

Used in DSL mixins



75
76
77
 
# File 'lib/chef/recipe.rb', line 75

def node
  run_context.node
end

#resources(*args) ⇒ Object

Used by the DSL to look up resources when executing in the context of a recipe.



81
82
83
 
# File 'lib/chef/recipe.rb', line 81

def resources(*args)
  run_context.resource_collection.find(*args)
end

#tag(*tags) ⇒ Object

This was moved to Chef::Node#tag, redirecting here for compatibility



86
87
88
 
# File 'lib/chef/recipe.rb', line 86

def tag(*tags)
  run_context.node.tag(*tags)
end

#tagged?(*tags) ⇒ Boolean

Returns true if the node is tagged with all of the supplied tags.

Parameters

tags<Array>

A list of tags

Returns

true<TrueClass>

If all the parameters are present

false<FalseClass>

If any of the parameters are missing



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

def tagged?(*tags)
  tags.each do |tag|
    return false unless run_context.node.tags.include?(tag)
  end
  true
end

#untag(*tags) ⇒ Object

Removes the list of tags from the node.

Parameters

tags<Array>

A list of tags

Returns

tags<Array>

The current list of run_context.node.tags



112
113
114
115
116
 
# File 'lib/chef/recipe.rb', line 112

def untag(*tags)
  tags.each do |tag|
    run_context.node.tags.delete(tag)
  end
end