Skip to content

README.md

Latest commit

 

History

History
80 lines (58 loc) · 2.85 KB

README.md

File metadata and controls

80 lines (58 loc) · 2.85 KB

🛸 Fleet-Control: Homelab Infrastructure

This repository is the central nervous system for my homelab and laptop provisioning. It manages the lifecycle of Proxmox VMs through a "Define once, Deploy anywhere" workflow.

📂 Repository Architecture

.
├── terraform/                
│   ├── brownfunk/            # Hardware definition for the main cluster
│   │   ├── main.tf
│   │   └── variables.tf
│   ├── myNewNode/            # Sandbox/Secondary node definitions
│   └── [Go to Terraform Docs](./terraform/README.md)
│
├── ansible/                  
│   ├── inventory/            # Host definitions
│   │   ├── brownfunk.ini     # Generated by TF (Main fleet)
│   │   └── myNewNode.ini     # Generated by TF (Experimental nodes)
│   ├── collections/          # Local Ansible modules (Git ignored)
│   ├── tasks/                # Reusable logic (Docker, LUKS, etc.)
│   └── [Go to Ansible Docs](./ansible/README.md)
│
├── terraform.tfvars          # Global Secrets & API Keys (Git ignored)
└── .gitignore                # Protects state, inventory, and secreto

🚀 Quick Start

1. Provision Hardware

Navigate to the specific node folder in Terraform. Applying this will trigger the provider to build the VM and use the .tftpl to write the .ini file into the Ansible inventory folder.

cd terraform/brownfunk
terraform init
terraform apply

2. Prepare Ansible Environment

Ensure the local collections are installed into the project (required once, or whenever requirements.yml changes).

cd ../../ansible
ansible-galaxy collection install -r requirements.yml -p ./collections

3. Run Configuration

Execute the playbook against the specific inventory generated in step 1.

ansible-playbook -i inventory/brownfunk.ini setup_homelabs.yml --ask-vault-pass # or generate a .vault_pass file

🛠️ Management Commands

Proxmox (Terraform)

Command Result
terraform plan Check what hardware changes are pending
terraform refresh Sync local state with actual Proxmox status
terraform apply -compact-warnings Clean output during VM creation

Configuration (Ansible)

Command Result
ansible-inventory -i inventory/brownfunk.ini --list Debug the generated host groups
ansible-playbook ... --limit "bf-nas*" Only run tasks on the NAS node