1995parham's dotfiles Ansible role

Introduction

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.)

Requirements

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

Role Variables

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: [email protected]
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.

Example Playbook

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