ansible/README.md
2020-10-14 07:16:42 -05:00

30 lines
1.1 KiB
Markdown

# Salt's Ansible Repo
A collection of Ansible configuration to manage all of my machines.
## Quickstart
To quickly get a machine up and running, add it to the inventory and `./provision.yml` it. This ensures a basic, sane running environment from which you can do tuning. Ideally, though, you should have roles.
## Overview
The main playbook, `site.yml`, can be separated into more or less two parts:
* The home machine half, tied together via Zerotier
* The 9iron half, with public IPs and resolvable names
See `inventory/hosts.yml` for details on what machines have what roles and what configuration. I try my best to make self-explaning configuration, so everything should mostly make sense on a first read. If you have any questions, hit me up.
## Style Guide
* Quote strings when required, quote entire strings if they contain Jinja markup, not just the marked up section (yes I know I violate this in several places)
* Use `yes` and `no` for booleans
* Use short form for simple tasks (still working on fixing that up)
## Your Shit is Trash
I know. Please file an issue.