fourforbusiness.oh-my-zsh

Ansible Role: Oh-My-Zsh

Role to download, install and configure Oh-My-Zsh.

Requirements

Ansible >= 1.9
Linux Distribution
- Debian Family
  - Debian
    - Wheezy (7)
    - Jessie (8)
  - Ubuntu
    - Trusty (14.04)
    - Wily (15.10)
    - Xenial (16.04)
- RedHat Family
  - CentOS
    - 7
  - Fedora
    - 25
- SUSE Family
  - OpenSUSE
    - 42.2
- Note: other versions are likely to work but have not been tested.

Role Variables

The following variable will change the behavior of this role (default values are shown below):

# Default theme
oh_my_zsh_theme: robbyrussell

# Default plugins
oh_my_zsh_plugins:
  - git

# User configuration
# Important: oh-my-zsh is installed per user so you need to specify the users to install it for.
users:
  - username: example1
    oh_my_zsh:
      theme: robbyrussell
      plugins:
        - git
  - username: example2
    oh_my_zsh:
      theme: robbyrussell
      plugins:
        - git
        - mvn

Example Playbook

- hosts: servers
  roles:
    - role: gantsign.oh-my-zsh
      users:
        - username: example

More Roles From GantSign

You can find more roles from GantSign on Ansible Galaxy.

Development & Testing

This project uses Molecule to aid in the development and testing; the role is unit tested using Testinfra and pytest.

To develop or test you'll need to have installed the following:

Linux (e.g. Ubuntu)
Docker
Python (including python-pip)
Ansible
Molecule

To run the role (i.e. the tests/test.yml playbook), and test the results (tests/test_role.py), execute the following command from the project root (i.e. the directory with molecule.yml in it):