48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
|
# Ansible Role: Packages
|
||
|
|
|
||
|
|
[](https://travis-ci.org/brentwg/ansible-role-packages)
|
||
|
|
|
||
|
|
A simple Ansible role used to install, remove, and update distrobution base repository software packages.
|
||
|
|
|
||
|
|
(No feature currently exists for enabling additional, third-party repositories.)
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
Ansible minimum version: 2.4
|
||
|
|
|
||
|
|
## Role Variables
|
||
|
|
Available default values are listed below (See `defaults/main.yml`):
|
||
|
|
```
|
||
|
|
# for software package updates
|
||
|
|
install_all_package_updates: true
|
||
|
|
|
||
|
|
# list of packages to install
|
||
|
|
install_packages: []
|
||
|
|
|
||
|
|
# list of packages to remove
|
||
|
|
remove_packages: []
|
||
|
|
|
||
|
|
# list of packages to update
|
||
|
|
update_packages: []
|
||
|
|
|
||
|
|
```
|
||
|
|
Set `install_all_package_updates` to `true` to enable the automated installation of all software package updates. Set it to `false` to disable all updates.
|
||
|
|
|
||
|
|
`install_packages`, `remove_packages`, and `update_packages` expect to receive a list of package names that are specific to whichever Linux distribution you are running.
|
||
|
|
|
||
|
|
**NOTE**: If you've already set `install_all_package_updates` to `true`, then there is naturally no requirement to redundantly list additional packages in `update_packages`; however, program logic would still allow this (since there is *probably* no harm done).
|
||
|
|
## Dependencies
|
||
|
|
None.
|
||
|
|
|
||
|
|
## Example Playbook
|
||
|
|
```
|
||
|
|
- hosts: all
|
||
|
|
|
||
|
|
vars:
|
||
|
|
install_all_package_updates: true
|
||
|
|
install_packages:
|
||
|
|
- vim-enhanced
|
||
|
|
|
||
|
|
roles:
|
||
|
|
- brentwg.packages
|
||
|
|
```
|