Skip to content

iloveitaly/ansible-dotfiles-bootstrap

Repository files navigation

Ansible Role: Bootstrap Dotfiles Ansible Role

Install a set of dotfiles from a given Git repository and run a installation or bootstrap script (like GitHub codespaces). By default, it will install my 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_recursive: true

Clone recursively with submodules.

dotfiles_repo: "https://gitlab.com/iloveitaly/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: "~/dotfiles"

The local path where the dotfiles_repo will be cloned.

dotfiles_force_clone: false

When true, it will force clone the repository, overwriting any local changes.

dotfiles_home: "~"

Whether the files in the repository start with dot or not.

Example Playbook

- hosts: localhost
  roles:
    - { role: iloveitaly.dotfiles_bootstrap }

License

MIT

Author Information

About

Ansible role to download dotfiles, find the installation/bootstrap command, and execute it

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project