Purpose

This monorepo has 3 uses:

1. Setup infrastructure
2. Maintain infrastructure
3. Document infrastructure

The inventory defines the lab's infrastructure. The config defines the state we want the infrastructure to be in. For a given inventory, the playbook should be idempotent.

Structure

src/
├── network
│   ├── tasks
│   └── templates
├── pi
│   ├── files
│   ├── tasks
│   ├── templates
│   └── vars
└── servers
    ├── files
    ├── tasks
    └── vars

Network

1. Wireguard (Idempotent if atomic)

Sets up the VPN on the master and slaves. Idempotent only if run on all the nodes and slaves at once (atomic)

1. VLANs

To be run only on router. Idempotency not guaranteed.

1. DNS

Setup DNS on all the hosts. Idempotent.

Pi

1. PiHole

Setup the PiHole service. Idempotent.

1. PXE

Setup PXE boot serviec. Idempotent.

Servers

1. Base

Install required packages on the hosts. Idempotent.

1. Services

Install and setup services on hosts. Idempotent.

Playbook Loops

Each loop is a idempotent loop playbook which does certain actions.

Setup Playbook

Used for the inital homelab setup.

Steps:

1. src/pi
   • Start PXE
   • Start PiHole
2. PXE boot all hosts with kickstart files
3. src/network
   • Apply VLAN settings
   • Apply DNS settings
   • Apply VPN settings
4. src/servers
   • Install base packages
   • Start up required services on cluster
5. Misc - Print manual config - router, NAS etc.

Maintenance Playbook

Used for upgrades, backups, and bringing services/networks up and down.

Steps:

1. src/pi
   • Start PXE
   • Start PiHole
2. PXE boot all hosts with kickstart files
3. src/network
   • Apply VLAN settings
   • Apply DNS settings
   • Apply VPN settings
4. src/servers
   • Install base packages
   • Start up required services on cluster
5. Misc - Print manual config - router, NAS etc.