Ansible Role: dotfiles

This role installs dotfiles for UNIX/Linux systems.

GitHub	Version	Issues	Pull Requests	Downloads

Example Playbook

The following example is from molecule/default/converge.yml and is tested with each update.

---
- name: Converge
  hosts: all
  become: true

  pre_tasks:
    - name: Update apt cache.
      apt: update_cache=true cache_valid_time=600
      when: ansible_os_family == 'Debian'

  roles:
    - role: buluma.git
    - role: buluma.dotfiles

To prepare your machine, CI uses molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  gather_facts: false
  become: true

  tasks:
    - name: Update Package Cache (apt/Ubuntu)
      tags: always
      apt:
        update_cache: yes
      changed_when: false
      when: ansible_distribution == "Ubuntu"

    - name: Update Package Cache (dnf/CentOS)
      tags: always
      dnf:
        update_cache: yes
      changed_when: false
      when: ansible_distribution == "CentOS"

    - name: Update Package Cache (yum/Amazon)
      tags: always
      yum:
        update_cache: yes
      changed_when: false
      when: ansible_distribution == "Amazon"

  roles:
    - role: buluma.bootstrap
    # - role: buluma.git

For a detailed explanation and more examples, check out this guide on how to utilize these roles.

Role Variables

Default variable values are found in defaults/main.yml:

---
dotfiles_repo: "https://github.com/buluma/dotfiles.git"
dotfiles_repo_version: master
dotfiles_repo_accept_hostkey: false
dotfiles_repo_local_destination: "~/Documents/dotfiles"

dotfiles_home: "~"
dotfiles_files:
  - .zshrc
  - .gitignore
  - .inputrc
  - .vimrc

Requirements

• You need to install the pip packages listed in requirements.txt.

Used Roles

The following roles help to prepare your system. You can use different methods for preparation.

Requirement	GitHub	Version
buluma.bootstrap
buluma.git

Context

This role works alongside many other roles. To learn more, check out the documentation of these roles.

Compatibility

This role has been tested on several container images:

You need at least Ansible version 2.2. Tests have been done on:

• The previous version,
• The current version,
• The development version.

If you encounter any issues, please report them on GitHub.

Changelog

For a history of changes, see Role History.

License

The license for this role is Apache-2.0.

Author Information

This role was created by Shadow Walker.