Hooks

Kluctl hooks.

Kluctl supports hooks in a similar fashion as known from Helm Charts. Hooks are executed/deployed before and/or after the actual deployment of a kustomize deployment.

To mark a resource as a hook, add the kluctl.io/hook annotation to a resource. The value of the annotation must be a comma separated list of hook names. Possible value are described in the next chapter.

Hook types

Hook TypeDescription
pre-deploy-initialExecuted right before the initial deployment is performed.
post-deploy-initialExecuted right after the initial deployment is performed.
pre-deploy-upgradeExecuted right before a non-initial deployment is performed.
post-deploy-upgradeExecuted right after a non-initial deployment is performed.
pre-deployExecuted right before any (initial and non-initial) deployment is performed.
post-deployExecuted right after any (initial and non-initial) deployment is performed.

A deployment is considered to be an “initial” deployment if none of the resources related to the current kustomize deployment are found on the cluster at the time of deployment.

If you need to execute hooks for every deployment, independent of its “initial” state, use pre-deploy-initial,pre-deploy to indicate that it should be executed all the time.

Hook deletion

Hook resources are by default deleted right before creation (if they already existed before). This behavior can be changed by setting the kluctl.io/hook-delete-policy to a comma separated list of the following values:

PolicyDescription
before-hook-creationThe default behavior, which means that the hook resource is deleted right before (re-)creation.
hook-succeededDelete the hook resource directly after it got “ready”
hook-failedDelete the hook resource when it failed to get “ready”

Hook readiness

After each deployment/execution of the hooks that belong to a deployment stage (before/after deployment), kluctl waits for the hook resources to become “ready”. Readiness is defined here.

It is possible to disable waiting for hook readiness by setting the annotation kluctl.io/hook-wait to “false”.

Hook Annotations

More control over hook behavior can be configured using additional annotations as described in annotations/hooks

Last modified June 19, 2024: Sync docs (#133) (3701c54)