ansible-role-common/README.md
2019-10-14 08:47:22 +02:00

83 lines
1.6 KiB
Markdown

Common
=========
Common user settings and tools used by Jannik Beyerstedt.
This role is compatible with Debian based systems and macOS.
Requirements
------------
none
Role Variables
--------------
This role uses the apt package manager on Debian based hosts.
But for some operating systems the `ansible_os_family` variable is not set to "Debian" by the fact gathering even if it is Debian based (like Mendel GNU/Linux on the Google Coral Dev Board).
- `override_os_family`: Set to "Debian" in the host inventory, if `ansible_os_family` is not set correctly
Dependencies
------------
none
Example Playbook
----------------
You can simply run the whole role:
```yml
- name: Basic User Shell Setup
hosts: all
strategy: free
tasks:
- name: Basics - Update first
import_role:
name: common
tasks_from: update
- name: Basics - Install essential tools
import_role:
name: common
tasks_from: essentials
- name: Basics - Install more tools
import_role:
name: common
tasks_from: tools
- name: Basics - Setup user shell
import_role:
name: common
tasks_from: usersetup
- name: Basics - Install dotfiles
import_role:
name: common
tasks_from: usersettings
# just for you main machine
- name: Basics - Install dotfiles
import_role:
name: common
tasks_from: usertools
```
Or call the different tasks individually:
```yml
- name: Basic User Shell Setup
hosts: all
strategy: free
tasks:
- name: Basics - Update first
roles:
- common
```
License
-------
GPLv3