Mean Time To Production benchmark for Flux
Go to file
Stefan Prodan 8e3f7a476b
Merge pull request #14 from fluxcd/flux-2.6
Update Flux to v2.6.0
2025-05-29 14:33:05 +03:00
.github/workflows Run benchmark for Kubernetes v1.33.0 2025-05-28 23:31:44 +03:00
manifests Run benchmark 2cpu/1gb 2025-05-29 00:25:32 +03:00
scripts Update Kubernetes to v1.30.0 2024-05-11 10:25:24 +03:00
timoni Update OCIRepository to v1 (GA) 2025-05-29 10:39:41 +03:00
.gitignore Enable Helm drift detection 2023-11-23 10:08:51 +02:00
Brewfile Vendor the Helm chart in the local registry 2023-11-22 17:13:04 +02:00
LICENSE Initial commit 2020-03-31 21:05:47 +03:00
Makefile Push module to local registry 2023-11-03 18:32:07 +02:00
README.md Bump source-controller to v1.2.0 2023-12-05 19:15:01 +02:00
RESULTS.md Add benchmark results for Flux v2.6.0 2025-05-29 14:02:29 +03:00

README.md

flux-benchmark

benchmark

Mean Time To Production benchmarks for Flux release candidates, made with Timoni.

The benchmark results can be found in RESULTS.md.

Prerequisites

Start by cloning the repository locally:

git clone https://github.com/stefanprodan/flux-benchmark.git
cd flux-benchmark

Install Kubernetes kind, flux, timoni, crane and other CLI tools with Homebrew:

make tools

The complete list of tools can be found in the Brewfile.

Cluster Setup

Create a Kind cluster and a Docker registry:

make up

The Docker registry is exposed on the local machine on localhost:5555 and inside the cluster on flux-registry:5000.

The Kubernetes cluster is made out of 3 nodes:

  • flux-control-plane (Kubernetes API & etcd)
  • flux-worker (Flux controllers)
  • flux-worker1 (Prometheus, Grafana, kube-state-metrics, metrics-server)

Flux Setup

Install Flux on a dedicated node with:

make flux-up

Monitoring Setup

Install the Flux monitoring stack with:

timoni bundle apply -f timoni/bundles/flux-monitoring.cue --timeout 10m

To access Grafana, start port forward in a separate shell:

kubectl -n monitoring port-forward svc/kube-prometheus-stack-grafana  3000:80

Navigate to http://localhost:3000 in your browser and login with user admin and password flux.

Benchmark Setup

Push the Timoni modules to the local registry with:

make timoni-push

Flux Kustomization Benchmark

Run the benchmark for OCI artifact pull and Flux Kustomization install:

KS=100 timoni bundle apply -f timoni/bundles/flux-benchmark.cue --runtime-from-env --timeout=10m

Run the benchmark for Flux Kustomization upgrade:

KS=100 MCPU=2 timoni bundle apply -f timoni/bundles/flux-benchmark.cue --runtime-from-env --timeout=10m

Flux HelmRelease Benchmark

Run the benchmark for Helm chart pull and Flux HelmRelease install:

HR=100 timoni bundle apply -f timoni/bundles/flux-benchmark.cue --runtime-from-env --timeout=10m

Run the benchmark for Flux HelmRelease upgrade:

HR=100 MCPU=2 timoni bundle apply -f timoni/bundles/flux-benchmark.cue --runtime-from-env --timeout=10m

Teardown

Remove all Flux resources and the benchmark namespaces with:

timoni bundle delete flux-benchmark