Skip to content

Commit

Permalink
FAQ for drift-correction
Browse files Browse the repository at this point in the history
Co-authored-by: Stefan Prodan <stefan.prodan@gmail.com>
  • Loading branch information
stealthybox and stefanprodan committed Apr 22, 2021
1 parent 4ecf541 commit ae3cd47
Showing 1 changed file with 12 additions and 0 deletions.
12 changes: 12 additions & 0 deletions docs/faq/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -251,6 +251,18 @@ EOF
Based on the above definition, Flux will upgrade the release automatically
when Bitnami publishes a new version of the metrics-server chart.

## General questions

### How does Flux correct drift when in-cluster-state diverges from desired-state in the source repository?
For resources that are managed by Flux's kustomize-controller and helm-controller, manual changes to those resources are reverted/corrected whenever a reconcile event or interval occurs.

kustomize-controller corrects drift via a constant, per-object Apply.
helm-controller corrects drift by performing a release upgrade.
helm-controller detects drift purely through helm storage -- individual objects can be overwritten without Helm knowing about it and there are no other diff plugins built into the controller at this time.
Things that are not managed by the reconcilers are not pruned, because it is Kubernetes' design to have derivative objects from higher level ones.
Proper RBAC RoleBindings are necessary to prevent undesired modification to the cluster.
It's possible to use the `kustomize.toolkit.fluxcd.io/name` and `helm.toolkit.fluxcd.io/name` labels to enumerate objects in the cluster that are not managed by Flux.

## Flux v1 vs v2 questions

### What are the differences between v1 and v2?
Expand Down

0 comments on commit ae3cd47

Please sign in to comment.