Kustomization.spec

BuildMetadata specifies which kustomize build metadata should be added to the built resources. The allowed values are 'originAnnotations' to annotate resources with their source origin, and 'transformerAnnotations' to annotate resources with the transformers that produced them.

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.

Components specifies relative paths to kustomize Components.

Decrypt Kubernetes secrets before applying them on the cluster.

DeletionPolicy can be used to control garbage collection when this Kustomization is deleted. Valid values are ('MirrorPrune', 'Delete', 'WaitForTermination', 'Orphan'). 'MirrorPrune' mirrors the Prune field (orphan if false, delete if true). Defaults to 'MirrorPrune'.

• enum: ["MirrorPrune","Delete","WaitForTermination","Orphan"]

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

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

• default: false

HealthCheckExprs is a list of healthcheck expressions for evaluating the health of custom resources using Common Expression Language (CEL). The expressions are evaluated only when Wait or HealthChecks are specified.

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

Ignore is a list of rules for specifying which changes to ignore during drift detection. These rules are applied to the resources managed by the Kustomization and are used to exclude specific JSON pointer paths from the drift detection and apply process.

IgnoreMissingComponents instructs the controller to ignore Components paths not found in source by removing them from the generated kustomization.yaml before running kustomize build.

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.

The interval at which to reconcile the Kustomization. This interval is approximate and may be subject to jitter to ensure efficient use of resources.

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

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.

• x-kubernetes-validations: [{"message":"exactly one of spec.kubeConfig.configMapRef or spec.kubeConfig.secretRef must be specified","rule":"has(self.configMapRef) || has(self.secretRef)"},{"message":"exactly one of spec.kubeConfig.configMapRef or spec.kubeConfig.secretRef must be specified","rule":"!has(self.configMapRef) || !has(self.secretRef)"}]

NamePrefix will prefix the names of all managed resources.

• minLength: 1
• maxLength: 200

NameSuffix will suffix the names of all managed resources.

• minLength: 1
• maxLength: 200

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

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.

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

Prune enables garbage collection.

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))+$

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

Reference of the source where the kustomization file is.

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

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

• minLength: 1
• maxLength: 63

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

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

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