Docs4dev
Docs
ansible / latest / collections / community / general / urpmi_module.html

community.general.urpmi – Urpmi manager

Note

This plugin is part of the community.general collection (version 3.8.1).

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.urpmi.

Synopsis

  • Manages packages with urpmi (such as for Mageia or Mandriva)

Parameters

Parameter Choices/Defaults Comments
force
boolean
    Choices:
  • no
  • yes ←
Assume "yes" is the answer to any question urpmi has to ask. Corresponds to the --force option for urpmi.
name
list / elements=string / required
A list of package names to install, upgrade or remove.

aliases: package, pkg
no_recommends
boolean
    Choices:
  • no
  • yes ←
Corresponds to the --no-recommends option for urpmi.
Alias no-recommends has been deprecated and will be removed in community.general 5.0.0.

aliases: no-recommends
root
string
Specifies an alternative install root, relative to which all packages will be installed. Corresponds to the --root option for urpmi.

aliases: installroot
state
string
    Choices:
  • absent
  • present ←
  • installed
  • removed
Indicates the desired package state.
update_cache
boolean
    Choices:
  • no ←
  • yes
Update the package database first urpmi.update -a.
Alias update-cache has been deprecated and will be removed in community.general 5.0.0.

aliases: update-cache

Examples

- name: Install package foo
  community.general.urpmi:
    pkg: foo
    state: present

- name: Remove package foo
  community.general.urpmi:
    pkg: foo
    state: absent

- name: Remove packages foo and bar
  community.general.urpmi:
    pkg: foo,bar
    state: absent

- name: Update the package database (urpmi.update -a -q) and install bar (bar will be the updated if a newer version exists)
- community.general.urpmi:
    name: bar
    state: present
    update_cache: yes

Authors

  • Philippe Makowski (@pmakowski)

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