← All insightsConcepts

Flux CD: core concepts and configuration explained

CodeWizard Academy · 11 June 2026 · 3 min read · Beginner

A CNCF GitOps toolkit that reconciles Kubernetes from Git, Helm and OCI sources. This walkthrough covers the mental model and the configuration you will actually touch.

Flux is a set of Kubernetes controllers that keep clusters in sync with sources like Git, Helm repositories and OCI artifacts, with first-class Kustomize and Helm support.

The configuration that matters

A GitRepository source plus a Kustomization that applies it.

yaml
apiVersion: source.toolkit.fluxcd.io/v1
kind: GitRepository
metadata: { name: apps, namespace: flux-system }
spec:
  interval: 1m
  url: https://github.com/acme/deploy
  ref: { branch: main }
---
apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
metadata: { name: web, namespace: flux-system }
spec:
  interval: 5m
  path: ./apps/web
  prune: true
  sourceRef: { kind: GitRepository, name: apps }

Principles to hold onto

  • Set prune:true and sensible intervals per Kustomization
  • Use the notification controller to alert on reconcile failures
  • Separate infrastructure and app Kustomizations with dependsOn

Everyday commands

bash
flux get kustomizations
flux reconcile kustomization web --with-source
flux suspend kustomization web

Want senior help putting Flux CD to work - or a team bootcamp on it? CodeWizard runs Israel's largest DevOps community and embeds named senior engineers with a transparent hours log. Book a free consult or explore the Academy.

Like where this is going?

Get hands-on help from the engineers who write these posts.

Book a free consult