dandyrow.linux.stow_dotfiles role – Install dotfiles from remote Git repository

Note

This role is part of the dandyrow.linux collection (version 2.6.0).

To install it use: ansible-galaxy collection install dandyrow.linux.

To use it in a playbook, specify: dandyrow.linux.stow_dotfiles.

Entry point main – Install dotfiles from remote Git repository

Synopsis

  • Install dotfiles from a remote Git repository to a specified target location.

Parameters

Parameter

Comments

dotfiles_local_repo

string

Local path where remote repo will be cloned to.

Defaults to ,dotfiles sub-directory within the home folder of the user ansible is executing as.

Default: "~/.dotfiles"

dotfiles_pull_single_branch

boolean

Whether to pull a single branche from the remote repo.

Set branch to pull with dotfiles_repo_branch variable.

Choices:

  • false

  • true ← (default)

dotfiles_remote_repo

string / required

URL of remote repo to install dotfiles from.

dotfiles_repo_branch

string

Which remote branch to pull from.

Default: "master"

dotfiles_target_path

path

Target location to install (stow) the specified dotfiles.

Defaults to the home directory of the user ansible is executing as.

Default: "~/"

dotfiles_to_install

list / elements=string / required

List of names of folders within dotfiles repo to install to the target path.

Authors

  • Daniel Lowry (github.com/dandyrow)