2.8 KiB
Eschewed Features
Removal Directives
Kustomize supports configurations that can be reasoned about as compositions or mixins - concepts that are widely accepted as a best practice in various programming languages.
To this end, Kustomize offers various addition directives. One can add labels, annotations, patches, resources and bases. Corresponding removal directives are not offered.
Removal semantics would introduce many possibilities for inconsistency, and the need to add code to detect, report and reject it. It would also allow, and possibly encourage, unnecessarily complex configuration layouts.
When faced with a situation where removal is desirable, it's always possible to remove things from a base like labels and annotations, and/or split multi-resource manifests into individual resource files - then add things back as desired via the kustomization.
If the underlying base is outside of one's control, an OTS workflow is the recommended best practice. Fork the base, remove what you don't want and commit it to your private fork, then use kustomize on your fork. As often as desired, use git rebase to capture improvements from the upstream base.
Environment Variable Substitution
Kustomize wants to support the best practice of storing one's entire configuration in a version control system.
Consulting the environment at kustomize build time would
violate that goal.
Kustomize will instead provide kustomization file editting commands that can accept environment variable arguments, expand them at edit time, and store the result in the kustomization file.
If one wants to, say, set the tag used on an image to match an environment variable, the best practice would be to make the command
kustomize edit set imagetag nginx:$MY_NGINX_VERSION
part of some encapsulating work flow executed before kustomize build.
Globs in Kustomization Files
Kustomize wants to support the best practice of storing one's entire configuration in a version control system.
Globbing the local file system for files not explicitly
declared in the kustomization file at kustomize build time
would violate that goal.
Allowing globbing in a kustomization file would also introduce the same problems as allowing globbing in java import declarations or BUILD/Makefile dependency rules.
Kustomize will instead provide kustomization file editting commands that accept globbed arguments, expand them at edit time relative to the local file system, and store the resulting explicit names into the kustomization file.
In this way the resources, patches and bases used at build time remain explicitly declared in version control.