The GitOps Toolkit Kustomize reconciler
Go to file
Stefan Prodan 4b697dd927
Merge pull request #1105 from fluxcd/backport-1104-to-release/v1.2.x
[release/v1.2.x] Update controller-gen to v0.14.0
2024-03-12 20:03:09 +02:00
.github build(deps): bump the ci group with 1 update 2024-01-30 11:53:19 +00:00
api Update controller-gen to v0.14.0 2024-03-12 17:53:43 +00:00
config Update controller-gen to v0.14.0 2024-03-12 17:53:43 +00:00
docs Update README.md 2023-09-28 15:05:45 -04:00
hack Version API generated docs 2023-03-30 19:42:21 +05:30
internal Fix requeue warning introduced by controller-runtime 2024-03-08 07:21:34 +00:00
tests/fuzz Update Go to 1.21 2024-01-23 14:36:04 +00:00
.gitignore Move `controllers` to `internal/controllers` 2023-03-29 12:27:05 +03:00
.goreleaser.yaml Add SLSA3 generators to release workflow 2023-06-22 15:16:34 +03:00
CHANGELOG.md Add changelog entry for v1.2.2 2024-02-02 17:02:43 +05:30
CODE_OF_CONDUCT.md Release v0.0.1-alpha.1 2020-04-20 15:11:11 +03:00
DCO Release v0.0.1-alpha.1 2020-04-20 15:11:11 +03:00
DEVELOPMENT.md update to new doc links structure 2022-08-30 15:26:51 +02:00
Dockerfile Update Go to 1.21 2024-01-23 14:36:04 +00:00
LICENSE Initial commit 2020-04-15 08:57:39 +03:00
MAINTAINERS Share fluxcd/flux2 maintainer 2020-11-30 13:31:53 +00:00
Makefile Update controller-gen to v0.14.0 2024-03-12 17:53:43 +00:00
PROJECT Promote Kustomization API to v1 2023-03-29 16:29:05 +03:00
README.md api/docs: various nits and typos 2023-03-31 17:23:46 +02:00
go.mod Release v1.2.2 2024-02-02 17:03:01 +05:30
go.sum Update source-controller dependency 2024-02-01 15:39:27 +00:00
main.go Setup field for manager overrides on KustomizationReconciler struct and build up the disallow list to include these 2023-11-28 08:22:26 +00:00

README.md

kustomize-controller

CII Best Practices e2e report license release

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

The cluster desired state is described through a Kubernetes Custom Resource named Kustomization. Based on the creation, mutation or removal of a Kustomization resource in the cluster, the controller performs actions to reconcile the cluster current state with the desired state.

overview

Features

  • watches for Kustomization objects
  • fetches artifacts produced by source-controller from Source objects
  • watches Source objects for revision changes
  • generates the kustomization.yaml file if needed
  • generates Kubernetes manifests with Kustomize SDK
  • decrypts Kubernetes secrets with Mozilla SOPS and KMS
  • validates the generated manifests with Kubernetes server-side apply dry-run
  • detects drift between the desired and state and cluster state
  • corrects drift by patching objects with Kubernetes server-side apply
  • prunes the Kubernetes objects removed from source
  • checks the health of the deployed workloads
  • runs Kustomizations in a specific order, taking into account the depends-on relationship
  • notifies whenever a Kustomization status changes

Specifications

Guides

Roadmap

The roadmap for the Flux family of projects can be found at https://fluxcd.io/roadmap/.

Contributing

This project is Apache 2.0 licensed and accepts contributions via GitHub pull requests. To start contributing please see the development guide.