The Helm plugin that comes in handy while identifying configuration drifts (mostly due to in-place edits) from the deployed Helm charts.
Deploying resources on Kubernetes through the Helm package manager offers simplicity, but maintaining them can be challenging.
While Helm ideally manages all resources, manual interventions are sometimes necessary, leading to configuration discrepancies from the deployed Helm charts.
These changes risk being overwritten by subsequent Helm releases, potentially resulting in lost configurations.
The Helm Drift plugin aims to address this issue by validating resources associated with a specific chart or release against Kubernetes. Leveraging kubectl diff functionality, it identifies any discrepancies or drifts in configurations.
For further insights into the motivation behind creating this plugin, check out the accompanying blog post blog.
# By enabling --summary would render drifts as quick summary in table format.
helm drift run prometheus-standalone example/chart/sample/ -f ~/path/to/example/chart/sample/override-config.yaml --skip-cleaning --summary
KIND | NAME | DRIFT
-----------------|-----------------------|---------
ServiceAccount | sample | NO
Service | sample | NO
DaemonSet | fluentd-elasticsearch | NO
Pod | nginx | NO
Pod | nginx-2 | NO
ReplicaSet | frontend | NO
Deployment | sample | NO
StatefulSet | web | YES
Job | pi | NO
CronJob | hello | NO
-----------------|-----------------------|---------
STATUS | FAILED
------------------------|---------
Namespace: 'sample' Release: 'sample'
# Invoking command with out flag --summary would render detailed drifts.
helm drift run prometheus-standalone example/chart/sample/ -f ~/path/to/example/chart/sample/override-config.yaml --skip-cleaning
# executing above command would yield results something like below:
------------------------------------------------------------------------------------
Identified drifts in: 'StatefulSet' 'web'
-----------
diff -u -N /var/folders/dm/40_kbx_56psgqt29q0wh2cxh0000gq/T/LIVE-2873647491/apps.v1.StatefulSet.sample.web /var/folders/dm/40_kbx_56psgqt29q0wh2cxh0000gq/T/MERGED-4261927724/apps.v1.StatefulSet.sample.web
--- /var/folders/dm/40_kbx_56psgqt29q0wh2cxh0000gq/T/LIVE-2873647491/apps.v1.StatefulSet.sample.web 2023-03-25 23:33:06.000000000 +0530
+++ /var/folders/dm/40_kbx_56psgqt29q0wh2cxh0000gq/T/MERGED-4261927724/apps.v1.StatefulSet.sample.web 2023-03-25 23:33:06.000000000 +0530
@@ -5,7 +5,7 @@
meta.helm.sh/release-name: sample
meta.helm.sh/release-namespace: sample
creationTimestamp: "2023-03-24T06:15:02Z"
- generation: 2
+ generation: 3
labels:
app.kubernetes.io/managed-by: Helm
managedFields:
@@ -84,7 +84,6 @@
f:spec:
f:containers:
k:{"name":"nginx"}:
- f:image: {}
f:ports:
k:{"containerPort":8080,"protocol":"TCP"}:
.: {}
@@ -94,6 +93,24 @@
manager: kubectl-edit
operation: Update
time: "2023-03-24T06:19:50Z"
+ - apiVersion: apps/v1
+ fieldsType: FieldsV1
+ fieldsV1:
+ f:spec:
+ f:template:
+ f:spec:
+ f:containers:
+ k:{"name":"nginx"}:
+ f:image: {}
+ f:ports:
+ k:{"containerPort":80,"protocol":"TCP"}:
+ .: {}
+ f:containerPort: {}
+ f:name: {}
+ f:protocol: {}
+ manager: kubectl-client-side-apply
+ operation: Update
+ time: "2023-03-25T18:03:05Z"
name: web
namespace: sample
resourceVersion: "14246"
@@ -114,10 +131,13 @@
app: nginx
spec:
containers:
- - image: k8s.gcr.io/nginx-slim:0.9
+ - image: k8s.gcr.io/nginx-slim:0.8
imagePullPolicy: IfNotPresent
name: nginx
ports:
+ - containerPort: 80
+ name: web
+ protocol: TCP
- containerPort: 8080
name: web
protocol: TCP
-----------
Try using the drift plugin with a custom diff tool instead for better results. Ex: diff tool, dyff, This can be used by setting the flag --custom-diff
helm drift run prometheus-standalone -n monitoring --from-release --custom-diff "dyff between --omit-header --set-exit-code"
helm plugin install https://github.com/nikhilsbhat/helm-drift
Use the executable just like any other go-cli application.
helm drift [command] [flags]
Make sure the appropriate command is used for the actions. To check the available commands and flags, use helm drift --help
Identifies drifts (mostly due to in place edits) in the kubernetes workloads provisioned via helm charts.
Usage:
drift [command] [flags]
Available Commands:
all Identifies drifts from all release from the cluster
completion Generate the autocompletion script for the specified shell
help Help about any command
run Identifies drifts from a selected chart/release
version Command to fetch the version of helm-drift installed
Flags:
-h, --help help for drift
-l, --log-level string log level for the plugin helm drift (defaults to info) (default "info")
--no-color enabling this would render summary with no color
--set stringArray set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
--set-file stringArray set values from respective files specified via the command line (can specify multiple or separate values with commas: key1=path1,key2=path2)
--set-string stringArray set STRING values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
--skip-tests setting this would set '--skip-tests' for helm template command while generating templates
-f, --values ValueFiles specify values in a YAML file (can specify multiple) (default [])
Use "drift [command] --help" for more information about a command.
Lists all configuration drifts that are part of specified chart/release if exists.
Usage:
drift run [RELEASE] [CHART] [flags]
Examples:
helm drift run prometheus-standalone path/to/chart/prometheus-standalone -f ~/path/to/override-config.yaml
helm drift run prometheus-standalone --from-release
Flags:
--custom-diff KUBECTL_EXTERNAL_DIFF custom diff command to use instead of default, the command passed here would be set under KUBECTL_EXTERNAL_DIFF.More information can be found here https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#diff
-d, --disable-error-on-drift enabling this would disable exiting with error if drifts were identified (works only when --summary is enabled)
--from-release enable the flag to identify drifts from a release instead (disabled by default, works with command 'run' not with 'all')
-h, --help help for run
-j, --json enable the flag to render drifts in json format (disabled by default)
--regex string regex used to split helm template rendered (default "---\\n# Source:\\s.*.")
--report when enabled the summary report would be rendered on to a file (this works only if --yaml or --json is enabled along with summary)
--skip-cleaning enable the flag to skip cleaning the manifests rendered on to disk
--skip-validation enable the flag if prerequisite validation needs to be skipped
--summary if enabled, prints a quick summary in table format without printing actual drifts
--temp-path string path on disk where the helm templates would be rendered on to (the same would be used be used by 'kubectl diff') (default "$(HOME)/.helm-drift/templates")
-y, --yaml enable the flag to render drifts in yaml format (disabled by default)
Global Flags:
-l, --log-level string log level for the plugin helm drift (defaults to info) (default "info")
--no-color enabling this would render summary with no color
--set stringArray set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
--set-file stringArray set values from respective files specified via the command line (can specify multiple or separate values with commas: key1=path1,key2=path2)
--set-string stringArray set STRING values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
--skip-tests setting this would set '--skip-tests' for helm template command while generating templates
-f, --values ValueFiles specify values in a YAML file (can specify multiple) (default [])
Lists all configuration drifts that are part of various releases present in the cluster.
Usage:
drift all [flags]
Examples:
helm drift all --kube-context k3d-sample
helm drift all --kube-context k3d-sample -n sample
Flags:
--custom-diff KUBECTL_EXTERNAL_DIFF custom diff command to use instead of default, the command passed here would be set under KUBECTL_EXTERNAL_DIFF.More information can be found here https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#diff
-d, --disable-error-on-drift enabling this would disable exiting with error if drifts were identified (works only when --summary is enabled)
-h, --help help for all
--is-default-namespace set this flag if drifts have to be checked specifically in 'default' namespace
-j, --json enable the flag to render drifts in json format (disabled by default)
--regex string regex used to split helm template rendered (default "---\\n# Source:\\s.*.")
--report when enabled the summary report would be rendered on to a file (this works only if --yaml or --json is enabled along with summary)
--skip-cleaning enable the flag to skip cleaning the manifests rendered on to disk
--skip-validation enable the flag if prerequisite validation needs to be skipped
--summary if enabled, prints a quick summary in table format without printing actual drifts
--temp-path string path on disk where the helm templates would be rendered on to (the same would be used be used by 'kubectl diff') (default "$(HOME)/.helm-drift/templates")
-y, --yaml enable the flag to render drifts in yaml format (disabled by default)
Global Flags:
-l, --log-level string log level for the plugin helm drift (defaults to info) (default "info")
--no-color enabling this would render summary with no color
--set stringArray set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
--set-file stringArray set values from respective files specified via the command line (can specify multiple or separate values with commas: key1=path1,key2=path2)
--set-string stringArray set STRING values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
--skip-tests setting this would set '--skip-tests' for helm template command while generating templates
-f, --values ValueFiles specify values in a YAML file (can specify multiple) (default [])
Updated documentation on all available commands and flags can be found here.
Identifying drifts on CRDs
would be tricky, and the plugin might not respond with the correct data.
If helm hooks are defined in the chart with hook-succeeded
or hook-failed
, one might always find drifts when identifying drifts from charts.
Things would work perfectly when identifying drifts from the installed release.
Support for adding a flag
to skip helm hooks
if required, is under development.