class Chef::Provider::Package::Yum

Public Instance Methods

candidate_version() click to toggle source
# File lib/chef/provider/package/yum.rb, line 88
def candidate_version
  package_name_array.each_with_index.map do |pkg, i|
    available_version(i).version_with_arch
  end
end
define_resource_requirements() click to toggle source
# File lib/chef/provider/package/yum.rb, line 78
def define_resource_requirements
  requirements.assert(:install, :upgrade, :remove, :purge) do |a|
    a.assertion { !new_resource.source || ::File.exist?(new_resource.source) }
    a.failure_message Chef::Exceptions::Package, "Package #{new_resource.package_name} not found: #{new_resource.source}"
    a.whyrun "assuming #{new_resource.source} would have previously been created"
  end

  super
end
get_current_versions() click to toggle source
# File lib/chef/provider/package/yum.rb, line 100
def get_current_versions
  package_name_array.each_with_index.map do |pkg, i|
    current_version(i).version_with_arch
  end
end
install_package(names, versions) click to toggle source
# File lib/chef/provider/package/yum.rb, line 106
def install_package(names, versions)
  method = nil
  methods = []
  names.each_with_index do |n, i|
    next if n.nil?

    av = available_version(i)
    name = av.name # resolve the name via the available/candidate version
    iv = python_helper.package_query(:whatinstalled, av.name_with_arch, options: options)

    method = "install"

    # If this is a package like the kernel that can be installed multiple times, we'll skip over this logic
    if new_resource.allow_downgrade && version_gt?(iv.version_with_arch, av.version_with_arch) && !python_helper.install_only_packages(name)
      # We allow downgrading only in the event of single-package
      # rules where the user explicitly allowed it
      method = "downgrade"
    end

    methods << method
  end

  # We could split this up into two commands if we wanted to, but
  # for now, just don't support this.
  if methods.uniq.length > 1
    raise Chef::Exceptions::Package, "Multipackage rule has a mix of upgrade and downgrade packages. Cannot proceed."
  end

  if new_resource.source
    yum(options, "-y", method, new_resource.source)
  else
    resolved_names = names.each_with_index.map { |name, i| available_version(i).to_s unless name.nil? }
    yum(options, "-y", method, resolved_names)
  end
  flushcache
end
Also aliased as: upgrade_package
load_after_resource() click to toggle source
# File lib/chef/provider/package/yum.rb, line 68
def load_after_resource
  # force the installed version array to repopulate
  @current_version = []
  @after_resource = Chef::Resource::YumPackage.new(new_resource.name)
  after_resource.package_name(new_resource.package_name)
  after_resource.version(get_current_versions)

  after_resource
end
load_current_resource() click to toggle source
# File lib/chef/provider/package/yum.rb, line 58
def load_current_resource
  flushcache if new_resource.flush_cache[:before]

  @current_resource = Chef::Resource::YumPackage.new(new_resource.name)
  current_resource.package_name(new_resource.package_name)
  current_resource.version(get_current_versions)

  current_resource
end
lock_package(names, versions) click to toggle source

NB: the yum_package provider manages individual single packages, please do not submit issues or PRs to try to add wildcard support to lock / unlock. The best solution is to write an execute resource which does a not_if ‘yum versionlock | grep ’^pattern“ kind of approach

# File lib/chef/provider/package/yum.rb, line 160
def lock_package(names, versions)
  yum("-d0", "-e0", "-y", options, "versionlock", "add", resolved_package_lock_names(names))
end
magic_version_array() click to toggle source
# File lib/chef/provider/package/yum.rb, line 94
def magic_version_array
  package_name_array.each_with_index.map do |pkg, i|
    magical_version(i).version_with_arch
  end
end
purge_package(names, versions)
Alias for: remove_package
python_helper() click to toggle source

Most of the magic in this class happens in the python helper script. The ruby side of this provider knows only enough to translate Chef-style new_resource name+package+version into a request to the python side. The python side is then responsible for knowing everything about RPMs and what is installed and what is available. The ruby side of this class should remain a lightweight translation layer to translate Chef requests into RPC requests to python. This class knows nothing about how to compare RPM versions, and does not maintain any cached state of installed/available versions and should be kept that way.

# File lib/chef/provider/package/yum.rb, line 54
def python_helper
  @python_helper ||= PythonHelper.instance
end
remove_package(names, versions) click to toggle source
# File lib/chef/provider/package/yum.rb, line 146
def remove_package(names, versions)
  resolved_names = names.each_with_index.map { |name, i| magical_version(i).to_s unless name.nil? }
  yum(options, "-y", "remove", resolved_names)
  flushcache
end
Also aliased as: purge_package
unlock_package(names, versions) click to toggle source

NB: the yum_package provider manages individual single packages, please do not submit issues or PRs to try to add wildcard support to lock / unlock. The best solution is to write an execute resource which does a only_if ‘yum versionlock | grep ’^pattern“ kind of approach

# File lib/chef/provider/package/yum.rb, line 166
def unlock_package(names, versions)
  # yum versionlock delete on rhel6 needs the glob nonsense in the following command
  yum("-d0", "-e0", "-y", options, "versionlock", "delete", resolved_package_lock_names(names).map { |n| "*:#{n}-*" })
end
upgrade_package(names, versions)

yum upgrade does not work on uninstalled packaged, while install will upgrade

Alias for: install_package

Private Instance Methods

available_version(index) click to toggle source

@return Array<Version>

# File lib/chef/provider/package/yum.rb, line 234
def available_version(index)
  @available_version ||= []

  @available_version[index] ||= if new_resource.source
                                  resolve_source_to_version_obj
                                else
                                  python_helper.package_query(:whatavailable, package_name_array[index], version: safe_version_array[index], arch: safe_arch_array[index], options: options)
                                end

  @available_version[index]
end
current_version(index) click to toggle source

@return Array<Version>

# File lib/chef/provider/package/yum.rb, line 257
def current_version(index)
  @current_version ||= []
  @current_version[index] ||= if new_resource.source
                                python_helper.package_query(:whatinstalled, available_version(index).name, arch: safe_arch_array[index], options: options)
                              else
                                python_helper.package_query(:whatinstalled, package_name_array[index], arch: safe_arch_array[index], options: options)
                              end
  @current_version[index]
end
flushcache() click to toggle source
# File lib/chef/provider/package/yum.rb, line 267
def flushcache
  python_helper.close_rpmdb
end
locked_packages() click to toggle source
# File lib/chef/provider/package/yum.rb, line 186
def locked_packages
  @locked_packages ||=
    begin
      locked = yum("versionlock", "list")
      locked.stdout.each_line.map do |line|
        line.sub(/-[^-]*-[^-]*$/, "").split(":").last.strip
      end
    end
end
magical_version(index) click to toggle source
# File lib/chef/provider/package/yum.rb, line 246
def magical_version(index)
  @magical_version ||= []
  @magical_version[index] ||= if new_resource.source
                                python_helper.package_query(:whatinstalled, available_version(index).name, version: safe_version_array[index], arch: safe_arch_array[index], options: options)
                              else
                                python_helper.package_query(:whatinstalled, package_name_array[index], version: safe_version_array[index], arch: safe_arch_array[index], options: options)
                              end
  @magical_version[index]
end
packages_all_locked?(names, versions) click to toggle source
# File lib/chef/provider/package/yum.rb, line 196
def packages_all_locked?(names, versions)
  resolved_package_lock_names(names).all? { |n| locked_packages.include? n }
end
packages_all_unlocked?(names, versions) click to toggle source
# File lib/chef/provider/package/yum.rb, line 200
def packages_all_unlocked?(names, versions)
  !resolved_package_lock_names(names).any? { |n| locked_packages.include? n }
end
resolve_source_to_version_obj() click to toggle source
# File lib/chef/provider/package/yum.rb, line 222
def resolve_source_to_version_obj
  shell_out!("rpm -qp --queryformat '%{NAME} %{EPOCH} %{VERSION} %{RELEASE} %{ARCH}\n' #{new_resource.source}").stdout.each_line do |line|
    # this is another case of committing the sin of doing some lightweight mangling of RPM versions in ruby -- but the output of the rpm command
    # does not match what the yum library accepts.
    case line
      when /^(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)$/
        return Version.new($1, "#{$2 == "(none)" ? "0" : $2}:#{$3}-#{$4}", $5)
    end
  end
end
resolved_package_lock_names(names) click to toggle source

this will resolve things like ‘/usr/bin/perl` or virtual packages like `mysql` – it will not work (well? at all?) with globs that match multiple packages

# File lib/chef/provider/package/yum.rb, line 174
def resolved_package_lock_names(names)
  names.each_with_index.map do |name, i|
    unless name.nil?
      if magical_version(i).version.nil?
        available_version(i).name
      else
        magical_version(i).name
      end
    end
  end
end
safe_arch_array() click to toggle source
# File lib/chef/provider/package/yum.rb, line 293
def safe_arch_array
  if new_resource.arch.is_a?(Array)
    new_resource.arch
  elsif new_resource.arch.nil?
    package_name_array.map { nil }
  else
    [ new_resource.arch ]
  end
end
safe_version_array() click to toggle source
# File lib/chef/provider/package/yum.rb, line 283
def safe_version_array
  if new_resource.version.is_a?(Array)
    new_resource.version
  elsif new_resource.version.nil?
    package_name_array.map { nil }
  else
    [ new_resource.version ]
  end
end
version_compare(v1, v2) click to toggle source
# File lib/chef/provider/package/yum.rb, line 216
def version_compare(v1, v2)
  return false if v1.nil? || v2.nil?

  python_helper.compare_versions(v1, v2)
end
version_equals?(v1, v2) click to toggle source
# File lib/chef/provider/package/yum.rb, line 210
def version_equals?(v1, v2)
  return false if v1.nil? || v2.nil?

  python_helper.compare_versions(v1, v2) == 0
end
version_gt?(v1, v2) click to toggle source
# File lib/chef/provider/package/yum.rb, line 204
def version_gt?(v1, v2)
  return false if v1.nil? || v2.nil?

  python_helper.compare_versions(v1, v2) == 1
end
yum(*args) click to toggle source
# File lib/chef/provider/package/yum.rb, line 279
def yum(*args)
  shell_out!(yum_binary, *args)
end
yum_binary() click to toggle source
# File lib/chef/provider/package/yum.rb, line 271
def yum_binary
  @yum_binary ||=
    begin
      yum_binary = new_resource.yum_binary if new_resource.is_a?(Chef::Resource::YumPackage)
      yum_binary ||= ::File.exist?("/usr/bin/yum-deprecated") ? "yum-deprecated" : "yum"
    end
end