Forge Home

cpan

Provides a puppet type to easily install Perl CPAN modules.

518,573 downloads

474,267 latest version

4.6 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 2.0.0 (latest)
  • 1.0.1
  • 1.0.0
  • 0.0.1
released Aug 12th 2016
This version is compatible with:
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'meltwater-cpan', '2.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add meltwater-cpan
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install meltwater-cpan --version 2.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

meltwater/cpan — version 2.0.0 Aug 12th 2016

puppet-cpan

Puppet Forge Version Puppet Forge Downloads Travis branch By Meltwater Maintenance license

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
  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.