Parameter | Choices/Defaults | Comments |
---|---|---|
force bool (added in 2.0) |
| When removing package - force remove package, without any checks. When update_cache - force redownload repo databases. |
name | Name or list of names of the packages to install, upgrade, or remove. aliases: package, pkg | |
recurse bool (added in 1.3) |
| When removing a package, also remove its dependencies, provided that they are not required by other packages and were not explicitly installed by a user. |
state |
| Desired state of the package. |
update_cache bool |
| Whether or not to refresh the master package lists. This can be run as part of a package installation or as a separate step. aliases: update-cache |
upgrade bool (added in 2.0) |
| Whether or not to upgrade whole system. |
Note
loop:
each package will be processed individually, it is much more efficient to pass the list directly to the name
option.- name: Install package foo pacman: name: foo state: present - name: Upgrade package foo pacman: name: foo state: latest update_cache: yes - name: Remove packages foo and bar pacman: name: foo,bar state: absent - name: Recursively remove package baz pacman: name: baz state: absent recurse: yes - name: Run the equivalent of "pacman -Sy" as a separate step pacman: update_cache: yes - name: Run the equivalent of "pacman -Su" as a separate step pacman: upgrade: yes - name: Run the equivalent of "pacman -Syu" as a separate step pacman: update_cache: yes upgrade: yes - name: Run the equivalent of "pacman -Rdd", force remove package baz pacman: name: baz state: absent force: yes
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
packages list | when upgrade is set to yes | a list of packages that have been changed Sample: ['package', 'other-package'] |
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/pacman_module.html