ansible_role_oh_my_zsh
ansible-role-oh-my-zsh
Ansible role for installating and configuring zsh and oh-my-zsh
Requirements
Only test with ansible 2.5 min version
Role Variables
Available variables are listed below, along with default values (see defaults/main.yml):
Customize theme
# Default theme to load (included with oh-my-zsh)
# All included theme here : https://github.com/robbyrussell/oh-my-zsh/tree/master/themes
oh_my_zsh_default_theme: robbyrussell
# For a custom theme not present in $HOME/.oh-my-zsh/themes or in $HOME/.oh-my-zsh/custom/themes/ :
# 1. Fill oh_my_zsh_custom_theme_info
# - This theme will be checkout into directory $HOME/.oh-my-zsh/custom/custom-themes/
# oh_my_zsh_custom_theme_info: { url: "oh_my_zsh_custom_theme_git_url", dir_dest_name: "oh_my_zsh_custom_git_dir_name" }
# example :
oh_my_zsh_custom_theme_info: { url: "https://github.com/ptavares/zsh-themes.git", dir_dest_name: zsh-themes }
# 2. Choose the custom zsh theme name to load
# - A symlink will be created from $HOME/.oh-my-zsh/custom/custom-themes/oh_my_zsh_custom_theme_git_dir_name/oh_my_zsh_custom_theme_name to $HOME/.oh-my-zsh/custom/themes/
# oh_my_zsh_custom_theme: oh_my_zsh_custom_theme_name
# example :
oh_my_zsh_custom_theme: ptavares
# 3. Add extra theme configuration
# oh_my_zsh_custom_theme_config:
# - MY_CUSTOM_THEME_VAR1=value
# - MY_CUSTOM_THEME_VAR2=value2
Customize plugins
# Default plugins to load (included with oh-my-zsh installation)
# All included plugins here : https://github.com/robbyrussell/oh-my-zsh/tree/master/plugins
oh_my_zsh_default_plugins:
- git
# For custom plugins not present in $HOME/.oh-my-zsh/plugins or in $HOME/.oh-my-zsh/custom/plugins/ :
# 1. Fill oh_my_zsh_custom_plugins_info
# - Plugins will be checkout into directory $HOME/.oh-my-zsh/custom/custom-plugins/
# - A symlink will be created from $HOME/.oh-my-zsh/custom/custom-plugins/oh_my_zsh_custom_plugin_dir_name to $HOME/.oh-my-zsh/custom/plugins/
# oh_my_zsh_custom_plugins_info: { url: "oh_my_zsh_custom_plugin_git_url", dir_dest_name: "oh_my_zsh_custom_plugin_git_dir_name" }
# example :
oh_my_zsh_custom_plugins_info:
- { url: "https://github.com/junegunn/fzf.git", dir_dest_name : fzf }
- { url: "https://github.com/Treri/fzf-zsh.git", dir_dest_name: fzf-zsh }
- { url: "https://github.com/zsh-users/zsh-autosuggestions.git", dir_dest_name: zsh-autosuggestions }
- { url: "https://github.com/zdharma/fast-syntax-highlighting.git", dir_dest_name: fast-syntax-highlighting }
- { url: "https://github.com/chrissicool/zsh-bash.git", dir_dest_name: zsh-bash }
# 2. List all your custom plugins to load on startup zsh
# oh_my_zsh_custom_plugins:
# - oh_my_zsh_custom_plugin_1
# - oh_my_zsh_custom_plugin_2
# example :
oh_my_zsh_custom_plugins:
- fzf-zsh
- zsh-autosuggestions
- fast-syntax-highlighting
- zsh-bash
# 3. Extra plugin command
# Some plugins need extra command to run successfully
# oh_my_zsh_custom_plugins_command :
# - "oh_my_zsh_custom_plugins_command_1"
# - "oh_my_zsh_custom_plugins_command_2"
# exemple :
oh_my_zsh_custom_plugins_command :
- "$HOME/.oh-my-zsh/custom/plugins/fzf/install --all"
- "fast-theme safari"
Customize .zhrc with your owns entries
# Add here all entries you need to put in zhrc file, like alias for example
# oh_my_zsh_custom_zsh_entries:
# - "oh_my_zsh_custom_zsh_entries_1"
# - "oh_my_zsh_custom_zsh_entries_2"
# example:
oh_my_zsh_custom_zsh_entries:
- "# List only directories alias"
- "alias lsd='ls -l | grep \"^d\"'"
Dependencies
No dependencie
Example Playbook
- hosts: all
roles:
- role: ptavares.ansible_role_oh_my_zsh
Inside vars/main.yml
:
- Copy content of defaults/main.yml in your playbook's vars file.
- Customize it as you like (filling role's variables)
License
MIT
Install
ansible-galaxy install ptavares/ansible-role-oh-my-zsh
License
mit
Downloads
166
Owner