Ghimele's Homelab Configuration Repository

Welcome to the Homelab Configuration repository! This repository contains the configuration and automation scripts used to manage and deploy resources in the homelab environment. It includes Ansible playbooks, Kubernetes manifests, Helm charts, and CI/CD workflows.

Repository Structure

Here's an overview of the repository structure:

├── .github/                # GitHub Actions workflows
├── ansible/                # Ansible playbooks and tasks for system automation
│   ├── inventory/          # Ansible inventory files
│   ├── playbooks/          # Ansible playbooks for various tasks
│   └── tasks/              # Individual tasks
├── docs/                   # Documentation and ADRs (Architecture Decision Records)
│   └── adr/
├── kubernetes/             # Kubernetes clusters config folder.
│   ├── apps/               # Application-specific configurations (base, dev, prod, test).
│   ├── charts/             # Chart repository configuration
│   ├── clusters/           # Cluster-specific configurations (dev, prod, test).
│   ├── config/             # Base and environment-specific configurations for Kubernetes custom resources such as cert issuers and networks policies
│   └── infrastructure/     # Infr-specific configurations (base, dev, prod, test). Contains common infra tools for Kubernetes controllers such as traefik and cert-manager
├── management/             # Management services (e.g., backrest, portainer, xen-orchestra). The services are installed in a deicated VM using docker compose.
└── scripts/                # Automation and management scripts

Getting Started

To get started with the homelab configuration, follow these steps:

1. Clone the Repository

git clone https://github.com/ghimele/homelab.git
cd homelab

2. Setup Ansible

Install Ansible on your local machine. Configure your inventory files in ansible/inventories/ as needed. Run playbooks from ansible/playbooks/ to configure your systems.

3. Kubernetes Configuration

The Kubernetes Configuration is managed by Fluxcd, see the CD section.

4. Continuos Integration with GitHub Actions

Configure GitHub Actions workflows in the .github/workflows/ directory for automated testing and deployment.

5. Continuous Deployment with FluxCD

FluxCD manages the continuous deployment of the Kubernetes resources. The Flux configuration is located under kubernetes/clusters/<environment>. Ensure that your FluxCD setup is properly synced with this repository to automate deployments.

Thanks

A big thank you goes to these awesome people and their projects who inspired me to do this project:

• pascaliske/infrastructure
• onedr0p/home-ops
• nicholaswilde/home-cluster
• billimek/k8s-gitops