Kustomization is the Schema for the kustomizations API.
5 top-level fields · last changed in Flux v0.8.0
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
KustomizationSpec defines the desired state of a kustomization.
Decrypt Kubernetes secrets before applying them on the cluster.
Provider is the name of the decryption engine.
The secret name containing the private OpenPGP keys used for decryption.
Name of the referent
DependsOn may contain a dependency.CrossNamespaceDependencyReference slice with references to Kustomization resources that must be ready before this Kustomization can be reconciled.
Name holds the name reference of a dependency.
Namespace holds the namespace reference of a dependency.
A list of resources to be included in the health assessment.
API version of the referent, if not specified the Kubernetes preferred version will be used
Kind of the referent
Name of the referent
Namespace of the referent, when not specified it acts as LocalObjectReference
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.
Digest is the value used to replace the original image tag. If digest is present NewTag value is ignored.
Name is a tag-less image name.
NewName is the value used to replace the original name.
NewTag is the value used to replace the original tag.
The interval at which to reconcile the Kustomization.
The KubeConfig for reconciling the Kustomization on a remote cluster. When specified, KubeConfig takes precedence over ServiceAccountName.
SecretRef holds the name to a secret that contains a 'value' key with the kubeconfig file as the value. It must be in the same namespace as the Kustomization. It is recommended that the kubeconfig is self-contained, and the secret is regularly updated if credentials such as a cloud-access-token expire. Cloud specific `cmd-path` auth helpers will not function without adding binaries and credentials to the Pod that is responsible for reconciling the Kustomization.
Name of the referent
JSON 6902 patches, defined as inline YAML objects.
Patch contains the JSON6902 patch document with an array of operation objects.
Target points to the resources that the patch document should be applied to.
AnnotationSelector is a string that follows the label selection expression https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api It matches with the resource annotations.
Group is the API group to select resources from. Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources. https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
Kind of the API Group to select resources from. Together with Group and Version it is capable of unambiguously identifying and/or selecting resources. https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
LabelSelector is a string that follows the label selection expression https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api It matches with the resource labels.
Name to match resources with.
Namespace to select resources from.
Version of the API Group to select resources from. Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources. https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
Strategic merge patches, defined as inline YAML objects.
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.
Substitute holds a map of key/value pairs. The variables defined in your YAML manifests that match any of the keys defined in the map will be substituted with the set value. Includes support for bash string replacement functions e.g. ${var:=default}, ${var:position} and ${var/substring/replacement}.
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.
The name of the Kubernetes service account to impersonate when reconciling this Kustomization.
Reference of the source where the kustomization file is.
API version of the referent
Kind of the referent
Name of the referent
Namespace of the referent, defaults to the Kustomization namespace
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.
Timeout for validation, apply and health checking operations. Defaults to 'Interval' duration.
Validate the Kubernetes objects before applying them on the cluster. The validation strategy can be 'client' (local dry-run), 'server' (APIServer dry-run) or 'none'.
KustomizationStatus defines the observed state of a kustomization.
lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
message is a human readable message indicating details about the transition. This may be an empty string.
observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
status of the condition, one of True, False, Unknown.
type of condition in CamelCase or in foo.example.com/CamelCase. --- Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
The last successfully applied revision. The revision format for Git sources is <branch|tag>/<commit-sha>.
LastAttemptedRevision is the revision of the last reconciliation attempt.
LastHandledReconcileAt holds the value of the most recent reconcile request value, so a change can be detected.
ObservedGeneration is the last reconciled generation.
The last successfully applied revision metadata.
The manifests sha1 checksum.
A list of Kubernetes kinds grouped by namespace.
The list of Kubernetes kinds.
The namespace of this entry.
Source: install.yaml
Changes to Kustomization (kustomize.toolkit.fluxcd.io/v1beta1) in each Flux version, compared to the version before it.
4 properties have been added
2 properties are no longer required
4 properties have changed the description
Released · View Kustomization in v0.8.0
1 property has been added
2 properties are now required
4 properties have changed the description
Released · View Kustomization in v0.7.0
1 property is no longer required
2 properties have changed the description
Released · View Kustomization in v0.5.6
1 property has been added
Released · View Kustomization in v0.5.0
Kustomization was already present in this version of Flux, the oldest one on kubespec.dev
Released · View Kustomization in v0.4.3
No examples of Kustomization yet. Contribute one on GitHub.
kubespec.dev