HomeLab Infrastructure

For a detailed history of the project’s evolution, see CHANGELOG.md.

• HomeLab Infrastructure
  • Overview
  • Architecture Overview
  • Repository Structure
  • Components
    • 1. Infrastructure & Provisioning (/ansible, /machineConfigs)
  • Hardware Inventory
    • Kubernetes
      • Machines
        • Storage
      • Kubernetes Nodes
        • Ceph Performance Tests
        • GPU
  • Network Architecture
    • Physical Topology
    • Networking Machines
    • VLAN Map
    • 2. Kubernetes Cluster (/okd)
    • 3. GitOps & Applications (/kubernetes)
    • 4. Tooling (/containers, main.bash)
    • 5. Virtualization & Cloud (/vms, /terraform)
    • 6. AI Agent Tooling (AGENTS.md, .agents/)
  • Usage
    • Bootstrapping
    • Deploying a New App
      • Kubernetes Commands
        • Delete Pod Using Graceful Termination Eviction Request

Overview

This repository contains the complete Infrastructure-as-Code (IaC) and GitOps configuration for my HomeLab. It manages everything from bare-metal server provisioning and virtualization to the Kubernetes (OKD) cluster and application deployment.

Architecture Overview

The infrastructure is built in layers, starting from physical hardware management with Ansible, up to application deployment managed by ArgoCD.

graph TD
    User[User / Admin] -->|manages| MainScript[main.bash]

    subgraph "Provisioning Layer"
        MainScript -->|triggers| Ansible[Ansible Playbooks]
        Ansible -->|configures| BareMetal[Physical Servers]
        Ansible -->|configures| KVM[KVM Hypervisors]
        Ansible -->|configures| Desktops[Workstations]
    end

    subgraph "Cluster Layer (OKD)"
        AgentConfig[Agent Config] -->|bootstraps| OKD[OKD Cluster]
        InstallConfig[Install Config] -->|defines| OKD
        BareMetal -->|hosts| OKD
    end

    subgraph "GitOps Layer"
        OKD -->|runs| ArgoCD[ArgoCD]
        ArgoCD -->|syncs| Apps[Applications]

        Apps -->|source| K8sDir[./kubernetes/]
    end

    subgraph "Applications"
        K8sDir --> Monitoring[Observability]
        K8sDir --> Storage[Storage]
        K8sDir --> HomeAuto[Home Automation]
        K8sDir --> DevTools[DevOps & Security]
        K8sDir --> Media[Media]