ansible-role-common/README.md

# Common [![status-badge](https://hub.cybercinch.nz/cybercinch/ansible-role-common/actions/workflows/ci.yml/badge.svg)](https://hub.cybercinch.nz/cybercinch/ansible-role-common/actions?workflow=ci.yml)
=========

This role is a collection of functionality to ease common setup of Linux based VM's. Some functionality for windows servers is available.

Features:
* Dynamic motd - This displays information to administrators at login.
* Helper commands - These are commands to help with online resizing of Linux Partitions/Drives when running on VMWare.
* Set DNS resolvers for use on the host.
* Install common packages for the host (Win/Linux)

Requirements 
------------

Nil

Role Variables
--------------

Role variables can be found in defaults/main.yml

```yaml
domain: exampledomain.com
ad_domain_joined: no
win_timezone: New Zealand Standard Time
vendors_hosts: []

dns_servers:
  - 1.0.0.1
  - 1.1.1.1

admin_group: admins


common_grub_timeout: 5
postfix_configure: false

common_packages: # Packages we will/would like to install
  - nano
  - git
  - htop
  - atop
  - wget
  - bind-utils
  - yum-utils
  - unzip

win_packages:
  - notepadplusplus.install
  - firefoxesr
  - baretail
  - 7zip.install

apply_win_updates: false

common_show_ipv6: false|bool
common_root_pwd: $y0urp@$$ ## You should always use a vault encrypted string here.
common_root_email: admin@somplace.co.nz # Configures forwarding address for root.
```

Dependencies
------------

Nil external dependencies.  Requires only builtin functions

Example Playbook
----------------

This is an example playbook.  Executes the role overriding two variables. 

You could alternately set these in host_vars or group_vars:

```yaml
    - hosts: server
      roles:
         - { role: cybercinch.common, 
             common_show_ipv6: true,
             common_root_email: iamroot@example.com }
```

License
-------

MIT

Author Information
------------------

This role was created in 2017 by [Aaron Guise](https://guise.net.nz/)