Class: Chef::Recipe

Inherits:
Object
  • Object
show all
Includes:
DSL::Recipe, 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.

Instance Attribute Summary collapse

Attributes included from Mixin::FromFile

#source_file

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::Recipe

#exec, #have_resource_class_for?, #resource_class_for

Methods included from Mixin::LazyModuleInclude

#descendants, #include, #included

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::Cheffish

load_cheffish

Methods included from DSL::RebootPending

#reboot_pending?

Methods included from DSL::PlatformIntrospection

#older_than_win_2012_or_8?, #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::IncludeRecipe

#include_recipe, #load_recipe

Methods included from Mixin::NotifyingBlock

#notifying_block, #subcontext_block

Methods included from DSL::DeclareResource

#build_resource, #declare_resource, #delete_resource, #delete_resource!, #edit_resource, #edit_resource!, #find_resource, #find_resource!, #resources, #with_run_context

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 DSL::Secret

#default_secret_config, #default_secret_service, #secret, #with_secret_config, #with_secret_service

Methods included from DSL::RenderHelpers

#render_json, #render_toml, #render_yaml

Methods included from DSL::ReaderHelpers

#parse_file, #parse_json, #parse_toml, #parse_yaml

Methods included from DSL::Powershell

#ps_credential

Methods included from DSL::ChefVault

#chef_vault, #chef_vault_item, #chef_vault_item_for_environment

Methods included from DSL::DataQuery

#data_bag, #data_bag_item, #search, #tagged?

Methods included from EncryptedDataBagItem::CheckEncrypted

#encrypted?

Methods included from DSL::Compliance

#include_input, #include_profile, #include_waiver

Constructor Details

#initialize(cookbook_name, recipe_name, run_context) ⇒ Recipe

Returns a new instance of Recipe.



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

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 = {}
end

Instance Attribute Details

#cookbook_nameObject

Returns the value of attribute cookbook_name.



29
30
31
# File 'lib/chef/recipe.rb', line 29

def cookbook_name
  @cookbook_name
end

#paramsObject

Returns the value of attribute params.



29
30
31
# File 'lib/chef/recipe.rb', line 29

def params
  @params
end

#recipeObject

Returns the value of attribute recipe.



29
30
31
# File 'lib/chef/recipe.rb', line 29

def recipe
  @recipe
end

#recipe_nameObject

Returns the value of attribute recipe_name.



29
30
31
# File 'lib/chef/recipe.rb', line 29

def recipe_name
  @recipe_name
end

#run_contextObject

Returns the value of attribute run_context.



29
30
31
# File 'lib/chef/recipe.rb', line 29

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



45
46
47
48
49
50
51
52
53
54
55
56
# File 'lib/chef/recipe.rb', line 45

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

#from_hash(hash) ⇒ Object



112
113
114
115
116
117
118
119
120
121
122
# File 'lib/chef/recipe.rb', line 112

def from_hash(hash)
  hash["resources"].each do |rhash|
    type = rhash.delete("type").to_sym
    name = rhash.delete("name")
    res = declare_resource(type, name)
    rhash.each do |key, value|
      # FIXME?: we probably need a way to instance_exec a string that contains block code against the property?
      res.send(key, value)
    end
  end
end

#from_yaml(string) ⇒ Object



103
104
105
106
107
108
109
110
# File 'lib/chef/recipe.rb', line 103

def from_yaml(string)
  res = ::YAML.safe_load(string, permitted_classes: [Date])
  unless res.is_a?(Hash) && res.key?("resources")
    raise ArgumentError, "YAML recipe '#{source_file}' must contain a top-level 'resources' hash (YAML sequence), i.e. 'resources:'"
  end

  from_hash(res)
end

#from_yaml_file(filename) ⇒ Object



89
90
91
92
93
94
95
96
97
98
99
100
101
# File 'lib/chef/recipe.rb', line 89

def from_yaml_file(filename)
  self.source_file = filename
  if File.file?(filename) && File.readable?(filename)
    yaml_contents = IO.read(filename)
    if ::YAML.load_stream(yaml_contents).length > 1
      raise ArgumentError, "YAML recipe '#{filename}' contains multiple documents, only one is supported"
    end

    from_yaml(yaml_contents)
  else
    raise IOError, "Cannot open or read file '#{filename}'!"
  end
end

#inspectObject



128
129
130
# File 'lib/chef/recipe.rb', line 128

def inspect
  to_s
end

#nodeObject

Used in DSL mixins



67
68
69
# File 'lib/chef/recipe.rb', line 67

def node
  run_context.node
end

#tag(*tags) ⇒ Object

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



72
73
74
# File 'lib/chef/recipe.rb', line 72

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

#to_sObject



124
125
126
# File 'lib/chef/recipe.rb', line 124

def to_s
  "cookbook: #{cookbook_name || "(none)"}, recipe: #{recipe_name || "(none)"} "
end

#untag(*tags) ⇒ Object

Removes the list of tags from the node.

=== Parameters tags:: A list of tags

=== Returns tags:: The current list of run_context.node.tags



83
84
85
86
87
# File 'lib/chef/recipe.rb', line 83

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