Модуль community.general.alternatives — Управление альтернативными программами для общих команд

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования, см. Требования для подробностей.

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

Описание
Требования
Параметры
Атрибуты
Примеры

Описание

Управление символическими ссылками с помощью инструмента ‘update-alternatives’.
Полезно, когда установлено несколько программ, предоставляющих похожие функции (например, различные редакторы).

Требования

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

update-alternatives

Параметры

Параметр	Комментарии
link путь	Путь к символической ссылке, которая должна указывать на реальный исполняемый файл. Этот параметр всегда обязателен для дистрибутивов на основе RHEL. В дистрибутивах на основе Debian этот параметр обязателен, когда альтернатива `name` неизвестна системе.
name строка / обязательно	Общее имя ссылки.
path путь / обязательно	Путь к реальному исполняемому файлу, на который должна указывать ссылка.
priority целое число	Приоритет альтернативы. Если приоритет не задан при создании, `50` используется по умолчанию.
state строка добавлен в community.general 4.8.0	`present` — установить альтернативу (если она еще не установлена), но не назначать ее текущей для группы. `selected` — установить альтернативу (если она еще не установлена) и назначить ее текущей для группы. `auto` — установить альтернативу (если она еще не установлена) и установить режим группы в автоматический. Добавлен в community.general 5.1.0. `absent` — удаляет альтернативу. Добавлен в community.general 5.1.0. Варианты: `"present"` `"selected"` ← (по умолчанию) `"auto"` `"absent"`
подкоманды алиасы: slaves список / элементы=словарь добавлен в community.general 5.1.0	Список подкоманд. Для каждой подкоманды необходимо указать параметры name, link и path. Подкоманды также называются ‘slaves’ или ‘followers’, в зависимости от версии alternatives.
link путь / обязательно	Путь к символической ссылке, которая должна указывать на реальный исполняемый файл подкоманды.
name строка / обязательно	Общее имя подкоманды.
path путь / обязательно	Путь к реальному исполняемому файлу, на который должна указывать подкоманда.

Атрибуты

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

Примеры

- name: Correct java version selected
  community.general.alternatives:
    name: java
    path: /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java

- name: Alternatives link created
  community.general.alternatives:
    name: hadoop-conf
    link: /etc/hadoop/conf
    path: /etc/hadoop/conf.ansible

- name: Make java 32 bit an alternative with low priority
  community.general.alternatives:
    name: java
    path: /usr/lib/jvm/java-7-openjdk-i386/jre/bin/java
    priority: -10

- name: Install Python 3.5 but do not select it
  community.general.alternatives:
    name: python
    path: /usr/bin/python3.5
    link: /usr/bin/python
    state: present

- name: Install Python 3.5 and reset selection to auto
  community.general.alternatives:
    name: python
    path: /usr/bin/python3.5
    link: /usr/bin/python
    state: auto

- name: keytool is a subcommand of java
  community.general.alternatives:
    name: java
    link: /usr/bin/java
    path: /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java
    subcommands:
      - name: keytool
        link: /usr/bin/keytool
        path: /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/keytool

Авторы

Marius Rieder (@jiuka)
David Wittman (@DavidWittman)
Gabe Mulley (@mulby)

Ссылки на коллекцию

© 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/alternatives_module.html