KUBERNETES(1)(kubernetes)
π NAME π
kubectl kustomize β bestie, this builds you a kustomization target out of a directory or a URL π
β¨ SYNOPSIS β¨
kubectl kustomize [OPTIONS]
π¦ DESCRIPTION π¦
Okay so picture this: you got a kustomization.yaml file and you want it to manifest actual KRM resources. That's literally the whole job here π
The DIR argument has to be a path to a directory that contains a kustomization.yaml, or it can be a git repository URL with a path suffix that points to the same thing relative to the repo root. Very "choose your own adventure", love that for you π
And if you justβ¦ forget DIR entirely? No stress, . is assumed. The current directory said "I'll do it" π
πΈ OPTIONS πΈ
--as-current-user=falseβ run the function in the container using the uid and gid of whoever's running the command, i.e. you π--enable-alpha-plugins=falseβ turn on kustomize plugins. Alpha ones. You know what you're doing, icon β¨--enable-helm=falseβ let the Helm chart inflator generator do its thing π--enable-managedby-label=falseβ enables addingapp.kubernetes.io/managed-by-e,--env=[]β a whole list of environment variables that functions get to use π§--helm-api-versions=[]β the Kubernetes api versions Helm uses forCapabilities.APIVersions--helm-command="helm"β the helm command, aka path to the executable π«Ά--helm-debug=falseβ turn on debug output from the Helm chart inflator generator. Spill the tea, helm β--helm-kube-version=""β the Kubernetes version Helm uses forCapabilities.KubeVersion--load-restrictor="LoadRestrictionsRootOnly"β if you set this toLoadRestrictionsNone, local kustomizations are allowed to load files from outside their root. Which is giving chaos honestly, because it breaks the relocatability of the kustomization π so like, be aware.--mount=[]β a list of storage options read from the filesystem π--network=falseβ enable network access for functions that declare it π--network-name="bridge"β the docker network to run the container in-o,--output=""β if you specify it, output gets written to this path. Simple as that π--reorder="legacy"β reorder the resources right before output. Use'legacy'to apply a legacy reordering (Namespaces first, Webhooks last, etc). Use'none'to suppress that final reordering. You choose the vibe π
π OPTIONS INHERITED FROM PARENT COMMANDS π
Yes bestie, there's more. These come from the parent command, no cap π
--as=""β username to impersonate for the operation. Could be a regular user or a service account in a namespace π--as-group=[]β group to impersonate for the operation; this flag can be repeated to specify multiple groups--as-uid=""β UID to impersonate for the operation--as-user-extra=[]β user extras to impersonate for the operation; this flag can be repeated to specify multiple values for the same key--cache-dir="/home/username/.kube/cache"β default cache directory π--certificate-authority=""β path to a cert file for the certificate authority--client-certificate=""β path to a client certificate file for TLS--client-key=""β path to a client key file for TLS π--cluster=""β the name of the kubeconfig cluster to use--context=""β the name of the kubeconfig context to use--disable-compression=falseβ if true, opt-out of response compression for all requests to the server--insecure-skip-tls-verify=falseβ if true, the server's certificate will not be checked for validity. > π¨ This will make your HTTPS connections insecure. Like, actually insecure. Not a vibe. Be careful fr fr.--kubeconfig=""β path to the kubeconfig file to use for CLI requests--kuberc=""β path to the kuberc file to use for preferences. You can disable this by exporting theKUBECTL_KUBERC=falsefeature gate, or by turning off the feature withKUBERC=offπ--match-server-version=falseβ require server version to match client version. Matching outfits, but for versions π-n,--namespace=""β if present, the namespace scope for this CLI request--password=""β password for basic authentication to the API server--profile="none"β name of profile to capture. One of (none|cpu|heap|goroutine|threadcreate|block|mutex|trace) π--profile-output="profile.pprof"β name of the file to write the profile to--proxy-url=""β proxy URL to use for requests to the API server--request-timeout="0"β how long to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g.1s,2m,3h). A value of zero means don't timeout requests. Zero = patient queen π-s,--server=""β the address and port of the Kubernetes API server--tls-server-name=""β server name to use for server certificate validation. If it's not provided, the hostname used to contact the server is used--token=""β bearer token for authentication to the API server ποΈ--user=""β the name of the kubeconfig user to use--username=""β username for basic authentication to the API server--version=falseβ--version,--version=rawprints version information and quits;--version=vX.Y.Z...sets the reported version π--warnings-as-errors=falseβ treat warnings received from the server as errors and exit with a non-zero exit code. Warnings? In THIS economy? Not on my watch π
π EXAMPLE π
# Build the current working directory
kubectl kustomize
# Build some shared configuration directory
kubectl kustomize /home/config/production
# Build from github
kubectl kustomize https://github.com/kubernetes-sigs/kustomize.git/examples/helloWorld?ref=v1.0.6
π SEE ALSO π
π HISTORY π
January 2015, originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material β but hopefully they have been automatically generated since! π iconic honestly
And that's the whole page bestie π«Ά This was the kubernetes manual, section 1, dated Jan 2015 and written by Eric Paris, and the manuals said "User" which is us, we're the user π
You ate. Periodt. β¨
π¦ where this page comes from
- arch rolling: kubectl 1.37.2-1 Β· Apache-2.0
- fedora 43: kubernetes1.37-client 1.37.0-3.fc43
- fedora 43: kubernetes1.37-client 1.37.1-1.fc43 Β· Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND BSD-3-Clause-HP AND CC-BY-4.0 AND ISC AND MIT AND MPL-2.0
- fedora 44: kubernetes1.37-client 1.37.0-3.fc44
- fedora 44: kubernetes1.37-client 1.37.1-1.fc44 Β· Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND BSD-3-Clause-HP AND CC-BY-4.0 AND ISC AND MIT AND MPL-2.0
- nixpkgs unstable: kubectl 1.37.2
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms