https://github.com/geerlingguy/ansible-role-dotfiles

Ansible Role - Easy and flexible dotfile installation.
https://github.com/geerlingguy/ansible-role-dotfiles

ansible configuration development dotfiles role

Last synced: 2 days ago
JSON representation

Ansible Role - Easy and flexible dotfile installation.

• Host: GitHub
• URL: https://github.com/geerlingguy/ansible-role-dotfiles
• Owner: geerlingguy
• License: mit
• Created: 2015-01-03T04:55:38.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2024-07-16T19:21:23.000Z (4 months ago)
• Last Synced: 2024-10-10T04:06:31.318Z (25 days ago)
• Topics: ansible, configuration, development, dotfiles, role
• Homepage: https://galaxy.ansible.com/geerlingguy/dotfiles/
• Size: 33.2 KB
• Stars: 233
• Watchers: 7
• Forks: 104
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-list-ansible - ansible-role-dotfiles - Easy and flexible dotfile installation. (role)

README

        
# Ansible Role: Dotfiles

[![CI](https://github.com/geerlingguy/ansible-role-dotfiles/workflows/CI/badge.svg?event=push)](https://github.com/geerlingguy/ansible-role-dotfiles/actions?query=workflow%3ACI)

Installs a set of dotfiles from a given Git repository. By default, it will install my (geerlingguy's) [dotfiles](https://github.com/geerlingguy/dotfiles), but you can use any set of dotfiles you'd like, as long as they follow a conventional format.

## Requirements

Requires `git` on the managed machine (you can easily install it with `geerlingguy.git` if required).

## Role Variables

Available variables are listed below, along with default values (see `defaults/main.yml`):

    dotfiles_repo: "https://github.com/geerlingguy/dotfiles.git"

    dotfiles_repo_version: master

The git repository and branch/tag/commit hash to use for retrieving dotfiles. Dotfiles should generally be laid out within the root directory of the repository.

    dotfiles_repo_accept_hostkey: false

Add the hostkey for the repo url if not already added. If ssh_opts contains "-o StrictHostKeyChecking=no", this parameter is ignored.

    dotfiles_repo_local_destination: "~/Documents/dotfiles"

The local path where the `dotfiles_repo` will be cloned.

    dotfiles_home: "~"

The home directory where dotfiles will be linked. Generally, the default should work, but in some circumstances, or when running the role as sudo on behalf of another user, you may want to specify the full path.

    dotfiles_files:

      - .zshrc

      - .gitignore

      - .inputrc

      - .vimrc

Which files from the dotfiles repository should be linked to the `dotfiles_home`.

## Dependencies

None

## Example Playbook

    - hosts: localhost

      roles:

        - { role: geerlingguy.dotfiles }

## License

MIT / BSD

## Author Information

This role was created in 2015 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).