ansible.builtin.pacman (v2.7.17) — module

Install Ansible via pip

Install with pip install ansible==2.7.17

Description

Manage packages with the I(pacman) package manager, which is used by Arch Linux and its variants.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Install package foo
  pacman:
    name: foo
    state: present

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Upgrade package foo
  pacman:
    name: foo
    state: latest
    update_cache: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Remove packages foo and bar
  pacman:
    name: foo,bar
    state: absent

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Recursively remove package baz
  pacman:
    name: baz
    state: absent
    recurse: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Run the equivalent of "pacman -Sy" as a separate step
  pacman:
    update_cache: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Run the equivalent of "pacman -Su" as a separate step
  pacman:
    upgrade: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Run the equivalent of "pacman -Syu" as a separate step
  pacman:
    update_cache: yes
    upgrade: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Run the equivalent of "pacman -Rdd", force remove package baz
  pacman:
    name: baz
    state: absent
    force: yes

Inputs

    
name:
    aliases:
    - package
    - pkg
    description:
    - Name or list of names of the packages to install, upgrade, or remove.

force:
    default: false
    description:
    - When removing package - force remove package, without any checks. When update_cache
      - force redownload repo databases.
    type: bool
    version_added: '2.0'
    version_added_collection: ansible.builtin

state:
    choices:
    - absent
    - latest
    - present
    default: present
    description:
    - Desired state of the package.

recurse:
    default: false
    description:
    - 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.
    type: bool
    version_added: '1.3'
    version_added_collection: ansible.builtin

upgrade:
    default: false
    description:
    - Whether or not to upgrade whole system.
    type: bool
    version_added: '2.0'
    version_added_collection: ansible.builtin

update_cache:
    aliases:
    - update-cache
    default: false
    description:
    - Whether or not to refresh the master package lists. This can be run as part of a
      package installation or as a separate step.
    type: bool

Outputs

packages:
  description: a list of packages that have been changed
  returned: when upgrade is set to yes
  sample:
  - package
  - other-package
  type: list