package_facts – информация о пакетах в виде фактов
Новое в версии 2.5.
Обзор
- Возвращает информацию об установленных пакетах в виде фактов
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Для поддержки ‘portage’ требуется утилита
qlist, которая входит в пакет ‘app-portage/portage-utils’. - Для систем на базе Debian пакет
python-aptдолжен быть установлен на целевых хостах.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| manager список |
["auto"] | Установленный менеджер пакетов системы для запроса информации о пакетах. Начиная с версии 2.8, это список, поддерживающий несколько менеджеров пакетов на одной системе. Опции 'portage' и 'pkg' были добавлены в версии 2.8. |
| strategy - добавлен в 2.8 |
| Данный параметр управляет способом запроса менеджеров пакетов на системе. first означает, что будут возвращены только данные для первого поддерживаемого менеджера пакетов. all означает, что будут возвращены данные для всех поддерживаемых и доступных менеджеров пакетов на системе. |
Примеры
- name: Gather the rpm package facts
package_facts:
manager: auto
- name: Print the rpm package facts
debug:
var: ansible_facts.packages
- name: Check whether a package called foobar is installed
debug:
msg: "{{ ansible_facts.packages['foobar'] | length }} versions of foobar are installed!"
when: "'foobar' in ansible_facts.packages"
Возвращаемые факты
Возвращаемые этим модулем факты добавляются/обновляются в факты хоста hostvars и могут быть использованы по имени, как и другие факты хоста. Их не нужно регистрировать, чтобы использовать их.
| Факт | Возвращается | Описание | |
|---|---|---|---|
| packages словарь | при указании менеджера пакетов уровня операционной системы или автоматическом обнаружении менеджера | Сопоставляет имя пакета с непустым списком словарей с информацией о пакете. Каждый словарь в списке соответствует одной установленной версии пакета. Поля, описанные ниже, присутствуют для всех менеджеров пакетов. В зависимости от менеджера пакетов, могут быть дополнительные поля для пакета. Пример: { "packages": { "kernel": [ { "name": "kernel", "source": "rpm", "version": "3.10.0", ... }, { "name": "kernel", "source": "rpm", "version": "3.10.0", ... }, ... ], "kernel-tools": [ { "name": "kernel-tools", "source": "rpm", "version": "3.10.0", ... } ], ... } } | |
| name строка | всегда | Имя пакета. | |
| source строка | всегда | Источник информации о пакете. | |
| version строка | всегда | Версия пакета. | |
Статус
- Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Matthew Jones (@matburt)
- Brian Coca (@bcoca)
- Adam Miller (@maxamillion)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/package_facts_module.html