Skip to content

Latest commit

 

History

History
222 lines (162 loc) · 9.61 KB

README.md

File metadata and controls

222 lines (162 loc) · 9.61 KB

taskfile pre-commit renovate commits talos kubernetes terraform cloudflare


GitOps my homelab

Table of Contents

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

megalinter

(back to top)