isabella232 / puppet-perl

Puppet module to manage Perl and CPAN modules

Deprecation notice

This module was designed for Puppet versions 2 and 3. It should work also on Puppet 4 but doesn't use any of its features.

The current Puppet 3 compatible codebase is no longer actively maintained by example42.

Still, Pull Requests that fix bugs or introduce backwards compatible features will be accepted.

Puppet module: perl

This is a Puppet module to manage perl and perl modules on CPAN.

Based on Example42 layouts by Alessandro Franceschi / Lab42

Official site: http://www.example42.com

Official git repository: http://github.com/example42/puppet-perl

Module development sponsored by JobRapido

Released under the terms of Apache 2 License.

This module requires the presence of Example42 Puppi module in your modulepath.

USAGE - Modules installation

• Install a module via CPAN Minus

    include ::perl # You need the perl main class to be already evaluated         perl::module { 'Path::Class': }
  

• Install a module via CPAN command

    include ::perl
    perl::cpan::module { 'Path::Class': }
  

• Remove a module previously installed via CPAN Minus

    perl::module { 'Path::Class':
      ensure => absent,
    }
  

• Install a module using the OS packages

    perl::module { 'YAML::Perl':
      use_package => true,
    }
  

Note that the prefix name of the package (perl-) is automatically added and the :: are converted to -. The actual package installed in this case is therefore: perl-YAML-Perl

• Install a module from the given url

    perl::module { 'My::Module':
      url => 'http://repo.example42.com/perl/my-module.tgz',
    }
  

• Install a module (via cpan) setting environment variables

    perl::module { 'Path::Class':
      exec_environment => [ "http_proxy=http://proxy.example42.com:8080" , "https_proxy=https://proxy.example42.com:8080" ],
    }
  

USAGE - Basic management

• Install perl with default settings

    class { 'perl': }
  

• Install a specific version of perl package

    class { 'perl':
      version => '1.0.1',
    }
  

• Remove perl resources

    class { 'perl':
      absent => true
    }
  

• Automatically include a custom subclass

    class { 'perl':
      my_class => 'example42::my_perl',
    }