Class: Chef::Provider::Package

Inherits:
Chef::Provider show all
Includes:
Mixin::Command
Defined in:
lib/chef/provider/package.rb,
lib/chef/provider/package/apt.rb,
lib/chef/provider/package/rpm.rb,
lib/chef/provider/package/yum.rb,
lib/chef/provider/package/dpkg.rb,
lib/chef/provider/package/pacman.rb,
lib/chef/provider/package/zypper.rb,
lib/chef/provider/package/freebsd.rb,
lib/chef/provider/package/portage.rb,
lib/chef/provider/package/solaris.rb,
lib/chef/provider/package/macports.rb,
lib/chef/provider/package/rubygems.rb,
lib/chef/provider/package/easy_install.rb

Direct Known Subclasses

Apt, EasyInstall, Freebsd, Macports, Pacman, Portage, Rpm, Rubygems, Solaris, Yum, Zypper

Defined Under Namespace

Classes: Apt, Dpkg, EasyInstall, Freebsd, Macports, Pacman, Portage, Rpm, Rubygems, Solaris, Yum, Zypper

Instance Attribute Summary collapse

Attributes inherited from Chef::Provider

#current_resource, #new_resource, #run_context

Instance Method Summary collapse

Methods included from Mixin::Command

#chdir_or_tmpdir, #handle_command_failures, #not_if, #only_if, #output_of_command, #run_command, #run_command_with_systems_locale

Methods included from Mixin::Command::Windows

#popen4

Methods included from Mixin::Command::Unix

#popen4

Methods inherited from Chef::Provider

#action_nothing, build_from_file, #cookbook_name, #load_current_resource, #node, #resource_collection

Methods included from Mixin::ConvertToClassName

#convert_to_class_name, #convert_to_snake_case, #filename_to_qualified_string, #snake_case_basename

Methods included from Mixin::RecipeDefinitionDSLCore

#method_missing

Methods included from Mixin::Language

#data_bag, #data_bag_item, #platform?, #search, #value_for_platform

Constructor Details

#initialize(new_resource, run_context) ⇒ Package

Returns a new instance of Package.



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

def initialize(new_resource, run_context)
  super
  @candidate_version = nil
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Chef::Mixin::RecipeDefinitionDSLCore

Instance Attribute Details

#candidate_version ⇒ Object

Returns the value of attribute candidate_version.



31
32
33
 
# File 'lib/chef/provider/package.rb', line 31

def candidate_version
  @candidate_version
end

Instance Method Details

#action_install ⇒ Object 



38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/chef/provider/package.rb', line 38

def action_install  
  # If we specified a version, and it's not the current version, move to the specified version
  if @new_resource.version != nil && @new_resource.version != @current_resource.version
    install_version = @new_resource.version
  # If it's not installed at all, install it
  elsif @current_resource.version == nil
    install_version = candidate_version
  else
    return
  end

  unless install_version
    raise(Chef::Exceptions::Package, "No version specified, and no candidate version available for #{@new_resource.package_name}")
  end

  Chef::Log.info("Installing #{@new_resource} version #{install_version}")
    
  # We need to make sure we handle the preseed file
  if @new_resource.response_file
    preseed_package(@new_resource.package_name, install_version)
  end
    
  status = install_package(@new_resource.package_name, install_version)
  if status
    @new_resource.updated_by_last_action(true)
  end
end

#action_purge ⇒ Object 



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

def action_purge
  if removing_package?
    Chef::Log.info("Purging #{@new_resource}")
    purge_package(@current_resource.package_name, @new_resource.version)
    @new_resource.updated_by_last_action(true)
  end
end

#action_remove ⇒ Object 



77
78
79
80
81
82
83
84
 
# File 'lib/chef/provider/package.rb', line 77

def action_remove        
  if removing_package?
    Chef::Log.info("Removing #{@new_resource}")
    remove_package(@current_resource.package_name, @new_resource.version)
    @new_resource.updated_by_last_action(true)
  else
  end
end

#action_upgrade ⇒ Object 



66
67
68
69
70
71
72
73
74
75
 
# File 'lib/chef/provider/package.rb', line 66

def action_upgrade
  if @current_resource.version != candidate_version
    orig_version = @current_resource.version || "uninstalled"
    Chef::Log.info("Upgrading #{@new_resource} version from #{orig_version} to #{candidate_version}")
    status = upgrade_package(@new_resource.package_name, candidate_version)
    if status
      @new_resource.updated_by_last_action(true)
    end
  end
end

#expand_options(options) ⇒ Object 



154
155
156
 
# File 'lib/chef/provider/package.rb', line 154

def expand_options(options)
  options ? " #{options}" : ""
end

#get_preseed_file(name, version) ⇒ Object 



126
127
128
129
130
131
132
133
134
135
136
 
# File 'lib/chef/provider/package.rb', line 126

def get_preseed_file(name, version)
  resource = preseed_resource(name, version)
  Chef::Log.debug("Fetching preseed file to #{resource.path}")
  resource.run_action('create')
  
  if resource.updated_by_last_action?
    resource.path
  else
    false
  end
end

#install_package(name, version) ⇒ Object

Raises:



106
107
108
 
# File 'lib/chef/provider/package.rb', line 106

def install_package(name, version)
  raise Chef::Exceptions::UnsupportedAction, "#{self.to_s} does not support :install"
end

#preseed_package(name, version) ⇒ Object

Raises:



122
123
124
 
# File 'lib/chef/provider/package.rb', line 122

def preseed_package(name, version)
  raise Chef::Exceptions::UnsupportedAction, "#{self.to_s} does not support pre-seeding package install/upgrade instructions - don't ask it to!" 
end

#preseed_resource(name, version) ⇒ Object 



138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
 
# File 'lib/chef/provider/package.rb', line 138

def preseed_resource(name, version)
  # A directory in our cache to store this cookbook's preseed files in
  file_cache_dir = Chef::FileCache.create_cache_path("preseed/#{@new_resource.cookbook_name}")
  # The full path where the preseed file will be stored
  cache_seed_to = "#{file_cache_dir}/#{name}-#{version}.seed"

  Chef::Log.debug("Fetching preseed file to #{cache_seed_to}")

  remote_file = Chef::Resource::CookbookFile.new(cache_seed_to, run_context)
  remote_file.cookbook_name = @new_resource.cookbook_name
  remote_file.source(@new_resource.response_file)
  remote_file.backup(false)
  
  remote_file
end

#purge_package(name, version) ⇒ Object

Raises:



118
119
120
 
# File 'lib/chef/provider/package.rb', line 118

def purge_package(name, version)
  raise Chef::Exceptions::UnsupportedAction, "#{self.to_s} does not support :purge" 
end

#remove_package(name, version) ⇒ Object

Raises:



114
115
116
 
# File 'lib/chef/provider/package.rb', line 114

def remove_package(name, version)
  raise Chef::Exceptions::UnsupportedAction, "#{self.to_s} does not support :remove" 
end

#removing_package? ⇒ Boolean

Returns:

  • (Boolean) 


86
87
88
89
90
91
92
93
94
95
96
 
# File 'lib/chef/provider/package.rb', line 86

def removing_package?
  if @current_resource.version.nil?
    false # nothing to remove
  elsif @new_resource.version.nil?
    true # remove any version of a package
  elsif @new_resource.version == @current_resource.version
    true # remove the version we have
  else
    false # we don't have the version we want to remove
  end
end

#upgrade_package(name, version) ⇒ Object

Raises:



110
111
112
 
# File 'lib/chef/provider/package.rb', line 110

def upgrade_package(name, version)
  raise Chef::Exceptions::UnsupportedAction, "#{self.to_s} does not support :upgrade" 
end