cpanm – Manages Perl library dependencies

From Get docs
Ansible/docs/2.8/modules/cpanm module


cpanm – Manages Perl library dependencies

Synopsis

  • Manage Perl library dependencies.

Parameters

Parameter Choices/Defaults Comments

executable

path

added in 2.1

Override the path to the cpanm executable

from_path

-

The local directory from where to install

installdeps

boolean

added in 2.0

  • no

  • yes

Only install dependencies

locallib

path

Specify the install base to install modules

mirror

string

Specifies the base URL for the CPAN mirror to use

mirror_only

boolean

  • no

  • yes

Use the mirror's index file instead of the CPAN Meta DB

name

-

The name of the Perl library to install. You may use the "full distribution path", e.g. MIYAGAWA/Plack-0.99_05.tar.gz


aliases: pkg

notest

boolean

  • no

  • yes

Do not run unit tests

system_lib

boolean

added in 2.0

  • no

  • yes

Use this if you want to install modules to the system perl include path. You must be root or have "passwordless" sudo for this to work.

This uses the cpanm commandline option '--sudo', which has nothing to do with ansible privilege escalation.


aliases: use_sudo

version

string

added in 2.1

minimum version of perl module to consider acceptable



Notes

Note


Examples

# install Dancer perl package
- cpanm:
    name: Dancer

# install version 0.99_05 of the Plack perl package
- cpanm:
    name: MIYAGAWA/Plack-0.99_05.tar.gz

# install Dancer into the specified locallib
- cpanm:
    name: Dancer
    locallib: /srv/webapps/my_app/extlib

# install perl dependencies from local directory
- cpanm:
    from_path: /srv/webapps/my_app/src/

# install Dancer perl package without running the unit tests in indicated locallib
- cpanm:
    name: Dancer
    notest: True
    locallib: /srv/webapps/my_app/extlib

# install Dancer perl package from a specific mirror
- cpanm:
    name: Dancer
    mirror: 'http://cpan.cpantesters.org/'

# install Dancer perl package into the system root path
- cpanm:
    name: Dancer
    system_lib: yes

# install Dancer if it's not already installed
# OR the installed version is older than version 1.0
- cpanm:
    name: Dancer
    version: '1.0'

Status

Authors

  • Franck Cuny (@fcuny)

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/cpanm_module.html