Go to file
Jannik Beyerstedt 60adb8a9bb [TIDY] remove strategy free 2019-11-03 16:58:58 +01:00
defaults [FIX] add common_settingsonly flag to role as well 2019-10-31 18:29:35 +01:00
files [FIX] add common_settingsonly flag to role as well 2019-10-31 18:29:35 +01:00
handlers [GIT] refactor submodules: add all to own repo 2019-10-06 22:41:31 +02:00
meta [GIT] refactor submodules: add all to own repo 2019-10-06 22:41:31 +02:00
tasks [FIX] add common_settingsonly flag to role as well 2019-10-31 18:29:35 +01:00
vars [GIT] refactor submodules: add all to own repo 2019-10-06 22:41:31 +02:00
.gitmodules [FIX] use correct path for dotfiles 2019-10-06 23:49:41 +02:00
README.md [TIDY] remove strategy free 2019-11-03 16:58:58 +01:00

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

The User Setup will change the user shell and global gitconfig. This can be disabled:

  • usersetup_chsh: Boolean to disable changing the user shell to zsh
  • usersetup_gitconfig: Boolean to disable overriding the global gitconfig

For a GUI/ Desktop machine, you can enable to install and configure VS Code:

  • user_vscode: Boolean to install and set the basic configuration of VS Code
  • user_lang_cpp: Boolean to install C/C++ dev tools and configure VS Code
  • user_lang_python: Boolean to install Python dev tools and configure VS Code
  • user_lang_golang: Boolean to install Golang dev tools and configure VS Code

The user_lang_* switches will also install the language only, if user_vscode is set to false.

To install just the dotfiles, set common_settingsonly to true.

Dependencies

none

Example Playbook

You can simply run the whole role:

- name: Basic User Shell Setup
  hosts: all
  tasks:
  - name: Basics - Update first
    import_role:
      name: common
      tasks_from: update
    when: common_settingsonly | default(false) == false
  - name: Basics - Install essential tools
    import_role:
      name: common
      tasks_from: essentials
    when: common_settingsonly | default(false) == false
  - name: Basics - Install more tools
    import_role:
      name: common
      tasks_from: tools
    when: common_settingsonly | default(false) == false

  - name: Basics - Setup user shell
    import_role:
      name: common
      tasks_from: usersetup
    when: common_settingsonly | default(false) == false
  - name: Basics - Install dotfiles
    import_role:
      name: common
      tasks_from: usersettings

  # Additional Tasks for Specific Host Types (not included in the role's main.yml)

  # more tools for your main machine
  - name: Basics - Install user's working utilities
    import_role:
      name: common
      tasks_from: usertools

  # install programming languages and optionally VS Code
  - name: Basics - Install and configure VS Code
    import_role:
      name: common
      tasks_from: vscode

Or call the different tasks individually:

- name: Basic User Shell Setup
  hosts: all
  tasks:
  - import_role:
      name: common

License

GPLv3