perl Cookbook

Manages Perl installation and provides cpan_module, to install modules from... CPAN.

Requirements

Platforms

• Debian/Ubuntu/Mint
• RHEL/CentOS/Scientific/Amazon/Oracle
• Fedora
• ArchLinux
• Windows

Chef

• Chef 11+

Cookbooks

• windows

Attributes

• perl['packages'] - platform specific packages installed by default recipe
• perl['cpanm']['path'] - platform specific path for cpanm binary to live
• perl['cpanm']['url'] - URL to download cpanm script from
• perl['cpanm']['checksum'] - checksum for the above remote file

Usage

To install a module from CPAN:

cpan_module 'App::Munchies'

Optionally, installation can forced with the 'force' parameter.

cpan_module 'App::Munchies'
  force true
end

You can also use cpanm's version mechanism to grab a specific version, or glob a version.

Exactly version 1.01 of App::Munchies will be installed:

cpan_module 'App::Munchies'
  version '== 1.01'
end

At least version 1.01 of App::Munchies will be installed:

cpan_module 'App::Munchies'
  version '1.01'
end

At least version 1.01 will be installed, but not version 2:

cpan_module 'App::Munchies'
  version '>= 1.01, < 2.0'
end

Additionally, you can use the cpan_module LWRP to delete a given package (uses cpanm's --uninstall param)

cpan_module 'App::Munchies'
  action :uninstall
end

License & Authors

Author: Cookbook Engineering Team (cookbooks@chef.io)

Copyright: 2009-2015, Chef Software, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.