charlesrocket.essential.dotfiles role – Deploys dotfiles

Note

This role is part of the charlesrocket.essential collection (version 1.3.3).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install charlesrocket.essential.

To use it in a playbook, specify: charlesrocket.essential.dotfiles.

Entry point main – Deploys dotfiles

Synopsis

  • Deploy dotfiles from git repositories to a specified target location.

Parameters

Parameter

Comments

dotfiles_files

list / elements=string / required

Files to track.

dotfiles_home

string

Local dotfiles deployment target.

Default: "~"

dotfiles_repo

string / required

URL of the target repository to deploy from.

dotfiles_repo_accept_newhostkey

boolean

Ensure “-o StrictHostKeyChecking=accept-new” is present as an SSH option.

Choices:

  • false ← (default)

  • true

dotfiles_repo_force

boolean

Force git clone to override local modifications.

Choices:

  • false ← (default)

  • true

dotfiles_repo_local_destination

string

Local dotfiles repository target.

Default: "~/src/dotfiles"

dotfiles_repo_version

string / required

Branch to track.

Authors

  • charlesrocket