Skip to content
This repository has been archived by the owner on Jun 11, 2019. It is now read-only.

example42/puppet-perl

Repository files navigation

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',
      }