ansible-role-common/README.md

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
```

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