No entries match these filters. Clear filters
kustomize v5.8.2 adds kustomize edit add configuration and kustomize edit remove component commands.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.8.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.8.2
└──▷ TRY IT
Register a custom transformer configuration file with the current kustomization so it is picked up by kustomize build.
copy
$ kustomize edit add configuration my-transformer-config.yaml
Remove a component reference from a kustomization file when decommissioning a shared component from an overlay.
copy
$ kustomize edit remove component ../components/my-feature
Adds kustomize edit remove component command to remove a component reference from a kustomization file via the CLI.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Loads the built-in OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. schema from a pre-compiled bundle embedded in the binary, replacing runtime loading from the Kubernetes API definition. Not checked yet
Adds kustomize edit remove component command to remove a component reference from a kustomization file via the CLI.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
1 more in Everything
kustomize api/v0.21.2 adds label propagation to StatefulSet volumeClaimTemplates, structured-data delimiter handling, and ambiguous path rejection.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.21.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.21.2
└──▷ USE IT
Propagate kustomization labels into StatefulSet volumeClaimTemplates — useful when storage provisioners require labels to match pod selector labels.
kustomization.yaml
copy
# kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
labels:
- pairs:
app: myapp
includeSelectors: true
includeVolumeClaimTemplates: true
resources:
- statefulset.yaml
Adds includeVolumeClaimTemplates support to propagate labels into volumeClaimTemplates in StatefulSets.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Accounts for delimiters in structured data replacements, improving correctness of replacement operations on YAML/JSON values. Not checked yet
Adds includeVolumeClaimTemplates support to propagate labels into volumeClaimTemplates in StatefulSets.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
1 more in Everything
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.21.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.21.2
kustomize v5.8.0 adds structured-data replacements, regex replacement selectors, and a new PatchArgs API type.
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.8.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.8.0
└──▷ USE IT
Replace a value inside an embedded JSON blob in a ConfigMap using the replacements transformer's structured-data path traversal.
yaml
copy
# kustomization.yaml
replacements:
- source:
kind: ConfigMap
name: source-configmap
fieldPath: data.HOSTNAME
targets:
- select:
kind: ConfigMap
name: target-configmap
fieldPaths:
- data.config\.json.config.hostname
Supports editing embedded YAML/JSON values inside manifests via the replacements transformer using dot-path traversal into structured fields (e.g. data.config\.json.config.hostname). Not checked yet Adds regex support for Replacement selectors, enabling pattern-based source/target matching in replacements. Not checked yet Introduces PatchArgs API type to programmatically populate patch options. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! A regression in namespace propagation to child kustomizations was introduced in this release; the maintainers advise against upgrading until a patch release is available.
kustomize api v0.21.0 adds regex replacement selectors, structured-data replacement values, and a new PatchArgs API type.
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.21.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.21.0
Supports regex patterns in Replacement selectors for flexible field targeting. Not checked yet Implements replacement values in structured data for richer substitution workflows. Not checked yet Adds PatchArgs API type to programmatically populate patch options. Not checked yet
3 details in Everything
kustomize v5.7.0 adds static replacement values, Image Volume support, and Helm devel alias for chart references.
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.7.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.7.0
└──▷ USE IT
Use a static literal value as a replacement source instead of pulling it from an existing resource field.
yaml
copy
# kustomization.yaml
replacements:
- source:
value: "my-static-value"
targets:
- select:
kind: Deployment
fieldPaths:
- spec.template.spec.containers.[name=app].env.[name=MY_VAR].value
Adds static value source for replacements, allowing a literal string to be used directly as a replacement source without referencing a resource field. Not checked yet Adds images support for Image Volumes in the images transformer. Not checked yet Supports the devel alias in helmcharts configuration, enabling use of pre-release Helm chart versions. Not checked yet
3 details in Everything
kustomize api v0.20.0 adds static value sources for replacements, Image Volume support, and Helm devel alias for chart references.
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.20.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.20.0
└──▷ USE IT
Use a static literal value as a replacement source instead of pointing to a field in a resource.
yaml
copy
# kustomization.yaml
replacements:
- source:
value: "my-static-value"
targets:
- select:
kind: Deployment
fieldPaths:
- spec.template.spec.containers.[name=app].env.[name=MY_VAR].value
Adds static value source for the replacements transformer, enabling literal values as replacement sources without requiring a field reference. Not checked yet Supports Image Volumes in kustomize configurations (#5921). Not checked yet Allows use of the devel alias when referencing Helm charts, enabling pre-release chart versions in helmcharts configurations. Not checked yet
3 details in Everything
kustomize v5.5.0 adds --helm-debug flag for enhanced Helm chart debugging
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.5.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.5.0
└──▷ TRY IT
Troubleshoot a Helm chart inflated via kustomize by enabling verbose Helm debug output during the build.
copy
$ kustomize build --enable-helm --helm-debug <path>
└──▷ BREAKING ON UPGRADE
! Starlark support for KRM functions has been removed; any pipeline using Starlark-based KRM functions will break on upgrade.
kustomize api/v0.18.0 adds --helm-debug flag and drops Starlark support
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.18.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.18.0
└──▷ TRY IT
Surface verbose Helm renderer output when diagnosing chart rendering failures inside a kustomization.
copy
$ kustomize build --enable-helm --helm-debug <path>
Adds --helm-debug flag to pass Helm's debug mode through kustomize for enhanced Helm troubleshooting. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! Starlark support has been removed; any kustomization using Starlark transformers/generators will break on upgrade.
kyaml v0.18.0 adds Helm debug flag, inline list conversion control, and smarter Namespace sorting.
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.18.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.18.0
└──▷ TRY IT
Troubleshoot Helm chart rendering failures by enabling verbose Helm output during a kustomize build.
copy
$ kustomize build --enable-helm --helm-debug <path>
Adds --helm-debug flag to expose enhanced Helm debugging output during kustomize builds. Not checked yet Adds annotation to control inline list conversion behavior in Kustomize resources. Not checked yet Sorts built-in Namespace kind before CRDs CRDs A Kubernetes extension that adds a new object type to the cluster, so a tool's configuration is stored, validated and versioned by Kubernetes itself rather than in a file beside it. with the same name for more predictable apply ordering. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Starlark support for KRM functions has been removed; any pipeline relying on starlark-based krm functions will break on upgrade.
kustomize localize now validates builds by default, with --no-verify flag to skip
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.4.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.4.3
└──▷ TRY IT
Localize a kustomization that references not-yet-downloaded or incomplete manifests without triggering the new build validation.
copy
$ kustomize localize <path> --no-verify
Adds automatic kustomize build verification to kustomize localize Beta , catching missing or undownloadable manifests before localization completes. Not checked yet Adds --no-verify flag to kustomize localize to skip build validation when working with intentionally incomplete manifests. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! kustomize localize now runs kustomize build as part of execution; setups that rely on localizing incomplete or missing manifests will fail unless --no-verify is passed.
kustomize 5.4.2 adds localize for absolute paths and supports a labels key in transformer configs
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.4.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.4.2
Adds localize feature to transform absolute resource file paths into relative ones Not checked yet Adds support for the labels key inside transformer configuration blocks Not checked yet
2 details in Everything
kustomize adds labels transformer support and absolute path localization
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.17.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.17.2
Adds labels key support in transformer configuration to merge labels into resources Not checked yet Localizes absolute paths within transformer configurations Not checked yet
2 details in Everything
kustomize/v5.4.0 adds edit set secret command and Go 1.21 build requirement
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.4.1 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.4.1
--load-restrictor completion is now available for shell integration. Not checked yet The edit set secret command allows setting Kubernetes secrets directly from the CLI. Not checked yet kustomize now requires Go 1.21 or higher to build. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Null YAML values are no longer replaced by the string null .
Adds --load-restrictor completion and edit set secret command to kustomize v5.4.0
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.4.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.4.0
Adds completion support for the --load-restrictor flag on kustomize build/edit commands, allowing shell auto-completion of load restrictor values. Not checked yet Adds the edit set secret subcommand, enabling users to create or update secrets directly via CLI. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Fixes null YAML values being replaced by the string null (PR #5519)
kustomize 5.3.0 adds helm support for --kube-version/--api-versions, new edit set commands, and empty namespace handling
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.3.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.3.0
Adds --kube-version and --api-versions CLI arguments to the helm command to control Kubernetes version targeting Not checked yet Introduces kustomize edit set configmap subcommand for programmatic ConfigMap management Not checked yet Allows empty string for namespace flag on edit remove secret/configmap, treating it as default Not checked yet
3 details in Everything
Adds kube-version and api-versions CLI args for Helm builds
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.16.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.16.0
└──▷ USE IT
Generate a Helm chart compatible with Kubernetes 1.25 using specific API versions
shell
copy
kustomize build . --helm-command helm --kube-version=1.25.0 --api-versions=v1,apps/v1
kustomize v5.2.1 adds multi-patch support, OCI OCI Open Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. Helm repos, and new edit commands.
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.2.1 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.2.1
└──▷ TRY IT
Skip signature verification when adding a resource.
copy
$ kustomize edit add resource --no-verify https://example.com/resource.yaml
Add support for OCI based helm repos Not checked yet Add edit add labels command with option for labels without selector Not checked yet Add edit remove configmap subcommand Not checked yet Add --no-verify flag to edit add resource command Not checked yet Add edit remove secret subcommand Not checked yet
5 details in Everything
kustomize v5.2.0 adds multi-patch files, OCI OCI Open Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. Helm repo support and several kustomize edit subcommands
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.2.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.2.0
Adds kustomize edit add labels command with option to apply labels without a selector (#4486) Not checked yet Adds kustomize edit remove configmap command to delete ConfigMap references from kustomization.yaml (#5327) Not checked yet Adds --no-verify flag to kustomize edit add resource to skip existence checks (#5333) Not checked yet Adds kustomize edit remove secret command to delete Secret references from kustomization.yaml (#5344) Not checked yet Adds --namespace option to kustomize edit add configmap command (#5367) Not checked yet
5 details in Everything
kustomize adds OCI OCI Open Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. -based Helm repo support and fixes edit add configmap namespace flag
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.15.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.15.0
└──▷ TRY IT
Pull a Helm chart from an OCI registry (e.g., ghcr.io) instead of a traditional HTTP repo.
copy
$ kustomize build oci://ghcr.io/my-org/my-chart:latest
kyaml/v0.15.0 adds OCI OCI Open Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. -based Helm repository support for Kustomize builds
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.15.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.15.0
kustomize now supports pulling Helm charts from OCI registries Not checked yet Performance optimization limiting initSchema calls in openapi.IsNamespaceScoped Not checked yet
2 details in Everything
Components are now applied after generators in kustomize v5.1.0
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.1.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.1.0
Changes the application order of components to run after generators (previously components were applied before) Not checked yet Updates the Go toolchain requirement to Go 1.20 Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The application order for components is now after generators, which changes the final manifest output for kustomizations using components and resource generators
kustomize v5.0.0 adds kustomize localize alpha command, sortOptions, Helm chart fields, and --output flag for version output
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v5.0.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v5.0.0
└──▷ USE IT
Localize remote kustomization contents for offline builds
shell
copy
kustomize localize . ./local-copy
kustomize build ./local-copy
Enforce specific sorting on resources in the kustomization file
config
copy
# Add to your kustomization.yaml:
# sortOptions:
# order: inverted
# paths:
Output version information in JSON format for programmatic parsing
shell
copy
kustomize version --output json
Adds the new kustomize localize alpha subcommand to download remote content and create a localized build without network access Not checked yet Adds the sortOptions kustomization field for fine-grained control over resource ordering in build output Not checked yet Adds support for four new Helm fields: additionalValuesFiles, skipTests, apiVersions, and nameTemplate in helmCharts configurations Not checked yet Adds --output flag to kustomize version to enable YAML or JSON formatted output Not checked yet
4 details in Everything
Kustomize v0.13.0 adds sortOptions, localize command, SSH cert support, and Helm template args
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.13.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.13.0
└──▷ TRY IT
Run the new localize command to pull remote resources into a local directory for offline use or auditing.
copy
$ kustomize localize <remote-url> <local-directory>
Get the kustomize version in JSON format for programmatic consumption or logging.
copy
$ kustomize version --output json
Adds sortOptions field to Kustomization files to configure resource sort order Not checked yet Introduces kustomize localize subcommand for localizing remote resources Not checked yet Adds --output flag to kustomize version to output YAML or JSON Not checked yet Supports SSH URLs with certificates in RepoSpec Not checked yet Adds wildcard support for creation in ReplacementTransformer Not checked yet
+1 more
show less
Adds additionalValuesFiles, skipTests, and apiVersions fields to helmCharts Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! Dropped support for using gh: as a host in URLs! patches is no longer an alias for patchesStrategicMerge; use patchesStrategicMerge or new patches syntax explicitly! Removed long-ignored Inventory field from Kustomization type! ConfigMapGenerator and SecretGenerator no longer load values from local environment at build time! Duplicate fields in Kustomization files now result in an error instead of being silently ignored! Removal of DoLegacyResourceSort function
kyaml/v0.14.0 adds PathMatcher creation support and allows fieldspecs to start with a slash
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.14.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.14.0
Adds creation support to the PathMatcher filter via #4886 Not checked yet Allows fieldspecs in advanced transformer configuration to start with a slash via #4947 Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! copyutils.CopyDir() now requires a FileSystem argument! Removes Resid.LegacySortString() method
Adds --setRole and --overwrite flags to NamespaceTransformer for granular control.
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v4.5.6 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v4.5.6
kustomize edit add transformers now supports --setRole to customize the NamespaceTransformer role binding subject handling Not checked yet kustomize edit add transformers now supports --overwrite to customize the NamespaceTransformer overwrite behaviour Not checked yet
2 details in Everything
kyaml/v0.13.8 adds filesys.ConfirmDir and supports colons in in-memory FS paths
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.13.8 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.13.8
filesys.ConfirmDir function ensures a path is a directory and cleans it Not checked yet In-memory filesystem abstraction now allows colons in filenames Not checked yet
2 details in Everything
Adds tagsuffix transformer, remote OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. schema support, and labels for templated metadata.
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v4.5.5 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v4.5.5
includeTemplates: true now causes template metadata (labels) to be propagated to the resulting objects Not checked yet New tagsuffix transformer available in Kustomizations to append a suffix to container image tags Not checked yet Support for loading remote OpenAPI schemas for validation Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! External generators and transformers now raise an error instead of being silently ignored
kustomize api/v0.11.5 adds tagsuffix transformer support and remote OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. schema validation.
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.11.5 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.11.5
Adds the tagsuffix field to image transformers, allowing practitioners to append a suffix to image tags during patching. Not checked yet Introduces support for loading remote OpenAPI schemas in generators and transformers for schema validation. Not checked yet Raises an error when external generators or transformers are detected, preventing silent failures from unsupported plugin types. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! External generators or transformers now raise an error instead of being processed silently.
kyaml/v0.13.7 improves OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. parsing performance and fixes field/dot handling in kustomize functions
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.13.7 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.13.7
Openapi parsing performance improvement with protobuffer Not checked yet
1 detail in Everything
kustomize v4.5.3 adds anchor tag expansion, multiple replacements per file, and full array element targeting in replacements.
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v4.5.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v4.5.3
Support expanding anchor tags Not checked yet Allow setting every array element in replacements Not checked yet Support for multiple replacements in a single file Not checked yet
3 details in Everything
kustomize v0.11.3 adds multiple replacements per file and preserves scalar types in replacement filters.
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.11.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.11.3
Supports multiple replacements in a single file Not checked yet Preserves scalar types when using the replacement filter Not checked yet
2 details in Everything
kustomize v0.13.4 adds openAPI validation for functionConfig and anchor tag expansion
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.13.4 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.13.4
fn framework now validates functionConfig against an openAPI schema Not checked yet Supports expanding YAML anchor tags in kustomizations Not checked yet Allows setting every array element in replacements Not checked yet
3 details in Everything
Adds buildMetadata kustomization field and new kustomize edit subcommands for generator and metadata management
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v4.5.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v4.5.0
└──▷ USE IT
Use ZSH tab-completion to quickly autocomplete file paths during a build operation.
shell
copy
kustomize build <TAB>
kustomize build ... completes file paths on ZSH via built-in shell completion. Not checked yet PrefixSuffixTransformer is split into distinct PrefixTransformer and SuffixTransformer types usable individually in the transformers field. Not checked yet Adds new buildMetadata field to the kustomization resource schema. Not checked yet Adds new command 'kustomize edit add generator' for generator configuration. Not checked yet
4 details in Everything
New kustomize edit add buildmetadata command and buildMetadata kustomization field
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.11.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.11.0
└──▷ USE IT
Add build metadata to a kustomization file using the new CLI command.
shell
copy
kustomize edit add buildmetadata --env production
Use the new buildMetadata field in a kustomization file to embed build context.
yaml
copy
buildMetadata:
commit: abc123
timestamp: "2023-10-01T12:00:00Z"
Adds the kustomize edit add buildmetadata subcommand to inject build metadata into kustomizations Not checked yet Introduces the buildMetadata field in kustomization files to store build-time information Not checked yet Refactors PrefixSuffixTransformer into separate PrefixTransformer and SuffixTransformer, usable individually in transformers Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The enable-managedby-label flag is deprecated; users must migrate to the new field-based approach.
kyaml v0.13.1 adds fn Results.Sort() and preserves annotation formatting in Filter errors.
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.13.1 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.13.1
Results.Sort() method allows sorting function results by GVK and name Not checked yet
1 detail in Everything
kyaml/v0.13.0 adds label/annotation selection in replacement targets and updates ResourceList to v1
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.13.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.13.0
└──▷ USE IT
Filter which resources can be used as replacement targets based on their metadata labels.
yaml
copy
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- base.yaml
replacements:
- source:
kind: ConfigMap
name: settings
target:
labelSelector:
matchLabels:
app: frontend
Supports label and annotation selection in replacement targets within kustomize configurations Not checked yet Bumps ResourceList from v1alpha1 v1alpha1 A Kubernetes API version label meaning the resource schema is in its first alpha iteration, unstable and subject to breaking changes; tools use it to interact with early-stage custom or built-in Kubernetes APIs. to v1, updating the results field to implement function spec v1 Not checked yet
2 details in Everything
YAML anchors and aliases are now expanded by default in kustomize v4.4.0
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v4.4.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v4.4.0
└──▷ BREAKING ON UPGRADE
! YAML anchors and aliases are no longer preserved in the output; they are expanded, which may alter merge behavior for existing kustomization files that relied on anchor passthrough
kustomize v0.10.0 adds default YAML anchor expansion and krm spec annotations support
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.10.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.10.0
Adds AnchorsAweigh option to ByteReader to toggle YAML alias/anchor expansion, enabling anchor expansion during builds by default Not checked yet Supports krm spec v1 and legacy path, index, and id annotations Not checked yet Supports multiple gvks in custom openapi schema Not checked yet
3 details in Everything
kyaml/v0.12.0 adds AnchorAweigh toggle to ByteReader for YAML alias control
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.12.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.12.0
ByteReader gains the AnchorsAweigh option to toggle YAML alias/anchor expansion. Not checked yet Adds support for multiple gvks in custom OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. schema. Not checked yet
2 details in Everything
kustomize v4.3.0 adds edit set annotation, YAML OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. support, and env exec context fixes
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v4.3.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v4.3.0
Adds the edit set annotation subcommand to programmatically add or modify annotations on resources. Not checked yet Adds support for loading OpenAPI schemas in YAML format (previously only JSON was supported). Not checked yet Updates the embedded OpenAPI schema to v1.21.2, fixing patching behavior for batch/v1 CronJob resources. Not checked yet
3 details in Everything
kustomize v0.9.0 adds YAML anchor/alias expansion and exec function working directory scope
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.9.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.9.0
Adds YAML anchor/alias expansion to resolve references within kustomization files Not checked yet Exec functions now operate in the working directory of the kustomization that referenced them Not checked yet
2 details in Everything
kyaml/v0.11.1 adds YAML anchor expansion, sequence indent controls, and exec function working dir fix
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.11.1 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.11.1
Add yaml anchor/alias expansion support to kustomize resources Not checked yet
1 detail in Everything
Adds kustomize edit fix --vars command to auto-migrate vars to replacements
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v4.2.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v4.2.0
└──▷ TRY IT
Run the migration on the current kustomization file to replace legacy vars with replacements.
copy
$ kustomize edit fix --vars
Adds IAMPolicyGenerator, supports dots in replacement fieldpaths, and includes local configs
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.8.11 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.8.11
Adds IAMPolicyGenerator to define AWS IAM AWS IAM AWS Identity and Access Management is Amazon's service for controlling who and what can call AWS APIs, by attaching policies that allow or deny actions on resources. Cyber tools use it to scope credentials to least privilege. policies within kustomizations. Not checked yet Adds support for mapping values with . in replacements fieldPaths to handle nested paths like spec.container.image. Not checked yet Adds an option to include local configs when loading plugins, restoring previous sequence indentation behavior via an internal go-yaml fork. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! go-yaml no longer forces line wrapping on long strings in output.
Cmd/config now exposes --as-current-user flag and graduates KRM Functions Spec to v1
└──▷ GET THIS VERSION
copy
$ git clone --branch cmd/config/v0.9.13 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout cmd/config/v0.9.13
└──▷ HOW TO FIND IT
Configure kustomize to use the stabilized v1 KRM Functions Spec for function definitions.
📍 apiVersion: builtin
kind: DeployKrmFunctionRunner
metadata:
name: example
spec:
specVersion: v1
Adds --as-current-user flag via GetRunFnRunner to control identity for KRM function execution Not checked yet Graduates the KRM Functions Spec to version 1 (v1) in the fully specified schema Not checked yet
2 details in Everything
kyaml/v0.11.0 adds internal go-yaml fork with compact sequence indentation and GetValidatedDataMap API.
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.11.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.11.0
Adds GetValidatedDataMap method to the rnode struct for retrieving validated resource data maps. Not checked yet
1 detail in Everything
Adds experimental ReplacementTransformer and openapi fetch command; updates API surfaces
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v4.1.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v4.1.3
Introduces the experimental ReplacementTransformer to replace the vars feature, with documentation available at https://kubectl.docs.kubernetes.io/references/kustomize. Not checked yet Adds an openapi fetch command to pull openapi data from live API servers. Not checked yet Allows remote git URLs to specify a timeout parameter for pull operations. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Gvk and Resid types moved to kyaml in API changes towards 1.0! Resource now inlines RNode rather than delegating to it in API changes towards 1.0
kustomize v0.8.10 adds configurable git exec timeouts and submodule cloning via URL-based configuration.
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.8.10 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.8.10
Adds support for configuring git.exec.timeout and git.submodule.clone behavior through URL-based configuration settings. Not checked yet
1 detail in Everything
Kustomize v0.8.9 adds replacement transformer, supports immutable generator attribute, and removes go-openapi dependencies.
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.8.9 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.8.9
Supports immutable attribute on generators to prevent modification of generated resources Not checked yet Removes go-openapi/spec, go-openapi/validate, and go-openapi/strfmt dependencies from the API Not checked yet
2 details in Everything
kustomize v4.1.0 adds --enable-helm flag, new labels/merge key options, and custom OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. schema support
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v4.1.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v4.1.0
└──▷ TRY IT
Scan a local directory containing a Helm-integrated kustomization, enabling the helm subprocess.
copy
$ kustomize build --enable-helm .
Adds --enable-helm flag to allow the kustomize CLI to run a helm subprocess for resource generation. Not checked yet Adds helmGlobals and helmCharts fields to kustomization.yaml to define Helm chart configurations for inflation. Not checked yet Allows patches to modify a resource's kind or metadata/name fields via new patch options. Not checked yet Adds the labels field to kustomization.yaml with an includeSelectors option to add labels without injecting selector matchers. Not checked yet Supports specifying a custom OpenAPI schema file path via the new openapi field in kustomization.yaml. Not checked yet
5 details in Everything
kustomize v0.8.6 adds --enable-helm, Helm env inheritance, labels field, replacement filter, and custom namespace CRD CRD A Kubernetes extension that adds a new object type to the cluster, so a tool's configuration is stored, validated and versioned by Kubernetes itself rather than in a file beside it. webhook transformer.
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.8.6 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.8.6
Adds --enable-helm flag to enable the Helm plugin Not checked yet Adds labels field to .kustomization to attach labels to all generated resources Not checked yet Introduces a replacements filter that supports use and rejects fields for conditional patching Not checked yet Adds CustomResourceDefinition webhook namespace transformer in api/konfig/builtinpluginconsts/namespace Not checked yet
4 details in Everything
cmd/config v0.9.9 adds optional dir to tree command and suppresses file output.
└──▷ GET THIS VERSION
copy
$ git clone --branch cmd/config/v0.9.9 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout cmd/config/v0.9.9
└──▷ USE IT
Run tree analysis on a specific directory without changing into it.
shell
copy
kustomize tree --dir /path/to/kustomization
Adds --dir as an optional flag to the kustomize tree command Not checked yet Suppresses printing of the Kustomization file content in tree command output Not checked yet
2 details in Everything
Adds experimental openapi fetch command to retrieve schemas from a local cluster.
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v4.0.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v4.0.2
└──▷ TRY IT
Retrieve the OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. schema definitions currently available in your connected local cluster.
copy
$ kustomize openapi fetch
List setters now default to false for recurse-subpackages
└──▷ GET THIS VERSION
copy
$ git clone --branch cmd/config/v0.9.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout cmd/config/v0.9.3
kyaml/v0.10.11 adds openapi/path config key and refactors internal serialization
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.10.11 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.10.11
Adds openapi/path field to allow specifying a custom OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. schema document for parsing Not checked yet
1 detail in Everything
kustomize v0.8.1 adds binaryData merge support and drops obsolete flags.
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.8.1 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.8.1
Adds support for merging binaryData in kustomizations. Not checked yet Removes the --enable_kyaml flag (no longer needed). Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The --enable_kyaml flag is removed; passing it now results in an error.
kustomize/v3.9.3 enables kyaml by default and adds digest-preserving transforms
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v3.9.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v3.9.3
└──▷ TRY IT
Override the default kyaml behavior if necessary for compatibility with older plugins.
copy
$ kustomize build --enable_kyaml=false .
--enable_kyaml is now true by default in the binary. Not checked yet Adds support for preserving image digest during images patch updates with keepDigest: true. Not checked yet Adds support for updating tags while preserving names with newTagOnly: true. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The default value for the --enable_kyaml flag has changed from false to true. Use kustomize build --enable_kyaml=false . to retain the old behavior.
kyaml active by default for path splitting and field specs
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.7.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.7.3
└──▷ USE IT
Access the smart path splitter programmatically for custom kustomize plugins.
go
copy
import "github.com/kubernetes-sigs/kustomize/api/kyaml/splitpath"
Added support for anchors in fieldspec (-f). Not checked yet Exposed the smart path splitter as a public utility. Not checked yet
2 details in Everything
kustomize/v3.8.10 adds digest preservation and name/tag manipulation
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v3.8.10 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v3.8.10
└──▷ USE IT
Patch an image in kustomization.yaml to update only the tag while preserving the existing sha256 digest, preventing accidental drift.
shell
copy
kustomize edit set image nginx=nginx:1.19 --preserve-image-digest
Adds --preserve-image-digest flag to enable preserving image digests during patching. Not checked yet Enables setting new tag while keeping the current image name via newTag with digest support. Not checked yet
2 details in Everything
Allows transformers to delete and generate resources
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.6.9 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.6.9
Exec and function transformers can now delete existing resources from the resource list. Not checked yet Exec and function transformers can now generate new resources into the resource list. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Default value for FlagEnableKyamlDefaultValue is now false.
kyaml/v0.10.7 adds validation hook to template command and refines openapi field handling.
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.10.7 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.10.7
Adds validation hook configuration option to the template command for pre-render validation. Not checked yet Updates kyaml libraries to prioritize the openapi field defined in kustomization.yaml over external sources. Not checked yet Improves framework usability by reducing dependency on cobra for non-CLI applications. Not checked yet
3 details in Everything
kyaml/v0.10.6 adds RNode.Map method and improves YAML merge/annotation handling
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.10.6 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.10.6
└──▷ USE IT
Decode nested YAML structures programmatically using the new Map method on RNode.
go
copy
// Example usage in Go:
// var node *yaml.RNode
// m, err := node.Map()
if err != nil { ... }
Add RNode.Map method and test to help decoding. Not checked yet In kyaml, loosen interpretation of string node and add tests. Not checked yet
2 details in Everything
kustomize kyaml v0.7.1 adds Role/ClusterRole resourceNames to ConfigMap nameref resolver and topologySpreadConstraints support
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.7.1 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.7.1
Adds topologySpreadConstraints to the builtin label field Not checked yet
1 detail in Everything
kyaml v0.10.4 adds RNode.Set/GetDataMap and ordered multi-function execution
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.10.4 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.10.4
└──▷ USE IT
Programmatically create a ConfigMap entry using the new map helper.
go
copy
rNode.GetDataMap()['key'] = 'value'
rNode.Set()
Rely on deterministic ordering when composing multiple transformation functions.
📍 # In your kustomize plugin manifest, order functions sequentially in the functions list.
# They now execute in this exact order rather than concurrently.
Adds RNode.Set() and RNode.GetDataMap() methods to simplify ConfigMap generation Not checked yet Enables multiple declarative functions in the same file to execute in order Not checked yet
2 details in Everything
Adds kustomize list builtins and kustomize edit set label commands.
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v3.8.8 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v3.8.8
└──▷ USE IT
Discover which builtin transformers and patchers are available for use in a kustomization.
shell
copy
kustomize list builtins
Programmatically add labels to the active Kustomization file without manual editing.
shell
copy
kustomize edit set label env=prod tier=backend
kustomize list builtins lists available builtin plugins Not checked yet kustomize edit set label <labels> adds labels to the current kustomization Not checked yet
2 details in Everything
Adds list builtin command, WNode API for ConfigMap/Secret generation, and extraArgs to helm generator.
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.6.6 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.6.6
WNodeFactory now includes MakeConfigMap and MakeSecret methods for generating RNodes from config data Not checked yet Helm generator accepts a new extraArgs field to pass additional flags to the helm CLI Not checked yet
2 details in Everything
kyaml v0.10.3 adds RNode selectors, ConfigMap/Secret creation, and fn/framework stdin support
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.10.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.10.3
Add RNode implementation of label and annotation selectors for Kubernetes metadata matching. Not checked yet Add metadata getters and setters to RNode for direct access to object metadata. Not checked yet Add WNodeFactory.MakeConfigMap and MakeSecret methods for constructing k8s resources programmatically. Not checked yet Add kyaml filters for k8s metadata operations. Not checked yet Enable fn/framework support for reading from stdin in standalone mode. Not checked yet
+1 more
show less
Improve fn/framework support for patching containers. Not checked yet
6 details in Everything
kyaml/v0.9.4 adds WNode methods for setting annotations, labels, GVK, name, namespace; converts helm-inflator to builtin plugin.
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.9.4 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.9.4
Adds GetFieldValue, GetSlice, GetString, Map , SetAnnotations, SetGvk, SetLabels, SetName, and SetNamespace methods to the WNode interface in kyaml Not checked yet Converts helm-inflator to a builtin plugin within the tool Not checked yet
2 details in Everything
Adds edit add/remove transformer commands, isSet column for list-setters, and array index support in PathGetter
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.9.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.9.3
└──▷ USE IT
Add a specific transformer to your kustomization file without manually editing it.
shell
copy
kustomize edit add transformer image-tag:v1.2.3
Adds kustomize edit add transformer and kustomize edit remove transformer subcommands to declaratively manage transformers. Not checked yet Adds isSet field/column support to the list-setters command output for tracking variable assignment status. Not checked yet Enables array index notation (e.g., spec[0].name) in PathGetter paths for precise element targeting. Not checked yet
3 details in Everything
kyaml v0.9.2 adds --as-current-user flag to fn run for containerized plugin execution
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.9.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.9.2
└──▷ USE IT
Run a kustomize plugin inside a container while mounting your current user's files, avoiding permission errors.
shell
copy
kustomize fn run <plugin> --as-current-user
kyaml/v0.9.1 adds metadata field support to kustomization files and Windows exec plugin execution
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.9.1 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.9.1
Adds the metadata field to the kustomization file schema (config format) Not checked yet Supports exec credential plugins on Windows via a new executable check path (shell/operational surface) Not checked yet
2 details in Everything
kyaml/v0.9.0 adds merge strategies for lists, deployment annotation template vars, and fn --as-current-user flag
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.9.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.9.0
└──▷ HOW TO FIND IT
Run a function as the current user for identity-sensitive operations.
📍 kustomize fn run <function> --as-current-user
Adds support for merge strategy configuration in list transformers via the new strategy key. Not checked yet Adds $patch: delete handling in patch transformer to explicitly remove elements or resources. Not checked yet Adds --as-current-user flag to fn run commands to execute functions as the invoking user. Not checked yet Supports variable references (var refs) inside deployment template annotations for dynamic configuration. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The default branch in the cloner is no longer hardcoded to master.
Adds DisableNameSuffixHash field to Secret and ConfigMap transformers
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.6.1 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.6.1
kyaml v0.8.0 adds --env/-e flag, --log-steps flag, subpackage support for cfg commands, and openapi-based namespaceability
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.8.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.8.0
└──▷ USE IT
Expand environment variables like DB_HOST directly within your kustomization files during build.
shell
copy
kustomize build --env .
Trace how the config commands process subpackages to debug unexpected resource selection or transformation order.
shell
copy
kustomize cfg grep -l app=kube-system --log-steps .
Adds --env / -e flag to enable environment variable expansion in kustomize configurations. Not checked yet Adds --log-steps flag to the config CLI to output detailed execution steps during processing. Not checked yet Extends kustomize cfg cat, fmt, grep, count, annotate, and set commands to traverse and operate on subpackages within a kustomization tree. Not checked yet Enables automatic determination of resource namespaceability by referencing the OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. schema instead of relying solely on manifest annotations. Not checked yet
4 details in Everything
Adds .krmignore file support to exclude specific files and directories
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.6.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.6.0
Add .krmignore file support to control which resources are included in kustomization builds Not checked yet
1 detail in Everything
kustomize kyaml/v0.7.0 adds fn run flags and subpackage listing
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.7.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.7.0
Adds --fn-env flag to the fn run command to specify environment variables for functions. Not checked yet Adds support for listing setters in subpackages when using kustomize build. Not checked yet
2 details in Everything
kyaml v0.6.1 adds callback hooks to KIO pipelines and continue_on_empty input handling
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.6.1 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.6.1
Adds a callback mechanism to the KIO pipeline execution lifecycle via AddCallback on the pipeline object. Not checked yet Adds the ContinueOnEmpty boolean option to the Reader configuration, allowing pipelines to process empty inputs instead of failing or skipping. Not checked yet
2 details in Everything
kyaml/v0.5.0 adds remote resource support and new kustomize edit subcommands
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.5.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.5.0
kustomize edit add component command added to manage component dependencies directly via CLI Not checked yet
1 detail in Everything
kyaml/v0.4.2 adds RoleBinding namespace checks and hash suffixing support
└──▷ GET THIS VERSION
copy
$ git clone --branch kyaml/v0.4.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kyaml/v0.4.2
Adds AllowHashSuffix logic to permit hash suffixing of arbitrary types Not checked yet Adds SupportsRoleBinding function to check role binding namespaces Not checked yet
2 details in Everything
Kustomize v3.7.0 adds alpha support for sharing functions with kpt
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v3.7.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v3.7.0
kustomize now supports an initial Alpha framework allowing it to share functions with kpt. Not checked yet
1 detail in Everything
Adds valueAdd builtin transformer and new release CLI subcommands
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.4.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.4.0
Adds valueAdd as a built-in transformer for applying RFC 6902 RFC 6902 A JSON standard from the IETF that defines a format for describing changes to a JSON document as a sequence of operations such as add, remove, and replace, letting tools patch structured data without transmitting full replacements. -style value additions to Kustomize resources Not checked yet
1 detail in Everything
New ValueAddTransformer and filesys.InsertPathPart API for kustomize plugins
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.3.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.3.3
Adds ValueAddTransformer as a new transformer component for value manipulation tasks. Not checked yet Adds filesys.InsertPathPart function to the internal filesystem API for path construction. Not checked yet
2 details in Everything
Adds functions to add or retrieve inventory from grouping objects in kustomize
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.3.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.3.2
kustomize v3.5.2 exposes alpha commands via KUSTOMIZE_ENABLE_ALPHA_COMMANDS
└──▷ GET THIS VERSION
copy
$ git clone --branch kustomize/v3.5.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout kustomize/v3.5.2
└──▷ USE IT
List available alpha commands without modifying shell profile or aliases
shell
copy
KUSTOMIZE_ENABLE_ALPHA_COMMANDS=true ./kustomize help
alpha config subcommand with apply/diff support, run function capabilities, and status command
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.3.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.3.0
kustomize config run <func> enables running built-in functions (such as image, replicas, or namespace transformers) on Kustomization documents via the CLI for programmatic configuration generation. Not checked yet kustomize config apply provides an alpha CLI interface to generate Kubernetes manifests directly from kustomizations, replacing the need to pipe through kubectl apply --dry-run=client in some workflows. Not checked yet kustomize config diff offers an alpha CLI command to compare generated Kubernetes manifests against a live cluster or another manifest without applying anything. Not checked yet kustomize status <resource> is a new command that computes and displays the runtime status (e.g., Available, Progressing, Ready) of Kubernetes resources based on fetched cluster info. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The run-fns feature has been renamed to run; any scripts or automation relying on the old subcommand name will fail.
Adds support for inflating Helm charts with .Release.Name/Namespace variables; adds kyaml CLI filters
└──▷ GET THIS VERSION
copy
$ git clone --branch pseudo/k8s/v0.1.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout pseudo/k8s/v0.1.0
Adds --helm-server-side-inflation support to inflate Helm charts including .Release.Name and .Release.Namespace references in templates Not checked yet Adds new kyaml filters as CLI commands for YAML and resource manipulation Not checked yet
2 details in Everything
First release of the Kustomize Go API module (sigs.k8s.io/kustomize/api) for programmatic usage.
└──▷ GET THIS VERSION
copy
$ git clone --branch api/v0.1.1 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout api/v0.1.1
Introduces the sigs.k8s.io/kustomize/api Go module as a new package for building cyber tooling that interacts with Kustomize programmatically. Not checked yet Exposes public packages including types, resources, resmap, filesys, and pluglib to allow external cyber tools to leverage internal kustomize logic. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The API is explicitly marked as unstable (Expect the api to change ) prior to v1.0.0, so consumers relying on v0.x should not treat this as stable semantic versioning yet.
Adds kustomize create subcommand, inline patch support, and prioritized PriorityClass transformer
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.2.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v3.2.0
└──▷ USE IT
Check the installed version using the short flag.
shell
copy
kustomize version -s
Adds kustomize create subcommand for bootstrapping kustomization structures Not checked yet Supports inline patches in patchesStrategicMerge or patchesJson6902 via the new inline key (e.g., inline: |\n key: value) Not checked yet Adds -s short version flag for kustomize version Not checked yet
3 details in Everything
kustomize v2.0.2 adds varref support in map values and lists, plus Pod initContainer references.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.0.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v2.0.2
varreference now supports mapping values (maps) via 8c93f7ba add support for varref in maps values Not checked yet Adds Pod initContainer to var reference support per 901455eb Add Pod initContainer to var reference Not checked yet
2 details in Everything
v2.0.0 adds edit fix subcommand, image transformer, and common labels support for jobs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.0.0 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v2.0.0
Adds the edit fix subcommand to correct kustomization files automatically. Not checked yet Adds an image transformer that can replace container images in manifests. Not checked yet Adds spec/jobTemplate/metadata/labels support to the common labels transformer. Not checked yet
3 details in Everything
New kustomize v1.0.11 adds edit command options and nameSuffix transformer capabilities.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.0.11 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v1.0.11
Adds edit command option for editing name suffix in the CLI Not checked yet Enables the nameSuffix field in kustomization.yaml to append a suffix to resource names Not checked yet Adds a new transformer for appending suffixes to resources automatically Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The -t flag is removed from the build command! The disableHash configuration key is renamed to disableNameSuffixHash in kustomization.yaml! The gitloader package/module is renamed to gitcloner, affecting internal or advanced script usage
kustomize build now auto-loads transformer configs; k8sdeps.NewFactory() exported for plugins
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.0.10 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v1.0.10
kustomize build loads transformer configurations automatically when no path argument is provided. Not checked yet k8sdeps.NewFactory() function is now importable in Go packages. Not checked yet
2 details in Everything
kustomize v1.0.9 adds transformer config file loading and generatorOptions settings
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.0.9 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v1.0.9
Adds generatorOptions field to the Kustomization type, supporting shell, timeout, and disableHash fields. Not checked yet Adds ability to preserve resource ordering via generatorOptions.preserveOrder in the Kustomization spec. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The patchesJson6902 target field is now mandatory; if the target cannot be found, kustomize will error out instead of silently ignoring the patch.
kustomize v1.0.8 adds patchesJson6902 transformer support and image digest recognition via kustomize edit set imagetag
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.0.8 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v1.0.8
└──▷ TRY IT
Update an image tag to include a digest in your kustomization configuration.
copy
$ kustomize edit set imagetag nginx:1.8.0 my-app:latest alpine@sha256:24a0c4b4a4c0eb97a1aabb8e29f18e917d05abfe1b7a7c07857230879ce7d3d3
Adds patchesJson6902 transformer to enable JSON patch customization of Kubernetes objects. Not checked yet Adds kustomize edit set imagetag subcommand to recognize image digests and update imageTags in kustomization.yaml. Not checked yet
2 details in Everything
Adds remote URL support for kustomize build and overlay bases
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.0.7 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v1.0.7
└──▷ TRY IT
Build a Kustomization directly from a public GitHub repository path.
copy
$ kustomize build https://github.com/kubernetes-sigs/kustomize/tree/master/examples/configureBasis
Adds kustomize build {url} subcommand to fetch and build from a remote repository Not checked yet Allows using a remote URL as a base in an overlay's kustomization file Not checked yet
2 details in Everything
v1.0.6 adds -o flag for output control, glob support in add subcommands, and regexp-based imagetag transformer
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.0.6 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v1.0.6
└──▷ USE IT
Use glob patterns to add multiple resources matching a pattern without listing them individually.
shell
copy
kustomize edit add resource 'pkg/**/*.yaml'
Control the output format or destination of kustomize build results using the new -o flag.
shell
copy
kustomize build -o ./output.yaml .
Update image tags using regex patterns for more flexible version matching in transformers.
shell
copy
kustomize edit set imagetag myapp '.*-beta$'
Adds -o flag to kustomize build to control output behavior. Not checked yet Adds glob pattern support in edit add resource subcommand. Not checked yet Adds glob pattern support in add patch and add configmap subcommands. Not checked yet Changes set imagetag transformer to use regexp matching instead of exact string match. Not checked yet Adds namespace to ResId internal structure for better resource identification. Not checked yet
5 details in Everything
Adds imageTags field to kustomization type, imageTagTransformer, and a new set imagetag CLI command
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.0.5 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v1.0.5
Adds imageTags field to the kustomization type to specify image tag transformations. Not checked yet Introduces imageTagTransformer component for transforming container images. Not checked yet Adds the initContainers field to the imageTagTransformer to support init container transformation. Not checked yet Adds a new set imagetag subcommand to the CLI for setting image tags directly. Not checked yet
4 details in Everything
Kustomize v1.0.4 adds transformers for NetworkPolicy NetworkPolicy A Kubernetes API object that defines which pods may send or receive traffic, enforced by the cluster's CNI plugin to give cyber tools namespace-level network segmentation without host firewall rules. labels, PVC name refs, and namespace handling in ClusterRoleBinding subjects
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.0.4 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v1.0.4
Adds NetworkPolicy to label transformer Not checked yet Adds support for PersistentVolumeClaim in name reference transformer Not checked yet Adds namespace transformation for subjects.namespace in ClusterRoleBinding Not checked yet
3 details in Everything
v1.0.3 adds kustomize edit add base command, glob support, and variable references for CronJob/args/env
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.0.3 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v1.0.3
Adds kustomize edit add base subcommand to add multiple base directories Not checked yet Adds glob pattern support in kustomization files Not checked yet Adds CRD CRD A Kubernetes extension that adds a new object type to the cluster, so a tool's configuration is stored, validated and versioned by Kubernetes itself rather than in a file beside it. support to the builder Not checked yet Adds variable reference support for CronJob specs Not checked yet Adds variable reference support for container args Not checked yet
+1 more
show less
Adds variable reference support for container env variables Not checked yet
6 details in Everything
Adds variable reference support for resource fields and new transformers for Ingress TLS, HPA, and initContainers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.0.2 https://github.com/kubernetes-sigs/kustomize.git
$ git checkout v1.0.2
Adds variable reference support in kustomizations to inject field values across resources Not checked yet Adds namerefs for PodDisruptionBudget labels Not checked yet Adds namerefs for HorizontalPodAutoscaler (HPA) Not checked yet Adds namerefs for Ingress spec.tls.secretName and default backend service name Not checked yet Adds namerefs for initContainers Not checked yet
+1 more
show less
Introduces ResId and ResMap types for resource identification and mapping Not checked yet
6 details in Everything