This role installs the Parham Alvani's dotfiles from its source. It also installs the required packages, vim plugins, etc.
The following modules are configured with install.sh
:
zsh
,vim
,tmux
dircolors
wakatime
git
- bash and python scripts (
owghat
,rename
, etc.)
This role depends on community.general collection and there is no way for setting this in role metadata, so you need to install it manually.
ansible-galaxy collection install community.general
dotfiles_home
specifies the directory for dotfiles. Please note that all configurations are softly linked to this location, so you need
to re-run this role in case of dotfiles_home
change.
dotfiles_home: $HOME/Documents/dotfiles
git_email
and git_name
contains the user email and name for the git. They are useful if you want to commit anything from your target.
git_email: parham.alvani@gmail.com
git_name: "Parham Alvani"
github_keys_username
is using for fetching trusted keys from GitHub, by default it fetches 1995parham keys, so you must update it.
Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
# playbook.yml
- hosts: servers
roles:
- { role: 1995parham-me, vars: { dotfiles_home: $HOME/Documents/dotfiles } }
# requirements.yml
- src: https://github.com/1995parham-me/ansible-role.git
scm: git
version: main
name: 1995parham-me