ansible/README.md

# Salt's Ansible Repository

Useful for management across all of 9iron, thefuck, and desu.
## Initialization

* Clone
* `ansible-galaxy install -r requirements.yml`

## Deployment

Adding a new server will require the following be fulfilled:

* The server is accessible from the Ansible host;

* The server has a user named `ansible` which:

  * Accepts the public key located in `contrib/desu.pub`; and

  * Has passwordless sudo capabilities as root

* The server has been added to NetBox OR in `inventory-hard`

* DNS records for the machine are set; and

* The server is running Ubuntu 20.04 or greater

From there, running the playbook `site.yml` should get the machine up to snuff. To automate the host-local steps, use the script file `contrib/bootstrap.sh`.

## Zerotier

A lot of my home-network side of things is connected together via ZeroTier; initial deployment/repairs may require specifying an `ansible_host` for the inventory item in question to connect to it locally. Subsequent plays will require connectivity to my home ZeroTier network.

Cloud-managed devices require no such workarounds.
Working on basics 2020-10-17 00:21:57 -05:00			`# Salt's Ansible Repository`

			`Useful for management across all of 9iron, thefuck, and desu.`
Add init instructions to README 2020-10-28 22:42:11 -05:00			`## Initialization`

Polish up readme 2021-09-18 16:44:56 -05:00			`* Clone`
			* `ansible-galaxy install -r requirements.yml`
Add init instructions to README 2020-10-28 22:42:11 -05:00
Working on basics 2020-10-17 00:21:57 -05:00			`## Deployment`

			`Adding a new server will require the following be fulfilled:`

			`* The server is accessible from the Ansible host;`

			* The server has a user named `ansible` which:

			* Accepts the public key located in `contrib/desu.pub`; and

			`* Has passwordless sudo capabilities as root`

Polish up readme 2021-09-18 16:44:56 -05:00			* The server has been added to NetBox OR in `inventory-hard`
Mandate that DNS be set up as part of machine deployment Machines should NOT have the ability to modify DNS of their own volition. Like wtf past me 2020-10-17 01:19:55 -05:00
			`* DNS records for the machine are set; and`
Working on basics 2020-10-17 00:21:57 -05:00
Correct OS requirements in README The only dependency is python-is-python3 2020-12-28 12:58:07 -06:00			`* The server is running Ubuntu 20.04 or greater`
Working on basics 2020-10-17 00:21:57 -05:00
			From there, running the playbook `site.yml` should get the machine up to snuff. To automate the host-local steps, use the script file `contrib/bootstrap.sh`.
Update README 2020-11-07 00:47:18 -06:00
Add note to README about zt 2021-02-19 02:15:43 -06:00			`## Zerotier`

			A lot of my home-network side of things is connected together via ZeroTier; initial deployment/repairs may require specifying an `ansible_host` for the inventory item in question to connect to it locally. Subsequent plays will require connectivity to my home ZeroTier network.

			`Cloud-managed devices require no such workarounds.`