community.general.alternatives module – Manages alternative programs for common commands

Note

This module is part of the community.general collection (version 11.4.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: community.general.alternatives.

Synopsis

  • Manages symbolic links using the update-alternatives tool.

  • Useful when multiple programs are installed but provide similar functionality (for example, different editors).

Requirements

The below requirements are needed on the host that executes this module.

  • update-alternatives

Parameters

Parameter

Comments

family

string

added in community.general 10.1.0

The family groups similar alternatives. This option is available only on RHEL-based distributions.

path

The path to the symbolic link that should point to the real executable.

This option is always required on RHEL-based distributions. On Debian-based distributions this option is required when the alternative name is unknown to the system.

name

string / required

The generic name of the link.

path

path

The path to the real executable that the link should point to.

priority

integer

The priority of the alternative. If no priority is given for creation 50 is used as a fallback.

state

string

added in community.general 4.8.0

present - install the alternative (if not already installed), but do not set it as the currently selected alternative for the group.

selected - install the alternative (if not already installed), and set it as the currently selected alternative for the group.

auto - install the alternative (if not already installed), and set the group to auto mode. Added in community.general 5.1.0.

absent - removes the alternative. Added in community.general 5.1.0.

Choices:

  • "present"

  • "selected" ← (default)

  • "auto"

  • "absent"

subcommands

aliases: slaves

list / elements=dictionary

added in community.general 5.1.0

A list of subcommands.

Each subcommand needs a name, a link and a path parameter.

Subcommands are also named slaves or followers, depending on the version of alternatives.

path / required

The path to the symbolic link that should point to the real subcommand executable.

name

string / required

The generic name of the subcommand.

path

path / required

The path to the real executable that the subcommand should point to.

Attributes

Attribute

Support

Description

check_mode

Support: full

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: full

Returns details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Examples

- name: Correct java version selected  community.general.alternatives:  name: java  path: /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java - name: Select java-11-openjdk.x86_64 family  community.general.alternatives:  name: java  family: java-11-openjdk.x86_64  when: ansible_os_family == 'RedHat' - 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

Authors

  • Marius Rieder (@jiuka)

  • David Wittman (@DavidWittman)

  • Gabe Mulley (@mulby)