https://github.com/iloveitaly/ansible-dotfiles-bootstrap
Ansible role to download dotfiles, find the installation/bootstrap command, and execute it
https://github.com/iloveitaly/ansible-dotfiles-bootstrap
ansible dotfiles
Last synced: about 2 months ago
JSON representation
Ansible role to download dotfiles, find the installation/bootstrap command, and execute it
- Host: GitHub
- URL: https://github.com/iloveitaly/ansible-dotfiles-bootstrap
- Owner: iloveitaly
- License: mit
- Created: 2023-09-25T13:27:25.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-10-05T16:57:03.000Z (almost 3 years ago)
- Last Synced: 2025-03-29T08:14:26.478Z (over 1 year ago)
- Topics: ansible, dotfiles
- Homepage:
- Size: 96.7 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Role: Bootstrap Dotfiles 
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](https://github.com/iloveitaly/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
* Originally based on dotfiles role by [Jeff Geerling](https://www.jeffgeerling.com/).
* Leveraged improvements by Radek Sprta