easy_install

Download and install packages from tarballs with with Puppet
Geoff Williams

Geoff Williams

geoffwilliams

6,392 downloads

5,976 latest version

1.9 quality score

Version information

  • 0.5.4 (latest)
  • 0.5.3
  • 0.5.2
  • 0.5.1
  • 0.5.0
released Jul 3rd 2019

Start using this module

Documentation

geoffwilliams/easy_install — version 0.5.4 Jul 3rd 2019

Build Status

easy_install

Table of Contents

  1. Description
  2. Usage - Configuration options and additional functionality
  3. Reference - An under-the-hood peek at what the module is doing and how
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module

Description

Download and install packages from tarballs with with Puppet

Setup

What easy_install affects

  • Install a hash of prerequisite packages on the system if required
  • Create a user and group if required
  • Download, extract and run the installer

Usage

Basic

class { "easy_install":
  media_source   => "http://megacorp.com/software/coolapp.tar",
  user           => "coolapp"
  creates        => "/opt/coolapp"
}

Download tarball from media source, extract and run installer:

  • Run as user 'coolapp'
  • Only runs if /opt/coolapp does not yet exist (to prevent constant re-installation)

Custom

class { "easy_install":
  media_source   => "http://megacorp.com/software/coolapp.tar",
  prereq_package => {"foo"=>{}, "bar"=>{}},
  environment    => "FOO=bar",
  arguments      => "--foo",
}

You can set parameters to the easy_install class to suit your needs, see class definition for details.

In this example, we:

  • Supplied a different list of prerequisites packages to install (foo and bar)
  • Supplied a custom environment to run the installation script (set shell variables, etc)
  • Passed the --foo option to our installer script

Reference

Defined resource types

  • easy_install - Install BMC Patrol agent

Limitations

  • Proxies not supported
  • Download platform must be supported by puppet-archive
  • Not supported by Puppet, Inc.

Development

PRs accepted :)

Testing

This module supports testing using PDQTest.

Test can be executed with:

bundle install
bundle exec pdqtest all

See .travis.yml for a working CI example