How penguinoneshaw/flux works
Project type and purpose
• This is a GitOps repository for Kubernetes, using Flux v2 and Kustomize to declaratively manage apps and infrastructure.
• Its purpose is to hold all cluster-wide and application-level configuration in Git, synchronize it to one or more clusters, and automate releases via controllers.
File structure
Top-level directories:
• apps/ – Kustomize “base” and “overlay” definitions of user workloads (e.g., audiobookshelf, home-assistant, pihole).
• clusters/ – Per-cluster overlay (here clusters/x86) defining which apps and controllers to deploy.
• infrastructure/ – Core platform controllers (Ingress, cert-manager, Prometheus, MetalLB, Tailscale, etc.) and load-balancer configurations.
• secrets/ – Kubernetes Secret manifests referenced by your kustomizations.
• .github/ & scripts/ – CI workflows (lint, e2e), validation scripts.
README
Only a title (“Flux configuration”) is provided. Use the directory naming and kustomization.yaml files as the primary source of architecture details.