关于该项目发展的详细历史，请参见 CHANGELOG.md。

• HomeLab 基础设施
• 概述
• 架构概述
• 存储库结构
• 组成部分
• 1.基础设施 \ 配置 （/ansible， /machineConfigs）
• 硬件库存
• Kubernetes
• 机器
• 存储
• Kubernetes 节点
• Ceph性能测试
• GPU
• 网络架构
• 物理拓扑
• 网络机器
• VLAN 映射
• 2.Kubernetes 集群（[/okd）
• 3.GitOps & 应用程序 （/kubernetes）
• 4.工具（/containers，main.bash）
• 5.虚拟化 \ & 云 （[/vms， /terraform）
• 6.AI代理工具（[AGENTS.md，.agents/）
• 使用情况
• 自助法
• 部署新应用
• Kubernetes 命令
• 使用优雅终止请求删除Pod

概述

该仓库包含我家庭实验室的完整基础设施即代码（IaC）和GitOps配置。它管理从裸机服务器配置和虚拟化到Kubernetes（OKD）集群和应用部署的所有环节。

建筑概述

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]