README.md

puppet-cpan

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with cpan
   • What cpan affects
   • Beginning with cpan
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how

Overview

Handle installations of cpan modules via puppet.

Module Description

The cpan module sets up capn on a server

Setup

What puppet-cpan affects

• cpan package.
• cpan configuration file.

Usage

All options and configuration can be done through interacting with the parameters on the cpan class and the cpan resource type. These are documented below.

cpan class

class {'::cpan':
  manage_config  => true,
  manage_package => true,
  package_ensure => 'present',
  installdirs    => 'site',
  local_lib      => false,
  config_hash    => { 'build_requires_install_policy' => 'no' },
}

Beginning with cpan

include '::cpan'
cpan { "Clone::Closure":
  ensure  => present,
  require => Class['::cpan'],
  force   => true,
}

Package Management

To avoid conflicts with in house package management, use:

class {'::cpan':
  manage_package => false,
}

Install Destination

To control target installation path, use:

class {'::cpan':
  installdirs => 'vendor',
}

Any of site (default), perl and vendor are accepted.

To further control the location of installed modules, you can use local::lib:

cpan { 'Foo::Bar':
  ensure    => present,
  local_lib => '/opt',
}

This will install the module into /opt. Of course you need to adjust @INC of your code in order to use that new location, e.g. by using perl -Mlocal::lib=/opt myapp.pl.

You can also define the default value of local_lib for all cpan resources:

Cpan { local_lib => '/opt' }

Reference

Classes

• cpan: Main class for installation and service management.
• cpan::install: Handles package installation.
• cpan::params: Different configuration data for different systems.
• cpan::config: Handles the cpan service.

Parameters

manage_config

manage_package

installdirs

local_lib

config_template

config_hash

package_ensure

Limitations

This module has been built on and tested against Puppet 3.x and Puppet 4.x

The module has been tested on:

• RedHat Enterprise Linux 6/7
• Debian 6/7
• CentOS 6/7

Testing on other platforms has been light and cannot be guaranteed.