Puppet package_alternatives module

This module provides a defined type package_alternatives for easy installation of software packages with different (alternative) names across platforms.

Requirements

Module has been tested on:

• Puppet 5.5
• Debian and Red Hat family systems

Required modules:

• puppetlabs-stdlib

Quick Start

Full configuration options:

package_alternatives { 'resource title':
  ensure       => ...,         # Resource package ensure state
  fail_missing => boolean,     # Fail on no alternative package.
  alternatives => string|hash, # Structure with package alternatives.
  platform     => string,      # Current platform detection override.
}

Software alternatives structure

$alternatives accepts:

• string for no alternative (defaults to resource $title)

• hash of platforms and alternative package names, e.g.:

$software = {
  'debian' => 'openssh-client',
  'redhat' => 'openssh-clients'
}

• hash of resource names with with hash or string containing package name or platforms hash of alternatives, e.g.:

$software = {
  'bash' => 'bash',
  'openssh-client' => {
    'debian' => 'openssh-client',
    'redhat' => 'openssh-clients',
  }
}

Platforms resolution order

Lower cased:

0. Custom $platform parameter
1. ${::operatingsystem}-${::operatingsystemrelease}-${::architecture} (centos-6.4-x86_64)
2. ${::operatingsystem}-${::operatingsystemrelease} (centos-6.4)
3. ${::operatingsystem}-${::operatingsystemmajrelease}-${::architecture} (centos-6-x86_64)
4. ${::operatingsystem}-${::operatingsystemmajrelease} (centos-6)
5. ${::operatingsystem}-${::architecture} (centos-x86_64)
6. ${::operatingsystem} (centos)
7. ${::osfamily}-${::operatingsystemrelease}-${::architecture} (redhat-6.4-x86_64)
8. ${::osfamily}-${::operatingsystemrelease} (redhat-6.4)
9. ${::osfamily}-${::operatingsystemmajrelease}-${::architecture} (redhat-6-x86_64)
10. ${::osfamily}-${::operatingsystemmajrelease} (redhat-6)
11. ${::osfamily}-${::architecture} (redhat-x86_64)
12. ${::osfamily} (redhat)

Software alternatives structure

Parameter $alternatives accepts:

• string for no alternative (defaults to resource $title)

$software = 'bash'

• hash of platforms and alternative package names, e.g.:

$software = {
  'debian' => 'openssh-client',
  'redhat' => 'openssh-clients'
}

• hash of resource names with with hash or string containing package name or platforms hash of alternatives, e.g.:

$software = {
  'bash' => 'bash',
  'openssh-client' => {
    'debian' => 'openssh-client',
    'redhat' => 'openssh-clients',
  }
}

Example

$software = {
  'rsync'  => 'rsync',          # same name on all platforms
  'ash'    => {
    'debian'   => 'ash'         # just Debian supported
  },
  'tshark' => {
    'debian-6' => 'tshark',     # just Debian 6 and any
    'redhat'   => 'wireshark',  # RedHat family supported
  },
}

package_alternatives { keys($software):
  ensure       => present,
  alternatives => $software,
  fail_missing => false,       # skip packages with no alternative on platform
}

CERIT Scientific Cloud, support@cerit-sc.cz

2018-04-28 - Release 1.0.3

• Fix support for hash of hashes with alternatives
• Fix module archive file permissions

2018-04-28 - Release 1.0.0

• Convert to the PDK module
• Modernize for Puppet 4/5
• Unit tests

2017-06-13 - Release 0.9.5

Fix warnings about Puppet Unknown variable: '_pkg_name'

2017-06-12 - Release 0.9.4

Check for already defined package alias.

2015-09-22 - Release 0.9.3

Check for already defined package.

Bugfixes

• Before defining new package check for existing definition.

2014-12-08 - Release 0.9.2

Fix file/directory permissions.

Bugfixes

• Fix PF module archive file/directory permissions.

2014-09-02 - Release 0.9.1

Summary

Fix metadata.json

Bugfixes

• Fix metadata.json module dependencies

2014-08-07 - Release 0.9.0

Summary

Initial release.