Added package role

roles/packages/README.md

@@ -0,0 +1,47 @@
+# Ansible Role: Packages
+
+[![Build Status](https://travis-ci.org/brentwg/ansible-role-packages.svg?branch=master)](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
+```