Class: Chef::Provider

Inherits:
Object
  • Object
show all
Extended by:
DSL::Universal, Mixin::Provides, Forwardable
Includes:
DSL::Recipe, Mixin::WhyRun
Defined in:
lib/chef/provider.rb,
lib/chef/provider/git.rb,
lib/chef/provider/cron.rb,
lib/chef/provider/file.rb,
lib/chef/provider/link.rb,
lib/chef/provider/noop.rb,
lib/chef/provider/user.rb,
lib/chef/provider/batch.rb,
lib/chef/provider/group.rb,
lib/chef/provider/mount.rb,
lib/chef/provider/route.rb,
lib/chef/provider/script.rb,
lib/chef/provider/execute.rb,
lib/chef/provider/launchd.rb,
lib/chef/provider/package.rb,
lib/chef/provider/service.rb,
lib/chef/provider/user/pw.rb,
lib/chef/provider/cron/aix.rb,
lib/chef/provider/group/pw.rb,
lib/chef/provider/ifconfig.rb,
lib/chef/provider/template.rb,
lib/chef/provider/user/aix.rb,
lib/chef/provider/user/mac.rb,
lib/chef/provider/cron/unix.rb,
lib/chef/provider/directory.rb,
lib/chef/provider/group/aix.rb,
lib/chef/provider/lwrp_base.rb,
lib/chef/provider/mount/aix.rb,
lib/chef/provider/user/dscl.rb,
lib/chef/provider/dsc_script.rb,
lib/chef/provider/group/dscl.rb,
lib/chef/provider/ruby_block.rb,
lib/chef/provider/subversion.rb,
lib/chef/provider/user/linux.rb,
lib/chef/provider/mount/linux.rb,
lib/chef/provider/mount/mount.rb,
lib/chef/provider/package/apt.rb,
lib/chef/provider/package/bff.rb,
lib/chef/provider/package/cab.rb,
lib/chef/provider/package/deb.rb,
lib/chef/provider/package/dnf.rb,
lib/chef/provider/package/ips.rb,
lib/chef/provider/package/msu.rb,
lib/chef/provider/package/rpm.rb,
lib/chef/provider/package/yum.rb,
lib/chef/provider/remote_file.rb,
lib/chef/provider/service/aix.rb,
lib/chef/provider/dsc_resource.rb,
lib/chef/provider/file/content.rb,
lib/chef/provider/http_request.rb,
lib/chef/provider/ifconfig/aix.rb,
lib/chef/provider/package/dpkg.rb,
lib/chef/provider/package/snap.rb,
lib/chef/provider/registry_key.rb,
lib/chef/provider/service/init.rb,
lib/chef/provider/systemd_unit.rb,
lib/chef/provider/user/solaris.rb,
lib/chef/provider/user/windows.rb,
lib/chef/provider/cookbook_file.rb,
lib/chef/provider/group/gpasswd.rb,
lib/chef/provider/group/solaris.rb,
lib/chef/provider/group/usermod.rb,
lib/chef/provider/group/windows.rb,
lib/chef/provider/mount/solaris.rb,
lib/chef/provider/mount/windows.rb,
lib/chef/provider/group/groupadd.rb,
lib/chef/provider/group/groupmod.rb,
lib/chef/provider/package/pacman.rb,
lib/chef/provider/package/yum_tm.rb,
lib/chef/provider/package/zypper.rb,
lib/chef/provider/service/debian.rb,
lib/chef/provider/service/macosx.rb,
lib/chef/provider/service/redhat.rb,
lib/chef/provider/service/simple.rb,
lib/chef/provider/windows_script.rb,
lib/chef/provider/yum_repository.rb,
lib/chef/provider/ifconfig/debian.rb,
lib/chef/provider/ifconfig/redhat.rb,
lib/chef/provider/package/habitat.rb,
lib/chef/provider/package/openbsd.rb,
lib/chef/provider/package/paludis.rb,
lib/chef/provider/package/portage.rb,
lib/chef/provider/package/smartos.rb,
lib/chef/provider/package/snap_tm.rb,
lib/chef/provider/package/solaris.rb,
lib/chef/provider/package/windows.rb,
lib/chef/provider/remote_file/ftp.rb,
lib/chef/provider/resource_update.rb,
lib/chef/provider/service/aixinit.rb,
lib/chef/provider/service/freebsd.rb,
lib/chef/provider/service/insserv.rb,
lib/chef/provider/service/openbsd.rb,
lib/chef/provider/service/solaris.rb,
lib/chef/provider/service/upstart.rb,
lib/chef/provider/template_finder.rb,
lib/chef/provider/package/homebrew.rb,
lib/chef/provider/package/macports.rb,
lib/chef/provider/package/rubygems.rb,
lib/chef/provider/remote_directory.rb,
lib/chef/provider/remote_file/http.rb,
lib/chef/provider/remote_file/sftp.rb,
lib/chef/provider/template/content.rb,
lib/chef/provider/powershell_script.rb,
lib/chef/provider/service/invokercd.rb,
lib/chef/provider/zypper_repository.rb,
lib/chef/provider/package/chocolatey.rb,
lib/chef/provider/package/powershell.rb,
lib/chef/provider/package/dnf/version.rb,
lib/chef/provider/package/windows/exe.rb,
lib/chef/provider/package/windows/msi.rb,
lib/chef/provider/package/yum/version.rb,
lib/chef/provider/remote_file/content.rb,
lib/chef/provider/remote_file/fetcher.rb,
lib/chef/provider/package/freebsd/base.rb,
lib/chef/provider/package/freebsd/port.rb,
lib/chef/provider/cookbook_file/content.rb,
lib/chef/provider/package/freebsd/pkgng.rb,
lib/chef/provider/package/yum/rpm_utils.rb,
lib/chef/provider/package/yum/yum_cache.rb,
lib/chef/provider/package/zypper/version.rb,
lib/chef/provider/remote_file/local_file.rb,
lib/chef/provider/whyrun_safe_ruby_block.rb,
lib/chef/provider/remote_file/network_file.rb,
lib/chef/provider/package/dnf/python_helper.rb,
lib/chef/provider/package/yum/python_helper.rb,
lib/chef/provider/remote_file/cache_control_data.rb,
lib/chef/provider/package/windows/registry_uninstall_entry.rb

Defined Under Namespace

Classes: Batch, CookbookFile, Cron, Directory, DscResource, DscScript, Execute, File, Git, Group, HttpRequest, Ifconfig, LWRPBase, Launchd, Link, Mount, Noop, Package, PowershellScript, RegistryKey, RemoteDirectory, RemoteFile, ResourceUpdate, Route, RubyBlock, Script, Service, Subversion, SystemdUnit, Template, TemplateFinder, User, WhyrunSafeRubyBlock, WindowsScript, YumRepository, ZypperRepository

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Mixin::Provides

provided_as, provides, provides?

Methods included from Mixin::DescendantsTracker

#descendants, descendants, direct_descendants, #direct_descendants, find_descendants_by_name, #find_descendants_by_name, #inherited, store_inherited

Methods included from Mixin::LazyModuleInclude

#descendants, #include, #included

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

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

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

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

Methods included from DSL::Recipe

#exec, #have_resource_class_for?, #resource_class_for

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

#include_input, #include_profile, #include_waiver

Constructor Details

#initialize(new_resource, run_context) ⇒ Provider

Returns a new instance of Provider.



129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
 
# File 'lib/chef/provider.rb', line 129

def initialize(new_resource, run_context)
  @new_resource = new_resource
  @action = action
  @current_resource = nil
  @after_resource = nil
  @run_context = run_context
  @converge_actions = nil

  @logger = if run_context
              run_context.logger.with_child({ resource: new_resource.name, cookbook: cookbook_name, recipe: recipe_name })
            else
              Chef::Log.with_child({ resource: new_resource.name, cookbook: cookbook_name, recipe: recipe_name })
            end

  @recipe_name = nil
  @cookbook_name = nil
  self.class.include_resource_dsl_module(new_resource)
end

Instance Attribute Details

#action ⇒ Object

TODO:

this should be a reader, and the action should be passed in the

constructor; however, many/most subclasses override the constructor so changing the arity would be a breaking change. Change this at the next major release



127
128
129
 
# File 'lib/chef/provider.rb', line 127

def action
  @action
end

#after_resource ⇒ Object

Returns the value of attribute after_resource.



35
36
37
 
# File 'lib/chef/provider.rb', line 35

def after_resource
  @after_resource
end

#current_resource ⇒ Object

Returns the value of attribute current_resource.



34
35
36
 
# File 'lib/chef/provider.rb', line 34

def current_resource
  @current_resource
end

#logger ⇒ Object (readonly)

Returns the value of attribute logger.



38
39
40
 
# File 'lib/chef/provider.rb', line 38

def logger
  @logger
end

#new_resource ⇒ Object

Returns the value of attribute new_resource.



33
34
35
 
# File 'lib/chef/provider.rb', line 33

def new_resource
  @new_resource
end

#run_context ⇒ Object

Returns the value of attribute run_context.



36
37
38
 
# File 'lib/chef/provider.rb', line 36

def run_context
  @run_context
end

Class Method Details

.action(name, description: nil, &block) ⇒ void

This method returns an undefined value.

Defines an action method on the provider, running the block to compile the resources, converging them, and then checking if any were updated (and updating new-resource if so)

Parameters:

  • name (String, Symbol) —

    Name of the action to define.

  • description (String) (defaults to: nil) —

    description of the action

  • block (Proc) —

    Body of the action.

Since:

  • 13.0



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

def self.action(name, description: nil, &block)
  action_descriptions[name.to_sym] = description unless description.nil?
  # We need the block directly in a method so that `return` works.
  define_method("compile_action_#{name}", &block)
  class_eval <<-EOM
    def action_#{name}
      compile_and_converge_action { compile_action_#{name} }
    end
  EOM
end

.action_description(action) ⇒ String

Retrieve the description for a provider's action, if any description has been included in the definition.

was defined

Parameters:

Returns:

  • (String) —

    the description of the action provided, or nil if no description



89
90
91
92
93
94
95
 
# File 'lib/chef/provider.rb', line 89

def self.action_description(action)
  description = action_descriptions[action.to_sym]
  if description.nil? && superclass.respond_to?(:action_description)
    description = superclass.action_description(action)
  end
  description
end

.action_descriptions ⇒ Hash

Return the hash of action descriptions defined for the provider class.

any provided action descriptions.

Returns:

  • (Hash) —

    hash of [Symbol] => [String] containing



79
80
81
 
# File 'lib/chef/provider.rb', line 79

def self.action_descriptions
  @action_descriptions ||= {}
end

.include_resource_dsl? ⇒ Boolean

Include attributes, public and protected methods from this Resource in the provider.

If this is set to true, delegate methods are included in the provider so that you can call (for example) attrname and it will call new_resource.attrname.

The actual include does not happen until the first time the Provider is instantiated (so that we don't have to worry about load order issues).

Parameters:

  • include_resource_dsl (Boolean) —

    Whether to include resource DSL or not (defaults to false).

Returns:

  • (Boolean) 


417
418
419
 
# File 'lib/chef/provider.rb', line 417

def self.include_resource_dsl?
  false
end

.include_resource_dsl_module(resource) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Create the resource DSL module that forwards resource methods to new_resource



424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
 
# File 'lib/chef/provider.rb', line 424

def self.include_resource_dsl_module(resource)
  if include_resource_dsl? && !defined?(@included_resource_dsl_module)
    provider_class = self
    @included_resource_dsl_module = Module.new do
      extend Forwardable
      define_singleton_method(:to_s) { "forwarder module for #{provider_class}" }
      define_singleton_method(:inspect) { to_s }
      # this magic, stated simply, is that any instance method declared directly on
      # the resource we are building, will be accessible from the action_class(provider)
      # instance.  methods declared on Chef::Resource and properties are not inherited.
      dsl_methods =
        resource.class.public_instance_methods +
        resource.class.protected_instance_methods -
        provider_class.instance_methods -
        resource.class.properties.keys -
        resource.class.properties.keys.map { |k| "#{k}=".to_sym } -
        Chef::Resource.instance_methods
      def_delegators(:new_resource, *dsl_methods)
    end
    include @included_resource_dsl_module
  end
end

.provides(short_name, opts = {}, &block) ⇒ Object 



395
396
397
 
# File 'lib/chef/provider.rb', line 395

def self.provides(short_name, opts = {}, &block)
  Chef.provider_handler_map.set(short_name, self, **opts, &block)
end

.provides?(node, resource) ⇒ Boolean

Returns:

  • (Boolean) 


399
400
401
 
# File 'lib/chef/provider.rb', line 399

def self.provides?(node, resource)
  Chef::ProviderResolver.new(node, resource, :nothing).provided_by?(self)
end

.supports?(resource, action) ⇒ Boolean

supports the given resource and action (late binding)

Returns:

  • (Boolean) 


49
50
51
 
# File 'lib/chef/provider.rb', line 49

def self.supports?(resource, action)
  true
end

.use(partial) ⇒ Object

Use a partial code fragment. This can be used for code sharing between multiple resources.

Do not wrap the code fragment in a class or module. It also does not support the use of super to subclass any methods defined in the fragment, the methods will just be overwritten.

Parameters:

  • partial (String) —

    the code fragment to eval against the class



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

def self.use(partial)
  dirname = ::File.dirname(partial)
  basename = ::File.basename(partial, ".rb")
  basename = basename[1..] if basename.start_with?("_")
  class_eval IO.read(::File.expand_path("#{dirname}/_#{basename}.rb", ::File.dirname(caller_locations.first.path)))
end

.use_inline_resources ⇒ void

This method returns an undefined value.

Deprecation stub for the old use_inline_resources mode.



100
101
102
103
 
# File 'lib/chef/provider.rb', line 100

def self.use_inline_resources
  # Uncomment this in Chef 13.6.
  # Chef.deprecated(:use_inline_resources, "The use_inline_resources mode is no longer optional and the line enabling it can be removed")
end

Instance Method Details

#action_nothing ⇒ Object

the :nothing action which is available on all resources by default



201
202
203
204
 
# File 'lib/chef/provider.rb', line 201

def action_nothing
  logger.trace("Doing nothing for #{@new_resource}")
  true
end

#check_resource_semantics! ⇒ Object

hook that subclasses can use to do lazy validation for where properties aren't flexible enough



181
 
# File 'lib/chef/provider.rb', line 181

def check_resource_semantics!; end

#cleanup_after_converge ⇒ Object 



191
 
# File 'lib/chef/provider.rb', line 191

def cleanup_after_converge; end

#compile_and_converge_action(&block) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Create a child run_context, compile the block, and converge it.



299
300
301
302
303
304
305
306
307
308
309
310
311
312
 
# File 'lib/chef/provider.rb', line 299

def compile_and_converge_action(&block)
  old_run_context = run_context
  @run_context = run_context.create_child
  @run_context.resource_collection.unified_mode = new_resource.class.unified_mode
  runner = Chef::Runner.new(@run_context)
  return_value = instance_eval(&block)
  runner.converge
  return_value
ensure
  if run_context.resource_collection.any?(&:updated?)
    new_resource.updated_by_last_action(true)
  end
  @run_context = old_run_context
end

#converge_by(descriptions, &block) ⇒ Object 



292
293
294
 
# File 'lib/chef/provider.rb', line 292

def converge_by(descriptions, &block)
  converge_actions.add_action(descriptions, &block)
end

#converge_if_changed(*properties, &converge_block) ⇒ Boolean

Handle patchy convergence safely.

  • Does not call the block if the current_resource's properties match the properties the user specified on the resource.
  • Calls the block if current_resource does not exist
  • Calls the block if the user has specified any properties in the resource whose values are different from current_resource.
  • Does not call the block if why-run is enabled (just prints out text).
  • Prints out automatic green text saying what properties have changed.

Parameters:

  • properties —

    An optional list of property names (symbols). If not specified, new_resource.class.state_properties will be used.

  • converge_block —

    The block to do the converging in.

Returns:

  • (Boolean) —

    whether the block was executed.



331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
 
# File 'lib/chef/provider.rb', line 331

def converge_if_changed(*properties, &converge_block)
  unless converge_block
    raise ArgumentError, "converge_if_changed must be passed a block!"
  end

  properties =
    if properties.empty?
      new_resource.class.state_properties
    else
      properties.map { |property| new_resource.class.properties[property] }
    end

  if current_resource
    # Collect the list of modified properties
    specified_properties = properties.select { |property| property.is_set?(new_resource) || property.has_default? }
    specified_properties = specified_properties.map(&:name).map(&:to_sym)
    modified = specified_properties.select { |p| new_resource.send(p) != current_resource.send(p) }
    if modified.empty?
      properties_str = if new_resource.sensitive
                         specified_properties.join(", ")
                       else
                         specified_properties.map do |property|
                           "#{property}=" << if new_resource.class.properties[property].sensitive?
                                               "(suppressed sensitive property)"
                                             else
                                               new_resource.send(property).inspect
                                             end
                         end.join(", ")
                       end
      logger.debug("Skipping update of #{new_resource}: has not changed any of the specified properties #{properties_str}.")
      return false
    end

    # Print the pretty green text and run the block
    property_size = modified.map(&:size).max
    modified.map! do |p|
      properties_str = if new_resource.sensitive || new_resource.class.properties[p].sensitive?
                         "(suppressed sensitive property)"
                       else
                         "#{new_resource.send(p).inspect} (was #{current_resource.send(p).inspect})"
                       end
      "  set #{p.to_s.ljust(property_size)} to #{properties_str}"
    end
    converge_by([ "update #{current_resource.identity}" ] + modified, &converge_block)

  else
    # The resource doesn't exist. Mark that we are *creating* this, and
    # write down any properties we are setting.
    property_size = properties.map(&:name).map(&:to_sym).map(&:size).max
    created = properties.map do |property|
      default = " (default value)" unless property.is_set?(new_resource)
      properties_str = if new_resource.sensitive || property.sensitive?
                         "(suppressed sensitive property)"
                       else
                         new_resource.send(property.name.to_sym).inspect
                       end
      "  set #{property.name.to_sym.to_s.ljust(property_size)} to #{properties_str}#{default}"
    end

    converge_by([ "create #{new_resource.identity}" ] + created, &converge_block)
  end
  true
end

#cookbook_name ⇒ Object 



172
173
174
 
# File 'lib/chef/provider.rb', line 172

def cookbook_name
  new_resource.cookbook_name
end

#define_resource_requirements ⇒ Object 



189
 
# File 'lib/chef/provider.rb', line 189

def define_resource_requirements; end

#description(description = "NOT_PASSED") ⇒ Object 



278
279
280
281
282
283
 
# File 'lib/chef/provider.rb', line 278

def description(description = "NOT_PASSED")
  if description != "NOT_PASSED"
    @description = description
  end
  @description
end

#events ⇒ Object 



206
207
208
 
# File 'lib/chef/provider.rb', line 206

def events
  run_context.events
end

#introduced(introduced = "NOT_PASSED") ⇒ Object 



285
286
287
288
289
290
 
# File 'lib/chef/provider.rb', line 285

def introduced(introduced = "NOT_PASSED")
  if introduced != "NOT_PASSED"
    @introduced = introduced
  end
  @introduced
end

#load_after_resource ⇒ Object 



193
194
195
196
197
198
 
# File 'lib/chef/provider.rb', line 193

def load_after_resource
  # This is a backwards compatible hack, custom resources properly wire up a new after_resource
  # via load_current_value.  It is acceptable for old style resources that cannot be easily made
  # into custom resources to override this method and provide a proper after_resource.
  @after_resource = @new_resource
end

#load_current_resource ⇒ Object

a simple placeholder method that will be called / raise if a resource tries to use current_resource without defining a load_current_resource method.

Raises:



185
186
187
 
# File 'lib/chef/provider.rb', line 185

def load_current_resource
  raise Chef::Exceptions::Override, "You must override load_current_resource in #{self}"
end

#node ⇒ Object 



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

def node
  run_context && run_context.node
end

#process_resource_requirements ⇒ Object 



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

def process_resource_requirements
  requirements.run(:all_actions) unless @action == :nothing
  requirements.run(@action)
end

#recipe_name ⇒ Object 



176
177
178
 
# File 'lib/chef/provider.rb', line 176

def recipe_name
  new_resource.recipe_name
end

#requirements ⇒ Object 



274
275
276
 
# File 'lib/chef/provider.rb', line 274

def requirements
  @requirements ||= ResourceRequirements.new(@new_resource, run_context, action || new_resource.action)
end

#resource_collection ⇒ Object

Used by providers supporting embedded recipes



168
169
170
 
# File 'lib/chef/provider.rb', line 168

def resource_collection
  run_context && run_context.resource_collection
end

#resource_updated? ⇒ Boolean

Returns:

  • (Boolean) 


261
262
263
 
# File 'lib/chef/provider.rb', line 261

def resource_updated?
  !converge_actions.empty? || @new_resource.updated_by_last_action?
end

#run_action(action = nil) ⇒ Object 



215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
 
# File 'lib/chef/provider.rb', line 215

def run_action(action = nil)
  @action = action unless action.nil?

  # hook that subclasses can use to do lazy validation for where properties aren't flexible enough
  check_resource_semantics!

  # force the validation of required properties
  validate_required_properties!

  # user-defined LWRPs may include unsafe load_current_resource methods that cannot be run in whyrun mode
  if whyrun_mode? && !whyrun_supported?
    events.resource_current_state_load_bypassed(@new_resource, @action, @current_resource)
  else
    load_current_resource
    events.resource_current_state_loaded(@new_resource, @action, @current_resource)
  end

  define_resource_requirements
  process_resource_requirements

  # user-defined providers including LWRPs may
  # not include whyrun support - if they don't support it
  # we can't execute any actions while we're running in
  # whyrun mode. Instead we 'fake' whyrun by documenting that
  # we can't execute the action.
  # in non-whyrun mode, this will still cause the action to be
  # executed normally.
  if whyrun_mode? && (!whyrun_supported? || requirements.action_blocked?(@action))
    events.resource_bypassed(@new_resource, @action, self)
  else
    send("action_#{@action}")
  end

  set_updated_status

  cleanup_after_converge

  load_after_resource
  events.resource_after_state_loaded(@new_resource, @action, @after_resource)
end

#set_updated_status ⇒ Object 



265
266
267
268
269
270
271
272
 
# File 'lib/chef/provider.rb', line 265

def set_updated_status
  if !resource_updated?
    events.resource_up_to_date(@new_resource, @action)
  else
    events.resource_updated(@new_resource, @action)
    new_resource.updated_by_last_action(true)
  end
end

#validate_required_properties! ⇒ Object 



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

def validate_required_properties!
  # all we do is run through all the required properties for this action and vivify them
  new_resource.class.properties.each { |name, property| property.required?(action) && property.get(new_resource) }
end

#whyrun_mode? ⇒ Boolean

has why-run mode been enabled?

Returns:

  • (Boolean) 


151
152
153
 
# File 'lib/chef/provider.rb', line 151

def whyrun_mode?
  Chef::Config[:why_run]
end

#whyrun_supported? ⇒ Boolean

as of Chef 13 we enable why-run by default and require resources to override this to set false. We're keeping this method to prevent breaking the cookbook world for no real gain on our part.

Returns:

  • (Boolean) 


159
160
161
 
# File 'lib/chef/provider.rb', line 159

def whyrun_supported?
  true
end