You are viewing documentation for Flux version: 2.0

Version 2.0 of the documentation is no longer actively maintained. The site that you are currently viewing is an archived snapshot. For up-to-date documentation, see the latest version.

Kustomize Controller

The GitOps Toolkit Kustomize Controller documentation.

The kustomize-controller is a Kubernetes operator, specialized in running continuous delivery pipelines for infrastructure and workloads defined with Kubernetes manifests and assembled with Kustomize.

Kustomize Controller Diagram


  • Reconciles the cluster state from multiple sources (provided by source-controller)
  • Generates manifests with Kustomize (from plain Kubernetes YAMLs or Kustomize overlays)
  • Decrypts Kubernetes secrets with Mozilla SOPS and KMS
  • Validates manifests against Kubernetes API
  • Impersonates service accounts (multi-tenancy RBAC)
  • Health assessment of the deployed workloads
  • Runs pipelines in a specific order (depends-on relationship)
  • Prunes objects removed from source (garbage collection)
  • Reports cluster state changes (alerting provided by notification-controller)


Controller Options

Controller command flags and defaults.


The GitOps Toolkit Custom Resource Definitions documentation.

API Reference

Last modified 2023-05-24: Update docs to Flux RC.4 (08eaeed)