ansible.builtin.package – Общий менеджер пакетов ОС
Примечание
Этот модуль входит в состав ansible-base и включен во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля package, даже не указывая ключевое слово collections:. Тем не менее, мы рекомендуем использовать полное имя класса (FQCN) для удобной ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же самое имя модуля.
Добавлено в версии 2.0: of ansible.builtin
Обзор
- Устанавливает, обновляет и удаляет пакеты с помощью базового менеджера пакетов ОС.
- Для целевых систем Windows используйте модуль ansible.windows.win_package вместо этого.
Примечание
Этот модуль имеет соответствующий плагин действий.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- Все необходимые для этого компоненты, специфичные для плагинов пакетов каждой системы.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| name строка / обязательно | Имя пакета или спецификатор пакета с версией. Синтаксис варьируется в зависимости от менеджера пакетов. Например name-1.0 или name=1.0.Имена пакетов также различаются в зависимости от менеджера пакетов; этот модуль не будет их «переводить» в зависимости от дистрибутива. Например libyaml-dev, libyaml-devel. | |
| state строка / обязательно | Устанавливать ( present) или удалять (absent) пакет.Вы можете использовать другие состояния, такие как latest, ТОЛЬКО если они поддерживаются базовыми модулями пакета (ов), выполняемыми на целевой машине. | |
| use строка | Значение по умолчанию: "auto" | Требуемый модуль менеджера пакетов (yum, apt и т. д.). По умолчанию 'auto' будет использовать существующие факты или попытаться определить его автоматически. Вы должны использовать это поле только в случае, если автоматический выбор по какой-то причине не работает. |
Примечания
Примечание
- Этот модуль фактически вызывает соответствующие модули пакетов для каждой системы (apt, yum и т. д.).
- Для целевых систем Windows используйте модуль ansible.windows.win_package вместо этого.
Примеры
- name: Install ntpdate
package:
name: ntpdate
state: present
# This uses a variable as this changes per distribution.
- name: Remove the apache package
package:
name: "{{ apache }}"
state: absent
- name: Install the latest version of Apache and MariaDB
package:
name:
- httpd
- mariadb-server
state: latest
Авторы
- Команда разработчиков Ansible
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/builtin/package_module.html
