mirror of https://github.com/kewlfft/ansible-aur
ansiblearchlinuxauraur-builderaur-helperaur-helpersgalaxyhelpermakepkgpacaurpackage-managerpacmanyay
4602169292 | ||
---|---|---|
LICENSE | ||
README.md | ||
aur.py |
README.md
Ansible AUR package manager
Ansible module to use some AUR helpers. The following helpers are supported and automatically selected following the below order:
Options
parameter | required | default | choices | comments |
---|---|---|---|---|
name | no | Name or list of names of the package(s) to install or upgrade. | ||
upgrade | no | no | yes, no | Whether or not to upgrade whole system. |
use | no | auto | auto, pacaur, trizen, yaourt, yay | The helper to use, 'auto' uses the first known helper found. |
Note
Either name or upgrade is required, both can not be used together.
Installing
- Clone the ansibe-aur repository in your playbook custom-module directory:
mkdir --parents library
git clone git@github.com:kewlfft/ansible-aur.git library/ansible-aur
- Link the script to
library/aur
:
ln --symbolic library/ansible-aur/aur.py library/aur
Usage
Warning
- It is recommended to use the official pacman module for removal or for system upgrade with the repositories, this module aims to cover the AUR,
- Searches are limited to the AUR using the --aur parameter, except for yay and yaourt which do not support it and systematically search the repositories,
- A package is reinstalled only if an update is available using the --needed parameter, except for yay which do not support it and systematically reinstalls,
Examples
Use it in a task, as in the following examples:
# Install (using the first known helper found)
- aur: name=package_name
become: yes
become_user: user_that_has_nopasswd_in_sudoers_for_pacman_use
# Install (using trizen)
- aur:
use: trizen
name:
- package_name_1
- package_name_2
[...]
# Upgrade (using pacaur)
- aur: upgrade=yes use=pacaur
[...]