Модуль community.general.cpanm – Управление зависимостями библиотек Perl

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, запустите ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать его в книге задач, укажите: community.general.cpanm.

Описание
Параметры
Атрибуты
Примечания
См. также
Примеры

Описание

Управление зависимостями библиотек Perl с помощью cpanminus.

Параметры

Параметр	Комментарии
executable путь	Переопределяет путь к исполняемому файлу cpanm.
from_path путь	Локальный каталог или `tar.gz` файл для установки.
installdeps логическое значение	Устанавливать только зависимости. Варианты: `false` ← (по умолчанию) `true`
locallib путь	Указывает базовый каталог для установки модулей.
mirror строка	Указывает базовый URL-адрес зеркала CPAN для использования.
mirror_only логическое значение	Использовать файл индекса зеркала вместо базы данных метаданных CPAN. Варианты: `false` ← (по умолчанию) `true`
mode строка добавлен в community.general 3.0.0	Управляет поведением модуля. Более подробные сведения см. в примечаниях ниже. По умолчанию изменено с `compatibility` на `new` в community.general 9.0.0. Варианты: `"compatibility"` `"new"` ← (по умолчанию)
имя псевдонимы: pkg строка	Устанавливаемая библиотека Perl. Допустимые значения меняются в зависимости от `mode`, см. примечания для получения более подробной информации. Обратите внимание, что для установки из локального каталога следует использовать параметр `from_path`.
name_check строка добавлен в community.general 3.0.0	Когда `mode=new`, этот параметр может использоваться для проверки наличия установленного модуля `name` (по указанному пути `version`).
notest логическое значение	Не запускать модульные тесты. Варианты: `false` ← (по умолчанию) `true`
version строка	Указание версии модуля Perl. При `mode` равно `new`, допустимы операторы версии `cpanm`.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Модуль может работать в режиме `check_mode` и возвращать прогноз о состоянии изменения, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме сравнения модуль вернёт информацию о внесённых изменениях (или, возможно, требуемых изменениях в `check_mode`) .

Примечания

Примечание

Обратите внимание, что http://search.cpan.org/dist/App-cpanminus/bin/cpanm, cpanm должен быть установлен на удалённом хосте.
Теперь этот модуль имеет возможность выбора режима выполнения mode: compatibility или new.
mode=compatibility: При использовании режима compatibility модуль сохраняет обратную совместимость. Это был режим по умолчанию до community.general 9.0.0. name должен быть либо именем модуля, либо файлом дистрибутива. Если модуль Perl, заданный name, установлен (по точному version), то ничего не происходит. В противном случае он будет установлен с помощью исполняемого файла cpanm . name не может быть URL-адресом или URL-адресом Git. cpanm спецификаторы версий в этом режиме не работают.
mode=new: При использовании режима new модуль будет вести себя по-другому. Параметр name может ссылаться на имя модуля, файл дистрибутива, URL HTTP или URL Git-репозитория, как описано в документации cpanminus. cpanm спецификаторы версий распознаются. Это режим по умолчанию начиная с community.general 9.0.0.

См. также

Справочная страница команды cpanm: Справочная страница команды.

END_OF_DOCUMENT_MARKER

Примеры

---
- name: Install Dancer perl package
  community.general.cpanm:
    name: Dancer

- name: Install version 0.99_05 of the Plack perl package
  community.general.cpanm:
    name: MIYAGAWA/Plack-0.99_05.tar.gz

- name: Install Dancer into the specified locallib
  community.general.cpanm:
    name: Dancer
    locallib: /srv/webapps/my_app/extlib

- name: Install perl dependencies from local directory
  community.general.cpanm:
    from_path: /srv/webapps/my_app/src/

- name: Install Dancer perl package without running the unit tests in indicated locallib
  community.general.cpanm:
    name: Dancer
    notest: true
    locallib: /srv/webapps/my_app/extlib

- name: Install Dancer perl package from a specific mirror
  community.general.cpanm:
    name: Dancer
    mirror: 'http://cpan.cpantesters.org/'

- name: Install Dancer perl package into the system root path
  become: true
  community.general.cpanm:
    name: Dancer

- name: Install Dancer if it is not already installed OR the installed version is older than version 1.0
  community.general.cpanm:
    name: Dancer
    version: '1.0'

Авторы

Franck Cuny (@fcuny)
Alexei Znamensky (@russoz)

Ссылки на сборник

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/cpanm_module.html