Home Lab

Project status: BETA (but pretty stable).

Overview

This mono repository houses the infrastructure for my homelab. I try to adhere to Infrastructure as Code (IaC) and GitOps practices using tools like Ansible, Terraform, Kubernetes, Flux, Renovate and GitHub Actions.

This project aims to achieve its goals while adhering to industry-standard practices and fostering continuous learning.

Core Components

actions-runner-controller: Self-hosted Github runners
cert-manager: Creates SSL certificates for services in my k3s cluster.
external-dns: Automatically manages DNS records from my cluster in a cloud DNS provider.
external-secrets: Managed Kubernetes secrets using Doppler.
flannel: Internal Kubernetes networking plugin.
ingress-nginx: Ingress controller to expose HTTP traffic to pods over DNS.
longhorn: Distributed block storage for persistent storage.
sops
tf-controller: Additional Flux component used to run Terraform from within a Kubernetes Cluster.
volsync and snapscheduler: Backup and recovery of persistent volume claims.

Hardware

2 MinisForum um350:
- CPU: AMD Ryzen 5 3550H
- RAM: 32GB
- SSD: 512GB
1 x Raspberry pi
- CPU: ARM Cortex-A72 processor
- RAM: 8GB
- NVME: 1TB
3 x Raspberry pi
- CPU: ARM Cortex-A72 processor
- RAM: 4GB
- SD: 64GB

Features

[x] Automated Kubernetes installation and management
[x] Installing and managing applications using GitOps
[x] Automatic rolling upgrade for OS and Kubernetes
[x] Automatically update apps (with approval)
[x] Modular architecture, easy to add or remove features/components
[x] Automated certificate management
[x] Automatically update DNS records for exposed services
[x] Expose services to the internet securely with Cloudflare Tunnel
[x] Distributed storage
[x] Datascience jupyterhub environments
[x] Monitoring and alerting

Changelog

See my awful commit main history and legacy history

🤝 Gratitude and thanks

There is a template over at onedr0p/flux-cluster-template if you wanted to try and follow along with some of the practices I used here.

Also, a lot of inspiration for this repo came from the following people:

Community

There is a [email protected] Discord for this community.

Project Name	Stars	Packages Using This	Most Recent Commit	Total Releases	Latest Release	Open Issues	License	Language
Devops Exercises	41,762		3 days ago			14	other	Python
Linux, Jenkins, AWS, SRE, Prometheus, Docker, Python, Ansible, Git, Kubernetes, Terraform, OpenStack, SQL, NoSQL, Azure, GCP, DNS, Elastic, Network, Virtualization. DevOps Interview Questions
90daysofdevops	22,126		16 hours ago	1	May 10, 2022	5	other	Shell
I am using this repository to document my journey learning about DevOps. I began this process on January 1, 2022, and plan to continue until March 31. I will be dedicating one hour each day, including weekends, to gaining a foundational understanding of the various aspects of DevOps. This will be a 90-day intensive study period. 2022 & 2023 inc.
Kubespray	13,690		16 hours ago			132	apache-2.0	Jinja
Deploy a Production Ready Kubernetes Cluster
Kubeasz	8,900		a month ago	11	April 25, 2021	113	apache-2.0	Jinja
使用Ansible脚本安装K8S集群，介绍组件交互原理，方便直接，不受国内网络环境影响
Ansible For Devops	6,699		a month ago			90	mit	Python
Ansible for DevOps examples.
Homelab	6,649		a month ago			17	gpl-3.0	Go
Modern self-hosting framework, fully automated from empty disk to operating services with a single command.
Devops Guide	6,318		a month ago			5	mit	HTML
DevOps Guide - Development to Production all configurations with basic notes to debug efficiently.
Kubeoperator	4,627		15 days ago			33	apache-2.0	Go
KubeOperator 是一个开源的轻量级 Kubernetes 发行版，专注于帮助企业规划、部署和运营生产级别的 K8s 集群。
Litmus	3,560	1	2 days ago	7	April 25, 2021	287	apache-2.0	HTML
Litmus helps SREs and developers practice chaos engineering in a Cloud-native way. Chaos experiments are published at the ChaosHub (https://hub.litmuschaos.io). Community notes is at https://hackmd.io/a4Zu_sH4TZGeih-xCimi3Q
Opendevops	3,367		23 days ago			67	gpl-3.0	Python
CODO是一款为用户提供企业多混合云、一站式DevOps、自动化运维、完全开源的云管理平台、自动化运维平台

Home Ops