diodonfrost.ohmyzsh
ansible-role-ohmyzsh
This role provide a compliance for install ohmyzsh on your target host.
Requirements
This role was developed using Ansible 2.8 Backwards compatibility is not guaranteed.
Use ansible-galaxy install diodonfrost.ohmyzsh to install the role on your system.
Supported platforms:
- name: EL
versions:
- 8
- 7
- 6
- name: Fedora
versions:
- any
- name: Debian
versions:
- buster
- stretch
- jessie
- wheezy
- squeeze
- name: Ubuntu
versions:
- bionic
- xenial
- trusty
- precise
- name: Amazon
versions:
- any
- name: opensuse
versions:
- any
- name: ArchLinux
versions:
- any
- name: Alpine
versions:
- any
- name: Gentoo
versions:
- any
- name: ClearLinux
versions:
- any
- name: FreeBSD
versions:
- any
- name: OpenBSD
versions:
- any
- name: MacOSX
versions:
- any
Role Variables
This role has multiple variables. The defaults for all these variables are the following:
---
# defaults file for ansible-role-ohmyzsh
# Install ohmyzsh for the defined users.
# Default: current ansible connection user
ohmyzsh_users: "{{ ansible_user_id }}"
# Setup the ohmyzsh theme to used
ohmyzsh_theme: robbyrussell
# Setup the ohmyzsh plugins to used
ohmyzsh_plugins:
- git
Dependencies
None
Example Playbook
This is a sample playbook file for deploying the Ansible Galaxy ohmyzsh role in a localhost and installing the latest version of ohmyzsh.
---
- hosts: localhost
roles:
- role: diodonfrost.ohmyzsh
This role can also configure ohmyzsh theme and plugins.
---
- hosts: localhost
roles:
- role: diodonfrost.ohmyzsh
vars:
ohmyzsh_theme: intheloop
ohmyzsh_plugins: "git,docker,systemd"
Local Testing
This project uses Molecule to aid in the development and testing.
To develop or test you'll need to have installed the following:
- Linux (e.g. Ubuntu)
- Docker
- Python (including python-pip)
- Ansible
- Molecule
- Libvirt (bsd test only)
- Vagrant (bsd test only)
Testing with Docker
# Test ansible role with centos-8
image=centos:8 molecule test
# Test ansible role with ubuntu-20.04
image=ubuntu:20.04 molecule test
# Test ansible role with alpine-latest
image=alpine:latest molecule test
# Create centos-7 instance
image=centos:7 molecule create
# Apply role on centos-7 instance
image=centos:7 molecule converge
# Launch tests on centos-7 instance
image=centos:7 molecule verify
Testing with Vagrant and Libvirt
# Test ansible role with FreeBSD
molecule test -s freebsd
# Test ansible role with OpenBSD
molecule test -s openbsd
License
Apache 2
Author Information
This role was created in 2020 by diodonfrost.
Install
ansible-galaxy install diodonfrost.ohmyzshLicense
apache-2.0
Downloads
3.1k
Owner
