GitOps my homelab

• 💼 managed with Flux2 and Terraform
• 🤖 updated by RenovateBot
• 🔐 secured by Let's Encrypt and Cloudflare Tunnel

Table of Contents

• About The Project
  • 🧰 Tools and Technologies
  • 📖 Overview
• Getting Started
  • Prerequisites
• Usage
  • Configure SOPS
  • Configure kubectl
• Roadmap
• 🕵️ Troubleshooting
  • Stuck HelmRelease
• Quality

About The Project

👋 Hello and welcome to my Home Lab GitOps Cluster Configuration!

In this project, I am thrilled to share with you the automated configuration of my home infrastructure. As an ardent believer in continuous learning, I embrace every opportunity to challenge myself and expand my knowledge horizon. Through this venture, I aim to not only streamline and automate my daily tasks but also encourage collaboration and knowledge sharing within the community.

This is a private project heavily inspired by the great k8s-at-home community.

Let's take a glimpse into the evolution of this project:

• The Foundation: flux.home-cluster starting with a first iteration and learn Flux and GitOps principles with some old hardware.
• The Minimal Redundancy Edition: flux.pi-k3s.home starting a new project with a Raspberry Pi based GitOps Flux Cluster, with three control planes.
• The Merge: flux.k3s.home after a successfull testing phase I merged both projects into one cluster.

By making my findings and work accessible to all, I strongly believe in the principle that knowledge should be free, empowering individuals to avoid repetitive endeavors and instead focus on new and exciting challenges.

Join me on this exciting journey as we delve into the realm of Kubernetes and GitOps, uncovering new insights and finding innovative ways to enhance our setups. Let's embrace the spirit of collaboration and empower each other to achieve more.

Happy automating, learning, and exploring!

(back to top)

🧰 Tools and Technologies

Here is the list of tools and technologies I am using in this project.

Tool	Role
talos	Linux designed for Kubernetes – secure, immutable, and minimal.
Flux2	Kubernetes GitOps engine
Terraform	Infrastructure automation to provision and manage resources in any cloud or data center.
Cloudflare	DNS and tunnels to allow external traffic
RenovateBot	Automated dependency updates.
GitHub	Code Hosting and job runnner
Backstage	Documentation with backstage developer portal

📖 Overview

Hardware

Device	CPU	OS	OS Disk	Data Disk	RAM	Purpose
Intel NUC7i7DNHE	i7-8650U	talos	500 GB SSD	500GB NVMe (rook-ceph)	32GB	control-plane, worker
Intel NUC7i7DNHE	i7-8650U	talos	500 GB SSD	500GB NVMe (rook-ceph)	32GB	control-plane, worker
Intel NUC7i7DNHE	i7-8650U	talos	500 GB SSD	500GB NVMe (rook-ceph)	32GB	control-plane, worker
Intel NUC10I7FNH	i7-10710U	talos	500 GB NVMe	-	32GB	worker

(back to top)

Getting Started

Prerequisites

• mozilla sops
• age
• talhelper

(back to top)

Usage

Configure SOPS

Provide key in path defined in .envrc.

Configure kubectl

Just run

task talos:config
task talos:kubeconfig

(back to top)

Roadmap

• Complete README.md
• Add Changelog
• Add GitHub Pages

See the open issues for a full list of proposed features (and known issues).

(back to top)

🕵️ Troubleshooting

Stuck HelmRelease

discussion

example:

➜ flux suspend hr -n networking traefik
► suspending helmreleases traefik in networking namespace
✔ helmreleases suspended

➜ flux resume hr -n networking traefik
► resuming helmreleases traefik in networking namespace
✔ helmreleases resumed
◎ waiting for HelmRelease reconciliation
✔ HelmRelease reconciliation completed
✔ applied revision 10.9.1

(back to top)

Quality

(back to top)