Class: Chef::Provider::Package::Powershell

Inherits:
Chef::Provider::Package show all
Includes:
Mixin::PowershellOut
Defined in:
lib/chef/provider/package/powershell.rb

Instance Attribute Summary

Attributes inherited from Chef::Provider

#action, #current_resource, #logger, #new_resource, #recipe_name, #run_context

Instance Method Summary collapse

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

apply_default_env, maybe_add_timeout, #shell_out, #shell_out!

Methods inherited from Chef::Provider::Package

#action_lock, #action_unlock, #as_array, #expand_options, #have_any_matching_version?, #initialize, #lock_package, #multipackage_api_adapter, #options, #package_locked, #prepare_for_installation, #preseed_package, #purge_package, #reconfig_package, #removing_package?, #target_version_already_installed?, #unlock_package, #upgrade_package, #version_compare, #version_equals?, #version_requirement_satisfied?

Methods included from Mixin::SubclassDirective

#subclass_directive

Methods inherited from Chef::Provider

action, #action_nothing, #cleanup_after_converge, #compile_and_converge_action, #converge_by, #converge_if_changed, #cookbook_name, #description, #events, include_resource_dsl?, include_resource_dsl_module, #initialize, #introduced, #node, #process_resource_requirements, provides, provides?, #requirements, #resource_collection, #resource_updated?, #run_action, #set_updated_status, supports?, use_inline_resources, #whyrun_mode?, #whyrun_supported?

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

#powershell_exec

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

Constructor Details

This class inherits a constructor from Chef::Provider::Package

Instance Method Details

#build_candidate_versionsObject

Returns array of available available online



81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
# File 'lib/chef/provider/package/powershell.rb', line 81

def build_candidate_versions
  versions = []
  new_resource.package_name.each_with_index do |name, index|
    version = if new_resource.version && !new_resource.version[index].nil?
                powershell_out(build_powershell_package_command("Find-Package '#{name}'", new_resource.version[index]), timeout: new_resource.timeout).stdout.strip
              else
                powershell_out(build_powershell_package_command("Find-Package '#{name}'"), timeout: new_resource.timeout).stdout.strip
              end
    if version.empty?
      version = nil
    end
    versions.push(version)
  end
  versions
end

#build_current_versionsObject

Returns version array of installed version on the system



98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
# File 'lib/chef/provider/package/powershell.rb', line 98

def build_current_versions
  version_list = []
  new_resource.package_name.each_with_index do |name, index|
    version = if new_resource.version && !new_resource.version[index].nil?
                powershell_out(build_powershell_package_command("Get-Package '#{name}'", new_resource.version[index]), timeout: new_resource.timeout).stdout.strip
              else
                powershell_out(build_powershell_package_command("Get-Package '#{name}'"), timeout: new_resource.timeout).stdout.strip
              end
    if version.empty?
      version = nil
    end
    version_list.push(version)
  end
  version_list
end

#build_powershell_package_command(command, version = nil) ⇒ Object



114
115
116
117
118
119
120
121
122
123
124
125
126
# File 'lib/chef/provider/package/powershell.rb', line 114

def build_powershell_package_command(command, version = nil)
  command = [command] unless command.is_a?(Array)
  cmdlet_name = command.first
  command.unshift("(")
  %w{-Force -ForceBootstrap}.each do |arg|
    command.push(arg)
  end
  command.push("-RequiredVersion #{version}") if version
  command.push("-Source #{new_resource.source}") if new_resource.source && cmdlet_name =~ Regexp.union(/Install-Package/, /Find-Package/)
  command.push("-SkipPublisherCheck") if new_resource.skip_publisher_check && cmdlet_name !~ /Find-Package/
  command.push(").Version")
  command.join(" ")
end

#candidate_versionObject



50
51
52
# File 'lib/chef/provider/package/powershell.rb', line 50

def candidate_version
  @candidate_version ||= build_candidate_versions
end

#check_resource_semantics!Object



128
129
130
# File 'lib/chef/provider/package/powershell.rb', line 128

def check_resource_semantics!
  # This validation method from Chef::Provider::Package does not apply here, so no-op it.
end

#define_resource_requirementsObject



37
38
39
40
41
42
43
44
45
46
47
48
# File 'lib/chef/provider/package/powershell.rb', line 37

def define_resource_requirements
  super
  if powershell_out("$PSVersionTable.PSVersion.Major").stdout.strip.to_i < 5
    raise "Minimum installed PowerShell Version required is 5"
  end

  requirements.assert(:install) do |a|
    a.assertion { candidates_exist_for_all_uninstalled? }
    a.failure_message(Chef::Exceptions::Package, "No candidate version available for #{packages_missing_candidates.join(", ")}")
    a.whyrun("Assuming a repository that offers #{packages_missing_candidates.join(", ")} would have been configured")
  end
end

#install_package(names, versions) ⇒ Object

Installs the package specified with the version passed else latest version will be installed



55
56
57
58
59
60
61
# File 'lib/chef/provider/package/powershell.rb', line 55

def install_package(names, versions)
  names.each_with_index do |name, index|
    cmd = powershell_out(build_powershell_package_command("Install-Package '#{name}'", versions[index]), timeout: new_resource.timeout)
    next if cmd.nil?
    raise Chef::Exceptions::PowershellCmdletException, "Failed to install package due to catalog signing error, use skip_publisher_check to force install" if cmd.stderr =~ /SkipPublisherCheck/
  end
end

#load_current_resourceObject



30
31
32
33
34
35
# File 'lib/chef/provider/package/powershell.rb', line 30

def load_current_resource
  @current_resource = Chef::Resource::PowershellPackage.new(new_resource.name)
  current_resource.package_name(new_resource.package_name)
  current_resource.version(build_current_versions)
  current_resource
end

#remove_package(names, versions) ⇒ Object

Removes the package for the version passed and if no version is passed, then all installed versions of the package are removed



64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
# File 'lib/chef/provider/package/powershell.rb', line 64

def remove_package(names, versions)
  names.each_with_index do |name, index|
    if versions && !versions[index].nil?
      powershell_out(build_powershell_package_command("Uninstall-Package '#{name}'", versions[index]), timeout: new_resource.timeout)
    else
      version = "0"
      until version.empty?
        version = powershell_out(build_powershell_package_command("Uninstall-Package '#{name}'"), timeout: new_resource.timeout).stdout.strip
        unless version.empty?
          logger.info("Removed package '#{name}' with version #{version}")
        end
      end
    end
  end
end