How akshaypradheep/homelab-iaac works
homelab-IaaC provisions Proxmox VMs and configures them with Ansible, using Terraform’s generated inventory as the handoff between the two. The principal workflow is to declare servers, create or update them, configure hosts, and deploy opted-in Compose stacks. Ansible also provides host-specific capabilities such as filesystem and USB setup. The README documents these major handoffs and the common-to-packages-to-Docker role order; no source excerpts were provided, so relationships beyond those documented are omitted.
Main entry points: main.tf VM provisioning · site.yml Site playbook · hosts.static.yml Ansible inventory · compose Compose stacks
Components 17
VM provisioning
- Server declarations
terraform/servers.auto.tfvars.example - VM provisioning
terraform/main.tf - Server module
terraform/modules/server/main.tf - Inventory template
terraform/templates/inventory.tpl
Host configuration
- Ansible inventory
ansible/inventory/hosts.static.yml - Site playbook
ansible/playbooks/site.yml - Common setup
ansible/roles/common/tasks/main.yml - Package setup
ansible/roles/packages/tasks/main.yml - Docker setup
ansible/roles/docker/tasks/main.yml - Layered host settings
ansible/inventory/group_vars/all.yml - Filesystem setup
ansible/roles/filesystems/tasks/main.yml - USB mount setup
ansible/roles/usb-mounts/tasks/main.yml - Application roles
ansible/roles
Compose services
- Compose stacks
compose - Monitoring stack
compose/monitoring/docker-compose.yml
Other components
- Homelab operator
- Proxmox
Connections 16
- Homelab operator → Server declarations: declares servers
README.md - Homelab operator → VM provisioning: runs apply
README.md - VM provisioning → Proxmox: creates VMs
README.md - VM provisioning → Server module: uses module
- VM provisioning → Inventory template: renders inventory
README.md - VM provisioning → Ansible inventory: generates inventory
README.md - Ansible inventory → Site playbook: supplies hosts
README.md - Site playbook → Common setup: runs first
README.md - Site playbook → Package setup: runs next
README.md - Site playbook → Docker setup: runs last
README.md - Layered host settings → Site playbook: configures hosts
README.md - Homelab operator → Filesystem setup: can configure
README.md - Homelab operator → USB mount setup: can configure
README.md - Homelab operator → Application roles: can install apps
README.md - Homelab operator → Compose stacks: deploys opted-in
README.md - Compose stacks → Monitoring stack: includes