flux v2.0.1

Kustomization.spec

KustomizationSpec defines the configuration to calculate the desired state from a Source using Kustomize.

23 fields
Kustomization.spec fields and descriptions
Field / TypeDescription
object

CommonMetadata specifies the common labels and annotations that are applied to all resources. Any existing label or annotation will be overridden if its key matches a common one.

string[]

Components specifies relative paths to specifications of other Components.

object

Decrypt Kubernetes secrets before applying them on the cluster.

object[]

DependsOn may contain a meta.NamespacedObjectReference slice with references to Kustomization resources that must be ready before this Kustomization can be reconciled.

force
boolean

Force instructs the controller to recreate resources when patching fails due to an immutable field change.

  • default: false
object[]

A list of resources to be included in the health assessment.

object[]

Images is a list of (image name, new name, new tag or digest) for changing image names, tags or digests. This can also be achieved with a patch, but this operator is simpler to specify.

interval
string required

The interval at which to reconcile the Kustomization.

  • pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
object

The KubeConfig for reconciling the Kustomization on a remote cluster. When used in combination with KustomizationSpec.ServiceAccountName, forces the controller to act on behalf of that Service Account at the target cluster. If the --default-service-account flag is set, its value will be used as a controller level fallback for when KustomizationSpec.ServiceAccountName is empty.

object[]

Strategic merge and JSON patches, defined as inline YAML objects, capable of targeting objects based on kind, label and annotation selectors.

object[]

JSON 6902 patches, defined as inline YAML objects. Deprecated: Use Patches instead.

any[]

Strategic merge patches, defined as inline YAML objects. Deprecated: Use Patches instead.

path
string

Path to the directory containing the kustomization.yaml file, or the set of plain YAMLs a kustomization.yaml should be generated for. Defaults to 'None', which translates to the root path of the SourceRef.

object

PostBuild describes which actions to perform on the YAML manifest generated by building the kustomize overlay.

prune
boolean required

Prune enables garbage collection.

retryInterval
string

The interval at which to retry a previously failed reconciliation. When not specified, the controller uses the KustomizationSpec.Interval value to retry failures.

  • pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
serviceAccountName
string

The name of the Kubernetes service account to impersonate when reconciling this Kustomization.

object required

Reference of the source where the kustomization file is.

suspend
boolean

This flag tells the controller to suspend subsequent kustomize executions, it does not apply to already started executions. Defaults to false.

targetNamespace
string

TargetNamespace sets or overrides the namespace in the kustomization.yaml file.

  • minLength: 1
  • maxLength: 63
timeout
string

Timeout for validation, apply and health checking operations. Defaults to 'Interval' duration.

  • pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
validation
string

Deprecated: Not used in v1beta2.

  • enum: ["none","client","server"]
wait
boolean

Wait instructs the controller to check the health of all the reconciled resources. When enabled, the HealthChecks are ignored. Defaults to false.