Puppet Class: wkhtmltox

Inherits:
::wkhtmltox::params
Defined in:
manifests/init.pp

Overview

Class: wkhtmltox

The wkhtmltox Puppet module allows a user to install the wkhtmlto(x/pdf) toolkit via packages. It can either install it via a repository, or alternatively (and by default), downloads the latest version specified from sourceforge and installs the package.

Parameters

ensure

Allows you to set (present|absent) which will install or remove the package

version

Set the version number of wkhtml to download

arch

Select either amd64 or i386 depending upon your architecture.

osver

Set the operation system version, which by default pulls from facter.

packagetype

Select the package type of wkhtml to download. We currently support deb/rpm

provider

Set a valid provider type to install the package release we download

download_url

Set the location of the final wkhtmltox binary download to use. Can be the default or go to a local package repository if needed

wkhtml_filename

Build a filename of the binary to download for wkhtmltox

use_downloader

If the module should use a local/repo package version or download/install.

Examples

class { wkhtmltox:
  ensure => present,
}

Authors

Justice London <jlondon@syrussystems.com>

Copyright 2014 Justice London, unless otherwise noted.

Parameters:

  • ensure (Any) (defaults to: present)
  • version_major (Any) (defaults to: $::wkhtmltox::params::majversion)
  • version (Any) (defaults to: $::wkhtmltox::params::version)
  • arch (Any) (defaults to: $::wkhtmltox::params::arch)
  • osver (Any) (defaults to: $::wkhtmltox::params::osver)
  • packagetype (Any) (defaults to: $::wkhtmltox::params::packagetype)
  • provider (Any) (defaults to: $::wkhtmltox::params::provider)
  • required_pkgs (Any) (defaults to: $::wkhtmltox::params::required_pkgs)
  • download_url (Any) (defaults to: 'https://downloads.wkhtmltopdf.org')
  • wkhtml_filename (Any) (defaults to: undef)
  • use_downloader (Any) (defaults to: true) 


44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
 
# File 'manifests/init.pp', line 44

class wkhtmltox (
  $ensure          = present,
  $version_major   = $::wkhtmltox::params::majversion,
  $version         = $::wkhtmltox::params::version,
  $arch            = $::wkhtmltox::params::arch,
  $osver           = $::wkhtmltox::params::osver,
  $packagetype     = $::wkhtmltox::params::packagetype,
  $provider        = $::wkhtmltox::params::provider,
  $required_pkgs   = $::wkhtmltox::params::required_pkgs,
  $download_url    = 'https://downloads.wkhtmltopdf.org',
  $wkhtml_filename = undef,
  $use_downloader  = true,
) inherits ::wkhtmltox::params {
  include wget

  #Move x86_64 to amd64
  $true_arch = $arch ? {
    'x86_64' => 'amd64',
    default  => $arch
  }

  if $wkhtml_filename {
    $filename          = $wkhtml_filename
    $download_location = "${download_url}/${wkhtml_filename}"
  }
  else {
    $filename          = "wkhtmltox-${version}_linux-${osver}-${true_arch}.${packagetype}"
    $download_location = "${download_url}/${version_major}/${version}/${filename}"
  }

  #Variable validations
  validate_re($ensure, '^present$|^absent$')
  validate_string($version)
  validate_re($arch, '^i386$|^amd64|^x86_64$')
  validate_string($osver)
  validate_re($packagetype, '^deb$|^rpm$')
  validate_re($provider, '^dpkg$|^rpm$')
  validate_array($required_pkgs)
  validate_string($download_url)
  validate_bool($use_downloader)

  #Package requirements for wkhtmltox
  ensure_packages($required_pkgs, {
    ensure => $ensure,
    before => Package['wkhtmltox'],
  } )

  if $use_downloader {
    #Download wkhtmltox package
    wget::fetch { 'wkhtml_package':
      source      => $download_location,
      destination => "/tmp/${filename}",
      verbose     => true,
    }

    ensure_packages('wkhtmltox', {
      ensure   => $ensure,
      source   => "/tmp/${filename}",
      provider => $provider,
      require  => Wget::Fetch['wkhtml_package'],
    } )
  }
  else {
    #Just install the plain package, such as from a repo.
    ensure_packages('wkhtmltox', {
      ensure => $ensure,
    } )
  }

}