mirror of
https://gitlab.com/dbrw/ansible-setup.git
synced 2025-08-05 00:05:46 +07:00
51 lines
1.7 KiB
Markdown
51 lines
1.7 KiB
Markdown
# ansible-aur
|
|
|
|
An Ansible module for installing [AUR](https://aur.archlinux.org/) packages.
|
|
|
|
If [cower](https://github.com/falconindy/cower) is available, it will be used to download packages. Otherwise, cURL will be used. Packages are installed via [makepkg](https://wiki.archlinux.org/index.php/Makepkg).
|
|
|
|
## Dependencies (Managed Node)
|
|
|
|
* [Arch Linux](https://www.archlinux.org/) (Obviously)
|
|
* [cower](https://github.com/falconindy/cower) (Optional)
|
|
|
|
## Installation
|
|
|
|
1. Clone this repo
|
|
2. Copy or link the `aur` file into your global Ansible library (usually `/usr/share/ansible`) or into the `./library` folder alongside your top-level playbook
|
|
|
|
## Usage
|
|
|
|
### Options
|
|
|
|
* `name` - required, name of the AUR package to install
|
|
* `user` - required, name of the user you want to install the package as
|
|
* `dir` - optional, name of the directory you want to download AUR packages into. If this is left blank, the module will try to use `~/aur` for the specified user.
|
|
* `skip_pgp` - optional, whether makepkg should skip verification of PGP signatures of source files. Defaults to false. This may be useful when installing packages on a target node with no keyring established.
|
|
|
|
### Examples
|
|
|
|
```yaml
|
|
# Install package foo
|
|
- aur: name=foo user=someone
|
|
|
|
# Install package foo with a specific download directory
|
|
- aur: name=foo dir=/opt/packages/aur user=someone
|
|
|
|
# Install package foo without checking PGP signature
|
|
- aur: name=foo user=someone skip_pgp=yes
|
|
|
|
```
|
|
|
|
If you wouldn't like to install AUR packages by normal user, you can create a system user `aurman` (or another one which you like) as AUR manager:
|
|
|
|
```yaml
|
|
- name: New user for AUR management
|
|
user:
|
|
name: aurman
|
|
comment: "AUR manager"
|
|
shell: /bin/nologin
|
|
home: /var/lib/aurman
|
|
system: yes
|
|
```
|