docker | ||
group_vars | ||
roles | ||
screenshots | ||
toolbox | ||
vagrant | ||
.gitignore | ||
.gitmodules | ||
.travis.yml | ||
ansible.cfg | ||
hosts.template | ||
install.yml | ||
README.md | ||
TODO |
Sway Acid Dark
Sway fish pure waybar neovim
Tiny irc client
Firefox/Tabliss Wofi
Connman/Thunar GTK Theme
Why dotfiles with Ansible ?
- Config files derivation by host or by OS with jinja2 templating
- It can manage packages too
- Secrets with Ansible-vault
- Multiple hosts and ability to update a config on all hosts from a single command
Test VMs|Containers
Please check vagrant/*/README.md
and docker/*/README.md
Docs
Please look at roles/*/README.md
if exists for specific hosts configuration.
How to
** Use carefully** backup your home before using ! Ansible will backup any existing conf file before overriding.
1. Fork Me!
2. Clone your repo on a personal host
git clone --recursive https://github.com/[your_repo]/dotfiles
cd dotfiles
3. Generate ssh keys
ssh-keygen -t rsa
4. Replace your ssh key in authorized_keys
role
!!! Use as is, you will add my SSH key in your authorized_keys !!!
cp ~/.ssh/id_rsa.pub dotfiles/roles/authorized_keys/id_rsa.pub
5. Generate hosts file with your managed hosts
hosts
file is defaultly gitignored.
cd dotfiles
mv hosts.template hosts
Add your hosts in right sections
- server : install only cli tools
- desktop : install graphic environment
- laptop : install desktop + some extra packages
Please explicitly define an ansible_user
which will receive configurations
[server]
server1 ansible_user=root
[laptop]
host1 ansible_user=user
[desktop]
host2 ansible_user=user2
Remove useless groups and hosts
6. Deploy SSH keys on nodes
Node per node if password differ between users. It adds your public ssh keys on hosts
ansible-playbook install.yml -t init_ssh -l host1 -k
ansible-playbook install.yml -t init_ssh -l host2 -k
ansible-playbook install.yml -t init_ssh -l host3 -k
7. Run ansible-playbook
For runs on hosts configured with root user You can use without providing extra passwords
ansible-playbook install.yml -l server
For hosts configured with non-root user User needs to be in sudoers. You need to use -K to ask sudo password, and -l to limit to that host
ansible-playbook install.yml -l host1 -K --ask-vault-pass
Extra commands
To list tasks and tags
ansible-playbook install.yml --list-tasks
To limit to a tag
ansible-playbook install.yml -K -t <tag>
To dry-run and print files diff on all declared hosts
ansible-playbook install.yml -l host1 -CDK
Local run
Add localhost line and user in right hosts file section
[server]
[laptop]
localhost ansible_connection=local ansible_user=user
[desktop]
ansible-playbook install.yml -l localhost -K --ask-vault-pass
Previously
IRC
eoli3n @ freenode #archlinux-fr