ansible.builtin.package – Универсальный менеджер пакетов ОС

Примечание

Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля package, даже не указывая ключевое слово collections:. Несмотря на это, рекомендуется использовать полное имя FQCN для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Новое в версии 2.0: of ansible.builtin

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Этот модуль управляет пакетами на целевом узле без указания модуля менеджера пакетов (например, ansible.builtin.yum, ansible.builtin.apt, …). Он удобен в разнородной среде машин, без необходимости создания отдельной задачи для каждого менеджера пакетов. package вызовы за модулем для менеджера пакетов, используемого операционной системой, обнаруженной модулем ansible.builtin.setup. Если setup ещё не выполнялся, package выполнит его.
Этот модуль действует как прокси к модулю базового менеджера пакетов. Хотя все аргументы будут переданы базовому модулю, не все модули поддерживают одинаковые аргументы. Эта документация охватывает только минимальное пересечение аргументов модулей, которые поддерживают все модули управления пакетами.
Для целевых узлов Windows используйте модуль ansile.windows.win_package вместо этого.

Примечание

Этот модуль имеет соответствующий плагин действий.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

Всё, что требуется для плагинов пакетов, специфичных для каждой системы.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
name строка / обязательно		Имя пакета или спецификатор пакета с версией. Синтаксис варьируется в зависимости от менеджера пакетов. Например, `name-1.0` или `name=1.0`. Имена пакетов также различаются в зависимости от менеджера пакетов; этот модуль не будет их "переводить" в зависимости от дистрибутива. Например, `libyaml-dev`, `libyaml-devel`.
state строка / обязательно		Установка (`present`) или удаление (`absent`) пакета. Вы можете использовать другие состояния, такие как `latest`, ТОЛЬКО если они поддерживаются базовым(и) модулем(ями) пакета, который(е) выполняется(ются).
use строка	По умолчанию: "auto"	Требуемый модуль менеджера пакетов (`yum`, `apt` и так далее). Значение по умолчанию 'auto' будет использовать существующие факты или попытаться автоматически его определить. Вы должны использовать это поле только в том случае, если автоматический выбор по какой-то причине не работает.

Примечания

Примечание

Хотя package абстрагирует менеджеры пакетов, чтобы облегчить работу с несколькими дистрибутивами, имя пакета часто отличается для одного и того же программного обеспечения.

Примеры

- name: Install ntpdate
  ansible.builtin.package:
    name: ntpdate
    state: present

# This uses a variable as this changes per distribution.
- name: Remove the apache package
  ansible.builtin.package:
    name: "{{ apache }}"
    state: absent

- name: Install the latest version of Apache and MariaDB
  ansible.builtin.package:
    name:
      - httpd
      - mariadb-server
    state: latest

Авторы

Команда Ansible Core

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/package_module.html