KUBERNETES(1)(kubernetes)
π KUBERNETES(1)(kubernetes) β the kubectl rollout history glow-up π
okay so bestie, welcome to the Kubernetes manual pages, but make it cute. This one's all about kubectl rollout history and honestly? It's giving time-travel detective energy. π΅οΈβοΈβ¨
πΈ NAME πΈ
kubectl rollout history β peek at your rollout history, like scrolling back through the group chat to see what happened π
π SYNOPSIS π
kubectl rollout history [OPTIONS]
π¦ DESCRIPTION π¦
View previous rollout revisions and configurations. That's it, that's the vibe. You get to look back at all the past revisions and their configs like a little scrapbook of everything your deployment has been through. ππ
β¨ OPTIONS β¨
--allow-missing-template-keys=trueβ If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats. (yes bestie, it's forgiving like that π«Ά)-f,--filename=[]β Filename, directory, or URL to files identifying the resource to get from a server. Point it at stuff, it'll go fetch.-k,--kustomize=""β Process the kustomization directory. This flag can't be used together with-for-R. They're mutually exclusive, no throuples allowed π βοΈ-o,--output=""β Output format. One of: (json,yaml,kyaml,name,go-template,go-template-file,template,templatefile,jsonpath,jsonpath-as-json,jsonpath-file). Pick your aesthetic β¨-R,--recursive=falseβ Process the directory used in-f,--filenamerecursively. Useful when you want to manage related manifests organized within the same directory. It goes deeper. Iconic.--revision=0β See the details, including podTemplate of the revision specified. Zero means "nah, show me everything" β set it to a number to zoom in on one revision π-l,--selector=""β Selector (label query) to filter on, supports=,==,!=,in,notin. (e.g.-l key1=value1,key2=value2,key3 in (value3)). Matching objects must satisfy all of the specified label constraints. Every single constraint, no skipping, periodt.--show-managed-fields=falseβ If true, keep the managedFields when printing objects in JSON or YAML format.--template=""β Template string or path to template file to use when-o=go-template,-o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. iykyk π§
π OPTIONS INHERITED FROM PARENT COMMANDS π
These are the ones you got from your parent command, like genetics but for flags. π
--as=""β Username to impersonate for the operation. User 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. Bestie please.--kubeconfig=""β Path to the kubeconfig file to use for CLI requests.--kuberc=""β Path to the kuberc file to use for preferences. This can be disabled by exportingKUBECTL_KUBERC=falsefeature gate or turning off the featureKUBERC=off.--match-server-version=falseβ Require server version to match client version.-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"β The length of time 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 = infinite patience, main character energy π§βοΈ-s,--server=""β The address and port of the Kubernetes API server.--tls-server-name=""β Server name to use for server certificate validation. If it is 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. No warnings tolerated, strict queen behavior π
π EXAMPLE π
Okay here's how you actually use it, no cap:
# View the rollout history of a deployment
kubectl rollout history deployment/abc
# View the details of daemonset revision 3
kubectl rollout history daemonset/abc --revision=3
Look at that. Clean. Gorgeous. Ate. π₯
π«Ά 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! Shoutout Eric, a real one π
and that's the whole page bestie π this manual page is part of the KUBERNETES(1)(kubernetes) manuals, living in the User section, dated back to January 2015, originally compiled by Eric Paris and auto-generated ever since β¨ slay, go check your rollout history, mwah π
π¦ 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