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

Note

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

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.

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 (e.g. different editors).

Requirements

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

  • update-alternatives

Parameters

Parameter

Comments

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 / required

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

priority

integer

The priority of the alternative.

Default: 50

state

string

added in 4.8.0 of community.general

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.

Choices:

  • present

  • selected ← (default)

Examples

- 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

Authors

  • David Wittman (@DavidWittman)

  • Gabe Mulley (@mulby)