You've already forked ansible-role-common
90 lines
2.0 KiB
Markdown
90 lines
2.0 KiB
Markdown
# Common [](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/)
|