Skip to content
This repository has been archived by the owner on Jul 4, 2023. It is now read-only.

Latest commit

 

History

History
63 lines (48 loc) · 4.25 KB

README.md

File metadata and controls

63 lines (48 loc) · 4.25 KB

What is this?

This is my attempt at documenting my homelab K3S cluster deployment using Flux.

The repo was initialized with k8s@home template. Other sources:

🔧  Tools

📍 Some useful tools used in this project.

Tool Purpose Minimum version Required
kubectl Allows you to run commands against Kubernetes clusters 1.21.0
flux Operator that manages your k8s cluster based on your Git repository 0.12.3
SOPS Encrypts k8s secrets with GnuPG 3.7.1
GnuPG Encrypts and signs your data 2.2.27
direnv Exports env vars based on present working directory 2.28.0
pre-commit Runs checks during git commit 2.12.0
kustomize Template-free way to customize application configuration 4.1.0
helm Manage Kubernetes applications 3.5.4
go-task A task runner / simpler Make alternative written in Go 3.7.0
prettier Prettier is an opinionated code formatter. 2.3.2

📂  Repository structure

The Git repository contains the following directories under cluster and are ordered below by how Flux will apply them.

  • base directory is the entrypoint to Flux
  • crds directory contains custom resource definitions (CRDs) that need to exist globally in your cluster before anything else exists
  • core directory (depends on crds) are important infrastructure applications (grouped by namespace) that should never be pruned by Flux
  • apps directory (depends on core) is where your common applications (grouped by namespace) could be placed, Flux will prune resources here if they are not tracked by Git anymore
cluster
├── apps
│   ├── default
│   ├── networking
│   └── system-upgrade
├── base
│   └── flux-system
├── core
│   ├── cert-manager
│   ├── metallb-system
│   ├── namespaces
│   └── system-upgrade
└── crds
    └── cert-manager

🤖  Automation

  • Renovate is a very useful tool that when configured will start to create PRs in your Github repository when Docker images, Helm charts or anything else that can be tracked has a newer version. The configuration for renovate is located here.

  • system-upgrade-controller will watch for new k3s releases and upgrade your nodes when new releases are found.

There's also a couple Github workflows included in this repository that will help automate some processes.